במדריך הזה מוסבר איך להעביר אפליקציות שמשתמשות ב-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 |
מ-Destination Matrix API
מרחק מטריצת ה-API | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
Routes API | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
המרת פרמטרים של כתובת אתר לשימוש בגוף בקשת HTTPS
באמצעות Directions API ו-Destination Matrix API, אתם מעבירים את מאפייני ההגדרות כפרמטרים של כתובת URL לבקשת HTTP GET
. לדוגמה, בשביל Directions API:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
באמצעות Routes API, מעבירים פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST
. דוגמאות:
המרת נקודות ציון בקידוד קווים פוליגוניים לנקודות ציון לפי מיקום
אפשר לציין קווים פוליגוניים מקודדים כקווים פוליגוניים מקודדים ב-Directions API כדי להתאים מספר גדול של ציוני דרך במגבלה של 16,384 תווים לכתובת ה-URL. התכונה הזו לא נחוצה ב-Routes API כי אפשר להעביר ציוני דרך בגוף הבקשה ל-REST או ל-gRPC כקואורדינטות של קו רוחב/קו אורך. לדוגמאות, תוכלו לעיין בדוגמה של HTTP במסמך Compute a path matrix (מטריצת מסלול ב-Compute a), או בהגדרה של נקודת ציון לשלב ביניים במסמך ציון Interpoints.
המרת פרמטרים
בטבלאות הבאות מפורטים פרמטרים ב-Directions API וב-Destination Matrix API שהשם שלהם השתנה או ששינו אותם, או פרמטרים שלא נתמכים בגרסת GA. אם אתם משתמשים באחד מהפרמטרים האלה, אתם צריכים לעדכן את הקוד.
המרות של פרמטרים של בקשות
הפרמטר של מטריצת המרחק או המסלולים | פרמטר של Routes API | הערות |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
האפשרות זמינה במצב TRANSIT בלבד, ולא
באותו זמן
כמו departureTime . |
avoid |
routeModifiers |
|
departure_time |
departureTime |
לא ניתן להשתמש בו-זמנית עם arrivalTime . |
language |
languageCode |
נתמכת רק במסלולי Compute. |
mode |
travelMode |
נוספה תמיכה ב- |
region |
regionCode |
|
traffic_model |
trafficModel |
מידע נוסף |
transit_mode |
"travelMode": "TRANSIT" |
ב-מסלול 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. מכיל פרטי תגובות בקידוד גיאוגרפי רק עבור ציוני דרך שצוינו ככתובות. |
bounds |
viewport |
|
legs.end_address |
לא זמין. | |
legs.start_address |
לא זמין. | |
overview_polyline |
קו פוליגוני | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |