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

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

التغييرات

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

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

لنقل عملية تكامل "أداة الإكمال التلقائي للأماكن" إلى أحدث إصدار، اتّبِع الخطوات التالية:

1. تأكَّد من تفعيل واجهة برمجة التطبيقات Places API (الجديدة) لمشروعك في Cloud Console.
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');
});