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

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

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

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

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

  • כיוון הנסיעה של כלי הרכב

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

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

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

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

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

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

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

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

ב-Routing API אפשר לקבל שתי קטגוריות עיקריות של פרטי ניתוב:

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

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

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

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

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

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

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

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

    • מחרוזות טקסט. לדוגמה: 'חיפה, ישראל', 'דרווין, ישראל', "30120222, ישראל" או "CWF6+FWX Mountain View, California"

    • מזהי מקומות

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

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

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

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

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

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

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

  • זמן הגעה משוער במצב התנועה

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

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

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

איך פועל Routes API

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

ComputeRoutes

השיטה Routes API ComputeRoutes מקבלת בקשת HTTP POST עם גוף בקשת JSON שמכיל את פרטי הבקשה. הערכים הנדרשים הם origin, destination, 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

ה-Routs 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 והנתונים שהוא מחזיר.

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

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

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

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

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

מה עושים אחר כך