Navvo
مرجع الواجهة البرمجية

أماكن مشابهة

صفّ «المزيد من هذا النوع» لصفحة مكان — أماكن تشبه مكانًا معيّنًا في المعنى، مع بديل احتياطي من أماكن قريبة في التصنيف نفسه.

أماكن مشابهة

أعطِ مكانًا واحدًا لتحصل على أماكن تشبهه، لصفّ «المزيد من هذا النوع» أو «قد يعجبك أيضًا» في صفحة مكان. تقارن Navvo الأماكن بالمعنى: الأسماء والتصنيفات وطبيعة المكان. فمحمصة القهوة المختصّة تميل إلى إظهار محامص أخرى ومقاهٍ مختصّة، لا أي نشاط تجاري يحتوي اسمه على كلمة «قهوة». وعندما تتعذّر مقارنة مكان بهذه الطريقة، تلجأ Navvo إلى أماكن قريبة في التصنيف نفسه، وتخبرك الاستجابة بالطريقة التي أجابت.

النطاق المطلوب: search


GET /search/similar

curl -s "https://navvo.io/api/v1/search/similar?slug=astrolabe-coffee-astrlab-abdali-mall-289197&limit=6" \
  -H "x-api-key: nvvo_YOUR_KEY"

معاملات الاستعلام

id
string
معرّف المكان المرجعي. أرسل id أو slug.
slug
string
معرّف رابط المكان المرجعي. أرسل id أو slug.
locale
string
en (الافتراضية) أو ar: لغة categoryName وaddress في كل عنصر.
limit
number
أقصى عدد من الأماكن. القيمة الافتراضية 10، مُقيَّدة إلى 1–50.
lat
number
خط عرض اختياري لنقطة أصل. مع lon تحمل العناصر distanceKm.
lon
number
خط طول اختياري لنقطة الأصل. أرسله مع lat.
radiusKm
number
فقط الأماكن الواقعة ضمن هذا العدد من الكيلومترات حول lat/lon، من 0.1 إلى 500. يتطلّب نقطة أصل. وبدونه تقتصر النتائج على الأماكن في الأردن.

الاستجابة

{
  "source": "vectors",
  "items": [
    {
      "id": "243270bc-4aa9-4253-a7e8-04fad61d8c38",
      "slug": "nebo-specialty-coffee-roasters-and-coffee-house-5eb58a",
      "nameEn": "Nebo Specialty coffee roasters and coffee house",
      "nameAr": null,
      "categories": ["coffee-roastery"],
      "canonicalCategorySlug": "coffee-roastery",
      "rawCategories": ["Coffee roastery"],
      "rating": 5,
      "sponsored": false,
      "center": "POINT(35.913329 31.95199)",
      "lat": 31.95199,
      "lng": 35.913329,
      "iconLightUrl": "https://navvo.io/uploads/category-icons/coffee-roastery-light.svg",
      "iconDarkUrl": "https://navvo.io/uploads/category-icons/coffee-roastery-dark.svg",
      "imageUrl": null
    }
  ]
}
الحقلالنوعالوصف
sourcestringvectors: قورنت الأماكن بالمعنى. وnearby: أجاب البديل الاحتياطي بأماكن في التصنيف نفسه قرب المكان المرجعي.
items[]arrayالأماكن المشابهة، الأفضل أولًا. تستخدم بنية العناصر نفسها في GET /search ← places.items[]. لا يُضمَّن المكان المرجعي نفسه ولا الأماكن المخفية أبدًا. وقد تكون القائمة فارغة.
nearby ليست خطأً. فبعض الأماكن لا يمكن مقارنتها بالمعنى بعد (مثل مكان أُضيف قبل دقائق)، وقد تكون المقارنة بالمعنى معطَّلة في تثبيت ما. وفي الحالتين تعود قائمة مفيدة. اعرض القائمة في كلتا الحالتين، ولا تستخدم source إلا إذا أردت صياغة مختلفة («المزيد من هذا النوع» مقابل «قريب في هذا التصنيف»).

الأخطاء

الحالةمتى
400لم يُرسَل id ولا slug؛ أو أُرسل radiusKm دون lat/lon؛ أو معامل خارج المدى.
404لا يوجد مكان ظاهر بهذا الـ id أو الـ slug.
401 / 403المفتاح مفقود أو غير صالح، أو يفتقر إلى النطاق search، أو تجاوز حصته.

يُحتسب كل استدعاء طلبين موزونين (راجع البحث ← القياس وحدود المعدّل).

Copyright © 2026