واجهة API للإكمال التلقائي للعناوين

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

GEThttps://api.mygeocode.com/v1/autocomplete?q=...

جرّبها في العرض التجريبي المرجع الكامل

مثال

الطلب
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/autocomplete?q=10+Downing&country=gb&limit=3"

الاستجابات مضبوطة للكتابة: تعود خلال بضع عشرات من المللي ثانية وتتسامح مع الأحرف الناقصة والكلمات المتبادلة المواضع. أرسل proximity=lat,lon لترتيب الأماكن القريبة أولًا، وهو أمر مهم جدًا لأسماء الشوارع الموجودة في مدن كثيرة.

اضبط تأخير ضغطات المفاتيح (debounce) على نحو 150 مللي ثانية. يستغرق اختيار عنوان نموذجي من 4 إلى 6 طلبات.

الاستجابة
{
  "status": "ok",
  "query": "10 Downing",
  "suggestions": [
    {
      "text": "10 Downing Street, London SW1A 2AA, United Kingdom",
      "lat": 51.503396,
      "lon": -0.12764,
      "type": "address",
      "precision": "house",
      "place_id": "gb.addr.7f3c2a19"
    },
    {
      "text": "10 Downing Place, Cambridge CB2 3EN, United Kingdom",
      "lat": 52.203042,
      "lon": 0.121811,
      "type": "address",
      "precision": "house",
      "place_id": "gb.addr.a01d9e44"
    },
    {
      "text": "10 Downing Road, Dagenham RM9 6NP, United Kingdom",
      "lat": 51.536118,
      "lon": 0.137204,
      "type": "address",
      "precision": "house",
      "place_id": "gb.addr.c58b7e02"
    }
  ]
}

ما تحصل عليه

الحقلالمعنى
textالاقتراح كما يجب أن يُعرض، في سطر واحد.
lat, lonإحداثيات الاقتراح. موجودة في كل اقتراح.
typeaddress أو street أو postcode أو city أو region أو country أو poi.
precisionالقيم الأربع نفسها المستخدمة في الترميز الجغرافي.
place_idمعرّف ثابت. مرّره إلى /v1/forward?place_id=... إذا أردت المكونات الكاملة والحدود للاقتراح المختار.

أين تُستخدم

نماذج العناوين في صفحات الدفع

حقل واحد بدلًا من ستة. يجلب place_id الخاص بالاقتراح المختار المكونات اللازمة لملء بقية النموذج.

مربعات البحث على الخرائط

مرّر مركز الخريطة كقيمة proximity حتى يعني «High Street» الشارع الظاهر على الشاشة.

استبدال Places Autocomplete

يوفر البديل المتوافق مع Google Maps JavaScript الكائن google.maps.places.Autocomplete مدعومًا بنقطة النهاية هذه، دون تسعير حسب الجلسة.

السعر والحدود

كل استدعاء طلب واحد. لا يوجد تسعير حسب الجلسة ولا رسوم منفصلة لاختيار اقتراح. لكل مفتاح 2,500 طلب مجاني يوميًا؛ وبعد ذلك، 0.0001 € لكل طلب من الرصيد مسبق الدفع، أو لا شيء على مفتاح Unlimited (50 € شهريًا). الأسعار.