למה כדאי להשתמש ב-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: ספריות לקוח.