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

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

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

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

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

خدمة Distance Matrix وMaps JavaScript API (الإصدار القديم) RouteMatrix مطلوبة أم اختيارية
origins origins مطلوب
destinations destinations مطلوب
travelMode travelMode اختياري
transitOptions transitPreference اختياري
arrivalTime arrivalTime اختياري
drivingOptions ‫departureTime، trafficModel اختياري
unitSystem units اختياري
‫avoidHighways، avoidTolls RouteModifiers اختياري

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

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

‫Distance Matrix 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

تُرسل التعليمة البرمجية التالية طلبًا لمصفوفة المسافات باستخدام فئة 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,));