الانتقال إلى فئة Route Matrix

مطوّرو المنطقة الاقتصادية الأوروبية

يحلّ الصف RouteMatrix محل خدمة Distance Matrix وMaps JavaScript API (الإصدار القديم). توضّح هذه الصفحة الاختلافات بين خدمة "مصفوفة المسافات" القديمة ومكتبة JavaScript الجديدة، وتقدّم بعض الرموز البرمجية للمقارنة.

‫Distance Matrix API (الإصدار القديم) مقابل فئة Route Matrix

يقارن الجدول التالي بين مَعلمات الطلب الخاصة بـ Distance Matrix API القديمة وفئة RouteMatrix.

خدمة "مصفوفة المسافة" (الإصدار القديم) RouteMatrix

المَعلمات المطلوبة
origins origins
destinations destinations

المَعلمات الاختيارية
travelMode travelMode
transitOptions transitPreference
arrivalTime arrivalTime
drivingOptions departureTime، trafficModel
unitSystem units
avoidHighways، avoidTolls RouteModifiers

مقارنة الرموز

يقارن هذا القسم بين جزأين متشابهَين من الرمز البرمجي لتوضيح الاختلافات بين واجهة برمجة التطبيقات القديمة Distance Matrix API وفئة RouteMatrix الجديدة. تعرض مقتطفات الرموز البرمجية الرمز المطلوب في كل واجهة برمجة تطبيقات معنية لإجراء طلب اتجاهات وعرض النتائج.

Directions API (الإصدار القديم)

ينشئ الرمز التالي طلب مصفوفة مسافة باستخدام الإصدار القديم من Distance Matrix API. 

// Define the request.
const request = {
  origins: [{lat: 55.93, lng: -3.118}, 'Greenwich, England'],
  destinations: ['Stockholm, Sweden', {lat: 50.087, lng: 14.421}],
  travelMode: 'DRIVING',
  drivingOptions: {
    departureTime: new Date(Date.now()),
    trafficModel: 'optimistic'
  }
};

// Make the request.
service.getDistanceMatrix(request).then((response) => {
  // Display the response.
  document.getElementById("response").textContent = JSON.stringify(
    response,
    null,
    2,
  );
});

فئة مصفوفة المسارات

ينفّذ الرمز التالي طلب مصفوفة مسافة باستخدام فئة Route Matrix الجديدة: 

// Define the request.
const request = {
  origins: [{lat: 55.93, lng: -3.118}, 'Greenwich, England'],
  destinations: ['Stockholm, Sweden', {lat: 50.087, lng: 14.421}],
  travelMode: 'DRIVING',
  departureTime: new Date(),
  trafficModel: 'optimistic'
};

// Make the request.
const response = await RouteMatrix.computeRouteMatrix(request);

// Display the response.
document.getElementById("response").setValue(JSON.stringify(response, null, 2,));