מעבר לשימוש במחלקה Route Matrix

המחלקות RouteMatrix מחליפות את Distance Matrix Service, Maps JavaScript API (Legacy). בדף הזה מוסבר על ההבדלים בין שירות Distance Matrix מהדור הקודם לבין ספריית JavaScript החדשה, ומוצג קוד להשוואה.

‫Distance Matrix API (גרסה קודמת) לעומת Route Matrix class (בטא)

בטבלה הבאה מוצגת השוואה בין פרמטרי הבקשה של 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. קטעי הקוד מציגים את הקוד שנדרש בכל API כדי לשלוח בקשה לקבלת מסלול ולראות את התוצאות.

Directions API (Legacy)

הקוד הבא שולח בקשה למטריצת מרחקים באמצעות 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,));