העברה מ-Directions API או מ-Question Matrix API

במדריך הזה מוסבר איך להעביר אפליקציות שמשתמשות ב-Directions API או ב-Distance Matrix API לשימוש ב-Routes API. פרטים על Routes API זמינים בסקירה הכללית על המוצר.

עדכון נקודות הקצה של ה-API ל-REST

מעדכנים את הקוד כך שישתמש בנקודות הקצה החדשות של Routes API

מ-Directions API

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

מ-Distance Matrix API

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

המרת פרמטרים של כתובות URL לשימוש בגוף בקשה של HTTPS

ב-Directions API וב-Distance Matrix API, מעבירים את מאפייני התצורה כפרמטרים של כתובת URL לבקשה HTTP GET. לדוגמה, ב-Directions API:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

ב-Routes API, מעבירים פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. דוגמאות:

המרת נקודות ציון בקידוד של קו מרובה לנקודות ציון של מיקום

אפשר לציין נקודות דרך כקווים פוליגונים מקודדים ב-Directions API כדי לכלול מספר גדול של נקודות דרך במגבלת התווים של כתובת ה-URL, שהיא 16,384 תווים. התכונה הזו לא נדרשת ב-Routes API כי אפשר להעביר נקודות ציון בגוף הבקשה של ה-REST או ה-gRPC כקואורדינטות של קווי אורך ורוחב. לדוגמה, תוכלו לעיין בדוגמה ל-HTTP במסמך חישוב מטריצת מסלולים, או בהגדרת נקודת ציון ביניים במסמך ציון נקודות ציון ביניים.

המרת פרמטרים

בטבלאות הבאות מפורטים פרמטרים ב-Directions API וב-Distance Matrix API ששינו את השם או שונו, או פרמטרים שלא נתמכים במהדורת GA. אם אתם משתמשים באחד מהפרמטרים האלה, עליכם לעדכן את הקוד.

המרות של פרמטרים של בקשות

פרמטר של מסלול או מטריצת מרחקים פרמטר של Routes API הערות
alternatives computeAlternativeRoutes
arrival_time arrivalTime התכונה זמינה רק במצב TRANSIT, ולא בו-זמנית עם departureTime.
avoid routeModifiers
departure_time departureTime לא ניתן להשתמש בו בו-זמנית עם arrivalTime.
language languageCode התמיכה קיימת רק ב-Compute Routes.
mode travelMode

הוספנו תמיכה ב-TWO_WHEELER וב-TRANSIT.
region regionCode
traffic_model trafficModel מידע נוסף
transit_mode "travelMode": "TRANSIT" ב-Directions API, במסלול לתחבורה ציבורית, כל מקטע של נסיעה באותו אמצעי תחבורה (לדוגמה, הליכה או תחבורה ציבורית) נחשב לשלב אחד, והוראות ספציפיות לאמצעי התחבורה הזה מפורטות בשלבים משניים. לעומת זאת, ב-Routes API, השלבים הם תמיד הוראה אחת לניווט בכל סוגי הנסיעות. כל הוראת ניווט היא שלב. אם יש כמה שלבים באמצעי תחבורה אחד, ב-Routes API מוצגים מטא-נתונים שמכילים סיכום של השלבים באמצעי התחבורה הזה, בשדה stepsOverview. כדי לבקש את המטא-נתונים האלה, משתמשים במסכת השדה routes.legs.stepsOverview. מידע נוסף
transit_routing_preference transitRoutingPreference מידע נוסף
units units מידע נוסף
waypoints intermediates הוסר התמיכה בקווים פוליגונליים מוצפנים.
optimize=true לציון דרך "optimizeWaypointOrder": "true" מידע נוסף

המרות של פרמטרים של תגובה

פרמטר של מסלול או מטריצת מרחקים פרמטר של Routes API הערות
copyrights

לא נכלל בתשובה. כשמציגים את התוצאות למשתמשים, צריך לכלול את ההצהרה הבאה:

Powered by Google, ©YEAR Google

לדוגמה:

Powered by Google, ©2022 Google
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