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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

באמצעות ה-method Compute Routes של Routes API, שניתן לחשב בין מיקומים:

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

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

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

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

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

    • מזהי מקומות

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

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

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

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

ה-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 שמכיל את פרטי הבקשה. חובה למלא לפחות אחד origin, שני יעדים או יותר, 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'

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

משאבים

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

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

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

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

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

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

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