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

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

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

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

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

למה כדאי להשתמש ב-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 מופיעה במאמר ספריות לקוח.

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