تتيح Places API الحالية الإكمال التلقائي وواجهات برمجة تطبيقات الإكمال التلقائي لطلب البحث إذا كنت على دراية بهذه واجهات برمجة التطبيقات، تُجري ميزة "الإكمال التلقائي (الإصدار الجديد)" التغييرات التالية:
- يستخدم خيار "الإكمال التلقائي (جديد)" طلبات POST لبروتوكول HTTP. تمرير المعلمات إلى نص الطلب أو في العناوين كجزء من طلب 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 طلبك.
ليست أقنعة الحقول مطلوبة لطلبات الإكمال التلقائي (الجديدة)، ولكن يمكن:
يُستخدم للتصفية للحصول على نتائج محددة في الرد. على سبيل المثال، ما يلي
يستخدم الطلب قناع حقل، بحيث لا يتضمن الرد سوى
suggestions.placePrediction.text من الاقتراح:
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' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete
لمزيد من المعلومات عن استخدام أقنعة الحقول، اطّلِع على تفاصيل الأماكن (جديد).