تتيح Places API الحالية الإكمال التلقائي وواجهات برمجة تطبيقات الإكمال التلقائي لطلب البحث إذا كنت معتادًا على استخدام واجهات برمجة التطبيقات هذه، ستجري ميزة الإكمال التلقائي (الجديدة) التغييرات التالية:
- تستخدم ميزة الإكمال التلقائي (جديدة) طلبات HTTP POST. تمرير المعلمات إلى نص الطلب أو في العناوين كجزء من طلب HTTP POST. في المقابل، مع واجهات برمجة التطبيقات الحالية، يمكنك تمرير معلمات عناوين URL باستخدام طلب HTTP GET.
- يتوافق الإكمال التلقائي (جديد) مع مفتاحَي واجهة برمجة التطبيقات ورموز OAuth كآلية للمصادقة.
- يمكن استخدام JSON فقط كتنسيق استجابة في ميزة الإكمال التلقائي (جديد).
يسرد الجدول التالي المعلَمات في الجدول الزمني الحالي واجهات برمجة التطبيقات للإكمال التلقائي والإكمال التلقائي التي تمت إعادة تسميتها أو تعديلها لميزة "الإكمال التلقائي" (الجديدة) أو المَعلمات التي لم تعُد متاحة.
| المعلمة الحالية | معلَمة جديدة | ملاحظات |
|---|---|---|
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
ردّ يحتوي على معلومات حول أماكن تُسمى "أميبا" من النوع
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