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

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 ارسال می کنید. این مثال همچنین از یک فیلد ماسک استفاده می کند، بنابراین پاسخ فقط شامل نام نمایشی و آدرس فرمت شده مکان است:

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" \
https://places.googleapis.com/v1/places:autocomplete