الانتقال إلى فئة 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,));