סקירה כללית על Routes API

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

למה כדאי להשתמש ב-Routes API

בעזרת Routes API אתם יכולים לקבל מידע מדויק לגבי נסיעות ומסלולים מדויקים, על סמך פרטי התחבורה, מצב התנועה והתנאים העדכניים והעדפות המסלול:

  • הסוגים והיכולות של אמצעי תחבורה שונים

  • לאיזה כיוון הרכב פונה

  • צידי הדרך לטנדרים או להורדות

  • מצב התנועה וסגירת כבישים

  • חששות בטיחותיים, כמו הימנעות מאזורים מסוכנים או אספקת אזורי איסוף בטוחים

  • איזון בין זמן אחזור, איכות ועלות בכל צורכי הניתוב שלכם, בעזרת תכונות אופציונליות כמו מטא-נתונים של כבישי אגרה ומטא-נתונים של נסיעות, כמו זמן ומרחק וחיסכון בדלק

תוכלו גם למצוא את המסלולים היעילים ביותר לתזמון משלוחים, למשל:

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

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

מה אפשר לעשות עם Routes API?

ב-Routes API, תוכלו לקבל שתי קטגוריות עיקריות של פרטי ניתוב:

  • מסלולים ממיקום ליעד יחיד או למספר יעדים

  • מטריצה של מסלולים אפשריים בין מיקומי התחלה וסיום רבים.

הצגת מסלולים ליעד אחד או למספר יעדים

באמצעות השיטה Compute Routes של Routes API אפשר לחשב בין מיקומים:

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

    • אמצעי תחבורה, כולל תחבורה ציבורית, נהיגה, כלי רכב דו-גלגליים, הליכה או רכיבה על אופניים.

    • סדרה של ציוני דרך שבהם ניתן לבצע אופטימיזציה כדי להגיע אליהם באופן היעיל ביותר.

  • מספר דרכים לציון מקורות, יעדים וציוני דרך:

    • מחרוזות טקסט. לדוגמה: 'שיקגו, אילינוי', 'דרווין, NT, אוסטרליה', '1800 Amphitheatre Parkway, Mountain View, CA 94043' או 'CWF6+FWX Mountain View, California'

    • מזהי מקומות

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

  • שיפור אפשרויות המסלול בהתאם לצרכים וליעדים שלכם:

  • כדי לשלוט בזמן האחזור ובאיכות, אתם יכולים לבקש רק את הנתונים שנחוצים לכם באמצעות אנונימיזציה של שדות, וכך להימנע מזמן עיבוד מיותר ומשיעורי חיוב גבוהים יותר. פרטים נוספים זמינים במאמר בחירת סוג המידע שיוחזר.

קבלת מטריצה של מסלולים אפשריים

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

  • המרחק של אמצעי ההגעה שנבחר

  • המרחק בקילומטרים או במיילים

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

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

אפשר לשדר רכיבים של התגובה לפני החישוב של המטריצה כולה, וכך לקצר את זמן האחזור של התגובה.

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

איך פועל Routes API

ל-Routes API יש שתי שיטות: ComputeRoute ו-ComputeRouteMatrix.

ComputeRoute

method ComputeRoute של Routes API מקבל בקשת HTTP POST עם גוף של בקשת JSON שמכיל את פרטי הבקשה. כדי לציין את השדות שצריך להחזיר, הם שדות חובה: מקור, יעד, TravelMode ומסכת שדות.

דוגמה

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

לאחר מכן, השירות מחשב את המסלול המבוקש ומחזיר את השדות שביקשתם.

ComputeRouteMatrix

ה-Routes API 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'

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

מקורות מידע

בטבלה הבאה מוצג סיכום של המשאבים שזמינים דרך Routes API יחד עם הנתונים שהוא מחזיר.

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

איך משתמשים ב-Routes API

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

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

במאמר ספריות הלקוח תוכלו למצוא רשימה של ספריות הלקוח הזמינות ל-Routes API.

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