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