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

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

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

צריכים מסלולי נסיעה? למידע נוסף על מסלולים, ראו סקירה כללית על מסלולים ב-Compute.

עוברים? אם אתם עוברים מ-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, לצד הנתונים שהיא מחזירה.

מקורות נתונים הנתונים שהוחזרו פורמט ההחזרה
ComputeRouteMatrix הפונקציה מחזירה מערך של מסלולים מנקודת ציון אחת של המוצא לנקודת ציון אחת של היעד. JSON

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

1 הגדרה מתחילים בהגדרת הפרויקט ב-Google Cloud ומבצעים את ההוראות להגדרה שמפורטות בהמשך.
2 איך מתבצע החיוב ב-Routes API מידע נוסף זמין במאמר שימוש וחיובים.
3 חישוב מטריצת המסלולים ובדיקה של התגובה למידע נוסף, ראו קבלת מטריצת מסלולים ובדיקת התגובה של מטריצת המסלולים.

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

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

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