به ویجت تکمیل خودکار جدید مهاجرت کنید، به ویجت تکمیل خودکار جدید مهاجرت کنید

این راهنمای مهاجرت برای توسعه‌دهندگانی است که قبل از نسخه ۳.۵۹.۸ با ابزارک تکمیل خودکار مکان (پیش‌نمایش) یکپارچه‌سازی داشته‌اند. این راهنما تغییراتی را که برای استفاده از آخرین نسخه باید ایجاد کنید، به شما نشان می‌دهد.

تغییرات

  • رویداد gmp-placeselect به gmp-select تغییر نام داده شده است.
  • رویداد gmp-select اکنون به جای یک نمونه place یک نمونه placePrediction برمی‌گرداند. PlacePrediction.toPlace() شیء Place مناسب را برمی‌گرداند.
  • رویداد gmp-requesterror اکنون gmp-error است.

مراحل مهاجرت

برای انتقال ادغام ابزارک تکمیل خودکار مکان به آخرین نسخه، موارد زیر را انجام دهید:

  1. تأیید کنید که Places API (جدید) برای پروژه شما در کنسول Cloud فعال شده است.
  2. API مکان‌ها (جدید) را به لیست محدودیت‌های API برای کلید API مورد استفاده خود اضافه کنید.
  3. در محیط توسعه خود، تغییرات زیر را انجام داده و آزمایش کنید:

شنونده رویداد را به‌روزرسانی کنید

همانطور که در قطعه کدهای زیر نشان داده شده است، gmp-placeselect به gmp-select تغییر دهید:

قبل از 

autocompleteElement.addEventListener('gmp-placeselect', (event) => {
  console.log(event.place);
});

بعد از 

autocompleteElement.addEventListener('gmp-select', (event) => {
  console.log(event.placePrediction.toPlace());
});

تغییر componentRestrictions به includedRegionCodes

نمونه‌های componentRestrictions را طوری تغییر دهید که از فیلد includedRegionCodes استفاده کنند، همانطور که در قطعه کدهای زیر نشان داده شده است.

قبل از 

const autocompleteElement = new google.maps.places.PlaceAutocompleteElement({
  componentRestrictions: {country: ['US']},
  ...
});

بعد از 

const autocompleteElement = new google.maps.places.PlaceAutocompleteElement({
  includedRegionCodes: ['US'],
  ...

types به includedPrimaryTypes تغییر دهید

نمونه‌هایی از types را تغییر دهید تا از فیلد includedPrimaryTypes استفاده کنند، همانطور که در قطعه کدهای زیر نشان داده شده است.

قبل از 

const autocompleteElement = new google.maps.places.PlaceAutocompleteElement({
  types: ['restaurant'],
});

بعد از 

const autocompleteElement = new google.maps.places.PlaceAutocompleteElement({
  includedPrimaryTypes: ['restaurant'],
});

تغییر gmp-requesterror به gmp-error

همانطور که در قطعه کدهای زیر نشان داده شده است، نمونه‌های gmp-requesterror را به gmp-error تغییر دهید:

قبل از 

autocompleteElement.addEventListener('gmp-requesterror', (event) => {
  console.log('an error occurred');
});

بعد از 

autocompleteElement.addEventListener('gmp-error', (event) => {
  console.log('an error occurred');
});