مقدمه
Places API از میاناهای برنامه‌سازی کاربردی تکمیل خودکار جا (قدیمی) و تکمیل خودکار پُرسمان (قدیمی) پشتیبانی می‌کند. اگر با این میاناهای برنامه‌سازی کاربردی آشنا هستید، «تکمیل خودکار (جدید)» تغییرات زیر را ایجاد می‌کند:
- «تکمیل خودکار (جدید)» از درخواست‌های POST HTTP استفاده می‌کند. پارامترها را در بدنه درخواست یا در سرصفحه‌ها به‌عنوان بخشی از درخواست HTTP POST ارسال کنید. درمقابل، با میاناهای برنامه‌سازی کاربردی قدیمی، پارامترهای نشانی وب را بااستفاده از درخواست HTTP GET ارسال می‌کنید.
- «تکمیل خودکار (جدید)» از هر دو کلید میانای برنامه‌سازی کاربردی و کدهای OAuth به‌عنوان سازوکار اصالت‌سنجی پشتیبانی می‌کند.
- فقط JSON به‌عنوان قالب پاسخ در «تکمیل خودکار (جدید)» پشتیبانی می‌شود.
جدول زیر پارامترهای موجود در «تکمیل خودکار جا» (قدیمی) و «تکمیل خودکار پُرسمان» (قدیمی) را که برای «تکمیل خودکار» (جدید) تغییر نام داده یا اصلاح شده‌اند، یا پارامترهایی را که دیگر پشتیبانی نمی‌شوند فهرست می‌کند.
| پارامتر فعلی | پارامتر جدید | یادداشت‌ها |
|---|---|---|
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 حاوی اطلاعاتی درباره مکان‌هایی به نام
«Amoeba» می‌کنید که از نوع establishment هستند و همه پارامترها را به‌عنوان پارامترهای نشانی وب
ارسال می‌کنید:
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
برای کسب اطلاعات بیشتر درباره استفاده از ماسک‌های فیلد، جزئیات مکان (جدید) را ببینید.