الوعود

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

الدعم

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

الاستخدام

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

غير متزامن والانتظار

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

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().↩