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

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

التغييرات

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

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

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

1. تأكَّد من تفعيل Places API (New) لمشروعك في 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');
});