למה כדאי להשתמש ב-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.