انتقال به تکمیل خودکار (جدید)

API Places از APIهای تکمیل خودکار (Legacy) و Query Autocomplete (Legacy) پشتیبانی می کند. اگر با این 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

برای کسب اطلاعات بیشتر در مورد استفاده از ماسک‌های فیلد، به جزئیات مکان‌ها (جدید) مراجعه کنید.