סקירה כללית על Compute Route Matrix

‫Compute Route Matrix היא שיטה בשירות Routes API שמקבלת בקשת HTTPS ומחזירה מרחקים וזמני נסיעה עבור מטריצה של מסלולים בין מיקומי מוצא ויעד שונים. חישוב זמני נסיעה ומרחקים לכמה יעדים, עד 625 רכיבי מסלול.

צריכים מסלולי נסיעה? אם אתם רוצים לקבל הוראות הגעה למסלול, כדאי לעיין במאמר סקירה כללית על חישוב מסלולים.

עוברים ל-Google Workspace? אם אתם עוברים מ-Distance Matrix API (גרסה קודמת), הוראות המיגרציה מפורטות במאמר בנושא למה כדאי לעבור ל-Routes API.

למה כדאי להשתמש ב-Compute Route Matrix

בעזרת Compute Route Matrix (חישוב מטריצת מסלולים), אפשר לקבוע את המסלולים היעילים ביותר לתזמון שיגורים, למשל:

• מה הדרך הכי טובה להקצות קבוצת עובדים לאיסוף של סדרת חבילות

• קביעה של המחסן שממנו הכי כדאי לשלוח חבילות ליעד הסופי שלהן

מה אפשר לעשות עם Compute Route Matrix?

בעזרת Compute Route Matrix (חישוב מטריצת מסלולים) אפשר לקבל מטריצה של מסלולים אפשריים בין הרבה נקודות התחלה וסיום. אפשר לציין כמה מקורות ויעדים לכל בקשה בצד השרת, עד 625 מקורות ויעדים. אפשר להזרים רכיבים של התשובה לפני שכל המטריצה מחושבת, וכך להקטין את זמן האחזור של התשובה.

אתם יכולים לבקש נתונים כאלה של מסלולים כדי לקבוע את הדרך היעילה ביותר להעביר נוסעים, משלוחים או עובדים בין כמה נקודות מוצא ליעדים:

• המרחק בקילומטרים או במיילים עבור אמצעי תחבורה נבחר

• זמן נסיעה משוער בתנאי תנועה

איך פועל Compute Route Matrix

השיטה ComputeRouteMatrix מקבלת בקשת HTTP POST עם גוף בקשה בפורמט JSON שמכיל את פרטי הבקשה. חובה לציין לפחות מקור אחד, שתי נקודות יעד או יותר, travelMode ומסכת שדות כדי לציין אילו שדות להחזיר.

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

התשובה מכילה את המסלולים האפשריים לשילוב של כל נקודות המוצא והיעד.

משאבים

בטבלה הבאה מפורטים המשאבים שזמינים דרך השיטה Compute Route Matrix ב-Routes API, יחד עם הנתונים שהיא מחזירה.

איך משתמשים ב-Compute Route Matrix

ספריות לקוח זמינות

רשימה של ספריות הלקוח שזמינות ל-Compute Route Matrix מופיעה במאמר ספריות לקוח.

המאמרים הבאים

• קבלת מטריצת מסלולים
• אפשרויות מטריצת המסלולים הזמינות
• בחירת המידע שיוחזר
• מעבר מ-Distance Matrix API (גרסה קודמת)
• מעבר מגרסת הטרום-השקה של Routes API לגרסה הזמינה לכולם