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

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

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

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

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

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

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