نقل البيانات إلى تطبيق "الإكمال التلقائي" المصغّر الجديد

دليل نقل البيانات هذا مخصّص للمطوّرين الذين لديهم عملية دمج مع أداة الإكمال التلقائي الخاصة بالأماكن (إصدار تجريبي) قبل الإصدار 3.59.8. يوضّح لك هذا الدليل التغييرات التي عليك إجراؤها لاستخدام أحدث إصدار.

التغييرات

• تمت إعادة تسمية الحدث gmp-placeselect ليصبح gmp-select.
• يعرض الحدث gmp-select الآن مثيلاً من placePrediction بدلاً من مثيل من place. تعرض PlacePrediction.toPlace() كائن Place المناسب.
• أصبح حدث gmp-requesterror الآن gmp-error.

خطوات نقل البيانات

لإجراء عملية نقل لعملية دمج أداة Place Autocomplete Widget إلى أحدث إصدار، اتّبِع الخطوات التالية:

1. تأكَّد من تفعيل Places API (الجديدة) لمشروعك في Cloud Console.
2. أضِف Places API (New) إلى قائمة القيود المفروضة على واجهة برمجة التطبيقات لمفتاح واجهة برمجة التطبيقات الذي تستخدمه.
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');
});