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

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

أرسل سلسلة عنوان (عنوان الشارع أو اسم المدينة أو المعلم أو الرمز البريدي) واحصل على خط العرض وخط الطول واسم العرض ونوع الموقع المطابق. مدعوم من خدمة OpenStreetMap Nominatim. يدعم العناوين العالمية بأي لغة.

Parameters

stringrequired

The address or place name to geocode.

Code examples

curl -X POST https://api.botoi.com/v1/geo/geocode \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

قم بتحويل العناوين التي أدخلها المستخدم إلى دبابيس الخريطة في تطبيقك

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

قم بإثراء سجلات إدارة علاقات العملاء أو قاعدة البيانات الخاصة بك بالإحداثيات

عناوين عملاء الترميز الجغرافي للدُفعات لإضافة حقول خطوط العرض/الغاز الطبيعي المسال. استخدم الإحداثيات لعمليات البحث عن قرب، أو حسابات منطقة التسليم، أو التقارير الجغرافية.

Frequently asked questions

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

Get your API key

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