Places API از APIهای تکمیل خودکار و تکمیل خودکار پرس و جو پشتیبانی می کند. اگر با این API ها آشنایی دارید، تکمیل خودکار (جدید) تغییرات زیر را ایجاد می کند:
- تکمیل خودکار (جدید) از درخواست‌های HTTP POST استفاده می‌کند. پارامترها را در بدنه درخواست یا در هدرها به عنوان بخشی از درخواست HTTP POST ارسال کنید. در مقابل، با API های موجود، پارامترهای URL را با استفاده از درخواست HTTP GET ارسال می کنید.
- تکمیل خودکار (جدید) از کلیدهای API و نشانه‌های OAuth به عنوان مکانیزم احراز هویت پشتیبانی می‌کند.
- فقط JSON به عنوان فرمت پاسخ در تکمیل خودکار (جدید) پشتیبانی می‌شود.
جدول زیر پارامترهای موجود در APIهای تکمیل خودکار و تکمیل خودکار Query را که برای تکمیل خودکار (جدید) تغییر نام داده یا اصلاح شده‌اند، یا پارامترهایی که دیگر پشتیبانی نمی‌شوند، فهرست می‌کند.
| پارامتر فعلی | پارامتر جدید | یادداشت ها |
|---|---|---|
components | includedRegionCodes | |
language | languageCode | |
location | locationBias | |
ipbias | اگر هم locationBias و هم locationRestriction را حذف کنید، API به طور پیش‌فرض از بایاس 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 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
برای کسب اطلاعات بیشتر در مورد استفاده از ماسک‌های فیلد، به جزئیات مکان‌ها (جدید) مراجعه کنید.