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

عنوان الإكمال التلقائي API - اقتراحات العناوين المجانية

أرسل استعلامًا جزئيًا عن العنوان واسترجع ما يصل إلى 10 اقتراحات للعناوين المنظمة مع إحداثيات الشارع والمدينة والولاية والبلد ونظام تحديد المواقع العالمي (GPS). مصممة لحقول عنوان البحث أثناء الكتابة. يدعم تفضيل اللغة للنتائج المترجمة.

Parameters

stringrequired

Partial address to autocomplete.

number

Max suggestions to return (1-10).

string

ISO 639-1 language code for results.

Code examples

curl -X POST https://api.botoi.com/v1/address/autocomplete \
  -H "Content-Type: application/json" \
  -d '{"query":"1600 Amphithea","limit":3,"lang":"en"}'

When to use this API

إنشاء حقول عنوان البحث أثناء الكتابة

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

تقليل أخطاء النموذج عند الخروج عبر الهاتف المحمول

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

قوة البحث عن الموقع في تطبيقات رسم الخرائط

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

Frequently asked questions

كم عدد الاقتراحات التي يمكنني طلبها؟
قم بتعيين معلمة الحد بين 1 و10. الإعداد الافتراضي هو 5. تقوم واجهة برمجة التطبيقات بإرجاع عدد النتائج المطابقة التي تم العثور عليها على الأكثر، والتي قد تكون أقل من الحد.
ما هي اللغات المدعومة؟
اجتياز أي رمز لغة ISO 639-1 (على سبيل المثال، "de" للغة الألمانية، و"ja" للغة اليابانية). يتم إرجاع النتائج باللغة المطلوبة عند توفر الترجمات. يعود إلى اللغة المحلية خلاف ذلك.
هل هناك حد أدنى لطول الاستعلام؟
يجب أن يتكون الاستعلام من حرف واحد على الأقل بدون مسافة بيضاء. الاستعلامات الأقصر ترجع نتائج أوسع. للحصول على أفضل الاقتراحات، أرسل ما لا يقل عن 3-4 أحرف.
هل يعمل هذا مع أسماء الشركات أو عناوين الشوارع؟
إنه يعمل لكليهما. يطابق المشفر الجغرافي عناوين الشوارع والأحياء والمدن والأماكن المسماة. قد تتطابق أسماء الأنشطة التجارية أو لا تتطابق وفقًا لتغطية قاعدة بيانات الخرائط.
ما هو وقت الاستجابة؟
تتراوح أوقات الاستجابة النموذجية بين 100 و300 مللي ثانية اعتمادًا على حمل خدمة الترميز الجغرافي. للحصول على تجربة كتابة مسبقة سلسة، قم بإطلاق طلبات الارتداد لمدة 150-200 مللي ثانية بعد توقف المستخدم عن الكتابة.

Get your API key

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