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

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

تغییرات

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

مراحل انتقال

برای انتقال یکپارچه‌سازی «ابزارک تکمیل خودکار مکان» به جدیدترین نسخه، کارهای زیر را انجام دهید:

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