במדריך הזה נסביר איך להעביר אפליקציות שמשתמשות ב-API של Directions או ב- אבטחה של מטריקס API לשימוש ב-Routes API. פרטים נוספים על Routes API מופיעים בסקירה הכללית על מוצרים.
עדכון נקודות הקצה ל-API ל-REST
צריך לעדכן את הקוד כדי להשתמש בנקודות הקצה החדשות של Routes API
מ-API של המסלול
API של המסלול | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
Routes API | https://routes.googleapis.com/directions/v2:computeRoutes |
מממשק API של מטריצת מרחק
מרחק API מטריקס | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
Routes API | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
המרת פרמטרים של כתובת אתר לשימוש בגוף בקשת HTTPS
בעזרת Directions API ו-mile Matrix API, תוכלו להעביר מאפייני הגדרה כפרמטרים של כתובת URL לבקשת HTTP GET
. לדוגמה, ב-Directions API:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
באמצעות Routes API, אפשר להעביר פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST
. דוגמאות:
המרת ציוני דרך מקודדים בפוליגונים לציוני דרך במיקום
אפשר לציין ציוני דרך כקווים פוליגונים מקודדים ב-Directions API כדי להתאים למספר גדול של ציוני דרך במגבלת כתובת ה-URL של 16384 תווים. התכונה הזו לא נחוצה ב-Routes API, כי ציוני דרך ניתנים להעברה בגוף הבקשה ל-REST או ל-gRPC כקואורדינטות של קווי אורך ורוחב. לדוגמה, תוכלו לעיין בדוגמה ל-HTTP במסמך Compute a path matrix או בהגדרה של נקודת ציון ביניים במסמך ציון ציוני דרך של ביניים.
המרת פרמטרים
בטבלאות הבאות מפורטים פרמטרים ב-Directions API וב-מרחק Matrix API ששינו את שמם או השתנו, או פרמטרים שאינם נתמכים בגרסת GA. אם אתם משתמשים באחד מהפרמטרים האלה, עדכנו את הקוד.
בקשת המרות לפרמטרים
פרמטר של מטריצת מרחק או מסלול | פרמטר Routes API | הערות |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
האפשרות הזו זמינה במצב TRANSIT בלבד, ולא
בו-זמנית עם departureTime . |
avoid |
routeModifiers |
|
departure_time |
departureTime |
לא ניתן להשתמש ב-arrivalTime בו-זמנית. |
language |
languageCode |
יש תמיכה ב-Compute Routes בלבד. |
mode |
travelMode |
הוספנו תמיכה ב- |
region |
regionCode |
|
traffic_model |
trafficModel |
מידע נוסף |
transit_mode |
"travelMode": "TRANSIT" |
ב-Directions API, במסלול של תחבורה ציבורית, כל קטע של נסיעה עם אותו אמצעי הגעה (לדוגמה, הליכה או תחבורה ציבורית) נחשב כשלב אחד, ומסלול נפרד לכל אמצעי התחבורה הזה נכלל בשלבי משנה. לעומת זאת, ב-Routes API, השלבים הם באופן עקבי הוראת ניווט אחת לכל סוגי הנסיעות. כך שכל הוראת ניווט היא שלב. עבור כמה שלבים במצב נסיעה אחד, ב-Routes API יש מטא-נתונים עם סיכום השלבים של כל מצב נסיעה, ב-'stepsOverview'. כדי לבקש את המטא-נתונים האלה, צריך להשתמש במסכת השדות 'routes.legs.stepsOverview'. מידע נוסף |
transit_routing_preference |
transitRoutingPreference |
מידע נוסף |
units |
לא זמינה למטריצת מסלולים. | |
waypoints |
intermediates |
הוסרה התמיכה בקווים מרובים מקודדים. |
optimize=true לציוני דרך |
"optimizeWaypointOrder": "true" |
מידע נוסף |
המרות בפרמטר של תגובה
פרמטר של מטריצת מרחק או מסלול | פרמטר Routes API | הערות |
---|---|---|
copyrights |
לא נכלל בתשובה. עליך לכלול את ההצהרה הבאה בעת הצגת התוצאות למשתמשים שלך:
לדוגמה:
|
|
distance |
distanceMeters |
המרחק זמין במטרים בלבד. |
duration_in_traffic |
duration |
הוסרה ב-Routes API, השתמש ב-duration . |
status |
לא זמין. שימוש בקודי התגובה של ה-HTTP לשגיאות שדווחו על ידי ה-API. אפשר לקרוא מידע נוסף בקטע שגיאות בבקשות טיפול. | |
geocoded_waypoints |
geocoding_results |
יש תמיכה ב-Compute Routes בלבד. מכילה מידע על תגובות של קידוד גיאוגרפי רק עבור ציוני דרך שצוינו ככתובות. |
bounds |
viewport |
|
legs.end_address |
לא זמין. | |
legs.start_address |
לא זמין. | |
overview_polyline |
קו פוליגוני | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |