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

مقدمه

‫Places API از تکمیل خودکار جا (قدیمی) و تکمیل خودکار پُرسمان (قدیمی) پشتیبانی می‌کند. اگر با این «میاناهای برنامه‌سازی کاربردی» آشنا هستید، «تکمیل خودکار (جدید)» تغییرات زیر را اعمال می‌کند:

• «تکمیل خودکار» (جدید) از درخواست‌های HTTP POST استفاده می‌کند. پارامترها را در بدنه درخواست یا در سرایندها به‌عنوان بخشی از درخواست HTTP POST ارسال کنید. درمقابل، با میاناهای برنامه‌سازی کاربردی قدیمی، پارامترهای نشانی وب را بااستفاده از درخواست HTTP GET ارسال می‌کنید.
• «تکمیل خودکار» (جدید) از هر دو کلید API و کدهای OAuth به‌عنوان سازوکار اصالت‌سنجی پشتیبانی می‌کند.
• فقط JSON به‌عنوان قالب پاسخ در «تکمیل خودکار (جدید)» پشتیبانی می‌شود.

جدول زیر پارامترهای «تکمیل خودکار مکان» (قدیمی) و «تکمیل خودکار پُرسمان» (قدیمی) را فهرست می‌کند که برای «تکمیل خودکار» (جدید) تغییر نام داده‌اند یا اصلاح شده‌اند، یا پارامترهایی که دیگر پشتیبانی نمی‌شوند.

پارامتر کنونی	پارامتر جدید	یادداشت‌ها
components	includedRegionCodes
language	languageCode
location	locationBias
ipbias		اگر هم locationBias و هم locationRestriction را حذف کنید، میانای برنامه‌سازی کاربردی به‌طور پیش‌فرض از انحراف 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

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