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

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

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

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

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

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

  • הצד של הכביש שבו אפשר לאסוף או להוריד אנשים

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

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

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

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

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

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

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

באמצעות Routes API אפשר לקבל שתי קטגוריות עיקריות של פרטי ניתוב:

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

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

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

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

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

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

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

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

    • מחרוזות טקסט. לדוגמה: 'תל אביב, תל אביב-יפו', 'תל אביב, תל אביב-יפו, 64332', '1800 Amphitheatre Parkway, Mountain View, CA 94043' או 'CWF6+FWX Mountain View, California'

    • מזהי מקומות

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

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

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

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

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

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

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

  • זמן נסיעה משוער בפקקים

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

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

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

איך פועל ה-Routes API

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

ComputeRoutes

השיטה ComputeRoutes של 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

ה-API של Routes‏ 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 הפונקציה מחזירה מערך של מסלולים מנקודת ציון אחת של המוצא לנקודת ציון אחת של היעד.

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

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

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

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

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