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

במדריך הזה מוסבר איך להעביר אפליקציות שמשתמשות ב-Directions API או ב-Distance Matrix API לשימוש ב-Routes 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