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

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

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

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

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

خدمة Distance Matrix (إصدار قديم) 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,));