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

מפתחים באזור הכלכלי האירופי (EEA)

אם כתובת החיוב שלכם נמצאת באזור הכלכלי האירופי, החל מ-8 ביולי 2025, התנאים וההגבלות של הפלטפורמה של מפות Google למשתמשים באזור הכלכלי האירופי יחולו על השימוש שלכם בשירותים. הפונקציונליות יכולה להיות שונה בין אזור לאזור. מידע נוסף

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

‫Distance Matrix API (גרסה קודמת) לעומת המחלקה Route Matrix

בטבלה הבאה מוצגת השוואה בין פרמטרים של בקשות ב-Distance Matrix API מדור קודם לבין פרמטרים של בקשות במחלקה RouteMatrix.

‫Distance Matrix Service (גרסה קודמת)	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

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