الوعود

تُعرِض الطرق غير المتزامنة في Google Maps JavaScript API وعودًا.

الدعم

واجهة برمجة التطبيقات تعرِض الطرق وعدًا.
الاتجاهات نعم
مصفوفة المسافة نعم
الارتفاع نعم
المشفِّر الجغرافي نعم
صور التكبير إلى أقصى حد نعم
الأماكن لا
خدمة الإكمال التلقائي للأماكن جزئي1
التجوّل الافتراضي نعم

الاستخدام

عرض هذا المحتوى دليل حول استخدام التعهدات أو الأمثلة أدناه لإجراء استدعاءات الأساليب غير المتزامنة باستخدام واجهة برمجة تطبيقات JavaScript لخرائط Google.

Async وawait

يتم استخدام عامل الانتظار في انتظار وعد. ولا يمكن استخدامها إلا داخل دالة غير متزامنة.

const app = async () => {
  const elevationService = google.maps.ElevationService();
  const locations = [{lat: 27.986065, lng:86.922623}];

  const response = await elevationService.getElevationForLocation({locations});
  console.log(response.results);
};

app();

بعد ذلك، اجمع أخيرًا

تشير رسالة الأشكال البيانية عنصر الوعد يحتوي على طرق then وcatch وfinally تستعين بدوال معاودة الاتصال.

const elevationService = google.maps.ElevationService();
const locations = [{lat: 27.986065, lng:86.922623}];

const promise = elevationService.getElevationForLocation({locations});

promise
    .then((response) => {
      console.log(response.results);
    })
    .catch((error) => {
      console.log(error);
    });
    .finally(() => {
      console.log('done');
    });

نمط معاودة الاتصال غير متزامن

تشير رسالة الأشكال البيانية نمط معاودة الاتصال لا يزال صالحًا ومدعوًا.

const elevationService = google.maps.ElevationService();
const locations = [{lat: 27.986065, lng:86.922623}];

const callback = (results, status) => {
  if (status === 'OK') {
    console.log(results);
  } else {
    // handle this case
  }
};

elevationService.getElevationForLocation({locations}, callback);

  1. لا تتوفّر ميزة "التعهدات" حاليًا إلا في getPlacePredictions(). ↩