סקירה כללית על 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.

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