مقدمه
API مکان‌ها از APIهای تکمیل خودکار مکان (قدیمی) و تکمیل خودکار پرس‌وجو (قدیمی) پشتیبانی می‌کند. اگر با این APIها آشنا هستید، تکمیل خودکار (جدید) تغییرات زیر را ایجاد می‌کند:
- تکمیل خودکار (جدید) از درخواست‌های HTTP POST استفاده می‌کند. پارامترها را در بدنه درخواست یا در هدرها به عنوان بخشی از یک درخواست HTTP POST ارسال کنید. در مقابل، با APIهای قدیمی، پارامترهای URL را با استفاده از یک درخواست HTTP GET ارسال می‌کنید.
- تکمیل خودکار (جدید) از کلیدهای API و توکن‌های OAuth به عنوان مکانیزم احراز هویت پشتیبانی می‌کند.
- فقط JSON به عنوان فرمت پاسخ در Autocomplete (جدید) پشتیبانی می‌شود.
جدول زیر پارامترهایی را در Place Autocomplete (Legacy) و Query Autocomplete (Legacy) که به Autocomplete (New) تغییر نام داده یا اصلاح شده‌اند، یا پارامترهایی که دیگر پشتیبانی نمی‌شوند، فهرست می‌کند.
| پارامتر فعلی | پارامتر جدید | یادداشت‌ها |
|---|---|---|
components | includedRegionCodes | |
language | languageCode | |
location | locationBias | |
ipbias | اگر هر دو locationBias و locationRestriction را حذف کنید، API به طور پیش‌فرض از IP biasing استفاده می‌کند. | |
offset | inputOffset | |
radius | locationBias یا locationRestriction | |
region | regionCode | |
stricbounds | locationRestriction | |
sessiontoken | sessionToken | |
types | includedPrimaryTypes |
درخواست نمونه
مثال زیر از درخواست GET با استفاده از Place Autocomplete (Legacy) استفاده می‌کند. در این مثال، شما یک پاسخ 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
برای کسب اطلاعات بیشتر در مورد استفاده از ماسک‌های میدانی، به جزئیات مکان (جدید) مراجعه کنید.