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

Batch Geocoding API - عنوان مجمع مجاني للإحداثيات

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

Parameters

arrayrequired

Array of address strings to geocode (max 10).

Code examples

curl -X POST https://api.botoi.com/v1/geo/batch \
  -H "Content-Type: application/json" \
  -d '{"addresses":["London, UK","Paris, France","xyzzy nowhere"]}'

When to use this API

رسم مواقع العملاء على الخريطة

قم بترميز قائمة عناوين العملاء جغرافيًا من تصدير CRM الخاص بك. استخدم الإحداثيات لوضع الدبابيس على الخريطة لتخطيط المنطقة أو توجيه التسليم أو تحليل تغطية المبيعات.

إثراء واردات CSV بالإحداثيات

معالجة ملفات CSV التي تم تحميلها والتي تحتوي على عناوين. قم بترميز عمود العنوان جغرافيًا وإلحاق خطوط الطول والعرض بكل صف قبل تخزينه في قاعدة البيانات الخاصة بك.

التحقق من صحة عناوين متعددة في إرسال النموذج

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

Frequently asked questions

ما هو الحد الأقصى لعدد العناوين لكل طلب؟
يمكنك إرسال ما يصل إلى 10 عناوين لكل طلب. بالنسبة للدفعات الأكبر، قم بتقسيم قائمتك إلى أجزاء مكونة من 10 أجزاء وأرسل طلبات متعددة.
ماذا يحدث إذا فشل عنوان واحد؟
تُرجع العناوين الفاشلة lat: null، وlng: null، ورسالة خطأ. بقية العمليات الدفعية بشكل طبيعي. تحقق من العدد الفاشل في الاستجابة لتحديد العناوين التي بها مشكلات.
هل يتم إجراء مكالمات الترميز الجغرافي بالتوازي؟
نعم. يتم ترميز كافة العناوين الموجودة في الدفعة جغرافيًا في وقت واحد للحصول على أوقات استجابة أسرع. تستغرق مجموعة مكونة من 10 عناوين تقريبًا نفس الوقت الذي يستغرقه طلب رمز جغرافي واحد.
هل يمكنني ترميز أكثر من 10 عناوين جغرافيًا؟
ليس في طلب واحد. قسّم قائمتك إلى دفعات مكونة من 10 وأرسل طلبات متعددة. باستخدام الخطة المدفوعة، يمكنك إرسال طلبات مجمعة متعددة في الثانية.
هل هذا هو نفس المشفر الجغرافي مثل /v1/geo/geocode؟
نعم. تستخدم نقطة نهاية الدُفعة نفس المُكود الجغرافي OpenStreetMap Nominatim كنقطة نهاية ذات عنوان واحد. النتائج متطابقة لنفس المدخلات.

Get your API key

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