الإكمال التلقائي للعناوين

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

المعاملات

مثال

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/autocomplete?q=oxford+st&proximity=51.515,-0.141&limit=3"

const url = new URL("https://api.mygeocode.com/v1/autocomplete");
url.searchParams.set("q", "oxford st");
url.searchParams.set("proximity", "51.515,-0.141");
url.searchParams.set("limit", "3");

const { suggestions } = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
suggestions.forEach((s) => console.log(s.text, s.lat, s.lon));

import requests

r = requests.get("https://api.mygeocode.com/v1/autocomplete",
                 params={"q": "oxford st", "proximity": "51.515,-0.141", "limit": 3}, headers={"X-API-Key": "YOUR_KEY"}, timeout=5)
for s in r.json()["suggestions"]:
    print(s["text"], s["lat"], s["lon"])

{
  "status": "ok",
  "query": "oxford st",
  "suggestions": [
    { "text": "Oxford Street, London W1, United Kingdom", "lat": 51.515419, "lon": -0.141588, "type": "street", "precision": "street", "place_id": "gb.street.0a91e2c4" },
    { "text": "Oxford Street, Southampton SO14, United Kingdom", "lat": 50.899021, "lon": -1.399537, "type": "street", "precision": "street", "place_id": "gb.street.77b4d1f0" },
    { "text": "Oxford Street Station, London W1, United Kingdom", "lat": 51.515167, "lon": -0.141251, "type": "poi", "precision": "house", "place_id": "gb.poi.3c5a8e19" }
  ]
}

حقول الاستجابة

ملاحظات

• أخّر معالجة الإدخال بنحو 150 ms وألغِ الطلبات الجارية عندما يواصل المستخدم الكتابة. تحمل الاستجابات قيمة query التي تجيب عنها، لتتمكن من تجاهل الاستجابات القديمة.
• لا توجد رموز جلسة. كل استدعاء طلب واحد. يتطلب اختيار عنوان نموذجي من 4 إلى 6 استدعاءات.
• الاستدعاء من المتصفح في الفئة المجانية هو الاستخدام المقصود للمواقع العامة. يُحتسب عنوان IP الخاص بالزائر، لا عنوانك.
• تتوفر صيغ أداة Google places.Autocomplete وMapbox Search Box وHERE Autosuggest وBing Autosuggest على المضيفات البديلة المتوافقة.

الاستعلام نفسه بصيغ المزوّدين الآخرين

إذا كان لديك كود مكتوب بالفعل لأحد هؤلاء المزوّدين فاحتفظ به: يقبل المضيف البديل المتوافق المسار والمعاملات نفسها ويجيب بشكل استجابة ذلك المزوّد، وخلفه نقطة النهاية هذه. راجع كيف تعمل المضيفات البديلة المتوافقة.

الأخطاء

400 invalid_request عندما يكون q أقصر من 2 أحرف، أو يحتوي types على قيمة غير معروفة.