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

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

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

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

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

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

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

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

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

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

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

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

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

מה אפשר לעשות עם 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 שמכיל את פרטי הבקשה. חובה לציין מקור, destination, 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: ספריות לקוח.

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