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

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

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

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

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

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

  • בצד הדרך לאיסוף או להורדה

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

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

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

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

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

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

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

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

  • מסלולים ממיקום מסוים ליעד אחד או לכמה יעדים

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

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

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

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

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

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

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

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

    • מזהי מקומות

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

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

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

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

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

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

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

  • זמן הגעה משוער לפי תנועה

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

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

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

איך פועל ה-Routes API

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

ComputeRoutes

ה-method 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

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

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

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

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

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

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

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