نقل البيانات إلى الإكمال التلقائي (جديد)

تتيح Places API استخدام واجهتَي برمجة التطبيقات الإكمال التلقائي والإكمال التلقائي لطلبات البحث. إذا كنت معتادًا على استخدام واجهات برمجة التطبيقات هذه، ستجري ميزة الإكمال التلقائي (الجديدة) التغييرات التالية:

• تستخدم ميزة الإكمال التلقائي (جديدة) طلبات HTTP POST. أدخِل المعلَمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST. وفي المقابل، يمكنك تمرير معلَمات عناوين URL باستخدام طلب HTTP GET باستخدام واجهات برمجة التطبيقات الحالية.
• تتوافق ميزة "الإكمال التلقائي" (جديدة) مع كل من مفاتيح واجهة برمجة التطبيقات ورموز OAuth كآلية للمصادقة.
• يمكن استخدام JSON فقط كتنسيق استجابة في ميزة الإكمال التلقائي (جديد).

يسرد الجدول التالي المعلَمات في واجهات برمجة التطبيقات الحالية الخاصة بميزة "الإكمال التلقائي" و"الإكمال التلقائي" لطلبات البحث والتي تمت إعادة تسميتها أو تعديلها لاستخدام ميزة "الإكمال التلقائي" (الجديدة)، أو المَعلمات التي لم تعُد متوافقة.

المعلمة الحالية	معلَمة جديدة	Notes
components	includedRegionCodes
language	languageCode
location	locationBias
ipbias		إذا حذفت كلاً من locationBias وlocationRestriction، ستستخدم واجهة برمجة التطبيقات انحياز عنوان IP تلقائيًا.
offset	inputOffset
radius	‫‎locationBias أو ‎locationRestriction
region	regionCode
stricbounds	locationRestriction
sessiontoken	sessionToken
types	includedPrimaryTypes

مثال على الطلب

يستخدم المثال التالي لطلب GET الإكمال التلقائي الحالي للمكان. في هذا المثال، تطلب استجابة JSON تحتوي على معلومات عن أماكن تُسمى "Amoeba" من النوع establishment وتمرر جميع المعلمات كمَعلمات عناوين URL:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

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

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete