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

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

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

עוברים ל-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 לגרסה זמינה לכולם (GA)