مقدمة
تتوافق واجهة برمجة التطبيقات Places API مع واجهتَي برمجة التطبيقات Place Autocomplete (القديمة) وQuery Autocomplete (القديمة). إذا كنت على دراية بهذه الواجهات، تُجري ميزة "الإكمال التلقائي (الإصدار الجديد)" التغييرات التالية:
- يستخدم خيار "الإكمال التلقائي (جديد)" طلبات 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 تحتوي على معلومات عن الأماكن التي تُسمى
"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.
لا تكون أقنعة الحقول مطلوبة لطلبات "الإكمال التلقائي (جديد)"، ولكن يمكن
استخدامها لفلترة النتائج المحدّدة في الردّ. على سبيل المثال، يستخدم
الطلب التالي قناع حقل حتى لا يتضمّن الرد سوى
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
لمعرفة مزيد من المعلومات عن استخدام أقنعة الحقول، اطّلِع على مقالة تفاصيل الأماكن (ميزة جديدة).