تخطي إلى المحتوى
POST AI agent ready /v1/geo/reverse

عكس واجهة برمجة التطبيقات للترميز الجغرافي - تحويل خطوط الطول/العرض إلى عنوان

أرسل زوجًا من خطوط الطول والعرض واحصل على عنوان الشارع والمدينة والبلد واسم العرض المطابق. مدعوم من خدمة OpenStreetMap Nominatim. مفيد لتحويل إحداثيات GPS من الأجهزة أو بيانات EXIF ​​للصور أو نقرات الخريطة إلى مواقع يمكن قراءتها.

Parameters

numberrequired

Latitude in decimal degrees (-90 to 90).

numberrequired

Longitude in decimal degrees (-180 to 180).

Code examples

curl -X POST https://api.botoi.com/v1/geo/reverse \
  -H "Content-Type: application/json" \
  -d '{"lat":37.4224,"lng":-122.0842}'

When to use this API

عرض عنوان قابل للقراءة عندما يقوم المستخدمون بإسقاط دبوس على الخريطة

عندما ينقر مستخدم على موقع على خريطتك، أرسل الإحداثيات إلى نقطة النهاية هذه واعرض عنوان الشارع في تلميح الأدوات أو الشريط الجانبي. يوفر على المستخدمين الاضطرار إلى كتابة العنوان يدويًا.

ضع علامة على الصور بأسماء المواقع من بيانات EXIF ​​GPS

قم باستخراج خطوط العرض/الطول من البيانات التعريفية للصورة EXIF ​​وقم بترميزها جغرافيًا بشكل عكسي. اعرض "تم التقاطها في ماونتن فيو، كاليفورنيا" بدلاً من الإحداثيات الأولية في معرض الصور الخاص بك.

إثراء بيانات تتبع الأسطول بعناوين الشوارع

قم بتحويل إحداثيات نظام تحديد المواقع العالمي (GPS) من أجهزة تعقب المركبات إلى عناوين الشوارع لسجلات الإرسال وتأكيدات التسليم وتقارير المسار.

Frequently asked questions

ما هي البيانات التي يتضمنها الرد؟
تتضمن الاستجابة اسم العرض الكامل (عنوان الشارع)، وحقل عنوان أقصر، والمدينة، والبلد، وخطوط الطول/العرض الأصلية. يعتمد مستوى التفاصيل على تغطية OpenStreetMap للموقع.
ماذا يحدث إذا كانت الإحداثيات في المحيط أو في منطقة غير محددة؟
ترجع واجهة برمجة التطبيقات خطأ 404 NOT_FOUND إذا لم يتمكن Nominatim من العثور على عنوان للإحداثيات المحددة. قد لا تحتوي المحيطات المفتوحة والبرية النائية والقارة القطبية الجنوبية على بيانات عنوان.
ما مدى دقة النتائج؟
تعتمد الدقة على كثافة بيانات OpenStreetMap للمنطقة. في المدن، عادةً ما تحصل على دقة على مستوى البناء. في المناطق الريفية، قد يتم حل النتائج إلى أقرب طريق أو قرية.
هل يمكنني عكس إحداثيات متعددة جغرافيًا في طلب واحد؟
لا، كل طلب يتعامل مع زوج إحداثيات واحد. لمعالجة الدفعات، قم بتقديم طلبات متوازية. احترم حد معدل Nominatim وهو طلب واحد في الثانية للوصول المجهول.
هل نقطة النهاية هذه مجانية؟
نعم. الوصول المجهول يسمح بـ 5 طلبات في الدقيقة. يعمل مفتاح واجهة برمجة التطبيقات (API) على رفع حد السعر بناءً على مستوى خطتك. لا توجد رسوم لكل طلب.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.