الوعود

تعرض الطرق غير المتزامنة في Google Maps JavaScript API كائنات Promises.

الدعم

واجهة برمجة التطبيقات تعرض الطرق كائنات Promises
الاتجاهات نعم
مصفوفة المسافات نعم
الارتفاع نعم
المحوّل الجغرافي نعم
صور التكبير/التصغير الأقصى نعم
أماكن لا
Places AutocompleteService جزئي1
التجوّل الافتراضي نعم

الاستخدام

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

الدالتان async وawait

يتم استخدام عامل التشغيل await لانتظار كائن Promise. لا يمكن استخدامه إلا داخل دالة غير متزامنة.

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

يحتوي كائن Promise على الدوال 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. لا تتوافق كائنات Promises حاليًا إلا مع getPlacePredictions(). ↩