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

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

تغییرات

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

مراحل مهاجرت

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

1. بررسی کنید که Places API (جدید) برای پروژه شما در کنسول Cloud فعال باشد.
2. Places 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');
});

،

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

تغییرات

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

مراحل مهاجرت

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

1. بررسی کنید که Places API (جدید) برای پروژه شما در کنسول Cloud فعال باشد.
2. Places 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');
});