الرئيسية / البحث

العنوان من الإحداثيات

GET /geocoder/reverse

أقرب الأماكن والعنوان لنقطة: لعرض عنوان الدبوس الذي وضعه المستخدم.

الصلاحية المطلوبة على المفتاح: reverse

جرّب الآن

GET /geocoder/reverse
الطلب كـ curl

اضغط على الخريطة لمعرفة عنوان النقطة.

الرد كاملاً

المعاملات

الاسمالمكانالنوعالوصف
lat * الاستعلام رقم خط العرض.
lon * الاستعلام رقم خط الطول.
lang الاستعلام ar | en لغة النتائج.
limit الاستعلام 1–10 عدد النتائج، الأقرب أولاً.
radius الاستعلام كم نصف قطر البحث بالكيلومتر.

الرد

features[]
نفس شكل نتائج البحث، الأقرب أولاً. فارغة إذا لم يكن شيء قريباً (في الصحراء مثلاً).

ملاحظات

  • اطلبه عند نهاية تحريك الخريطة أو وضع الدبوس، لا مع كل حركة.
  • تُقرَّب الإحداثيات إلى 4 منازل (≈ 11 م)، فالنقاط القريبة تتشارك رداً واحداً من الـ cache.

مثال

curl -H "X-Api-Key: $KEY" \
  "https://<الخادم>/geocoder/reverse?lat=33.3152&lon=44.3661&lang=ar&limit=3"