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

    • מזהי מקומות

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

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

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

אחזור מטריצה של מסלולים אפשריים

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

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