במדריך הזה מוסבר איך להעביר אפליקציות שמשתמשות בשני סוגי האפליקציות אל 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 ו-Distance Matrix API,
העברת מאפייני ההגדרות כפרמטרים של כתובת URL לבקשת HTTP GET
. עבור
לדוגמה, ל-Directions API:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
באמצעות Routes API, אתם מעבירים פרמטרים בגוף הבקשה או בכותרות
כחלק מבקשת HTTP POST
. דוגמאות:
המרת נקודות ציון בקידוד קווים פוליגוניים לנקודות ציון לפי מיקום
ציון ציוני דרך כקווים פוליגוניים מקודדים זמין ב Directions API כדי להתאים לגודל מספר ציוני הדרך במגבלה של 16384 תווים. תכונה זו לא נחוץ ב-Routes API מכיוון שניתן לשדר ציוני דרך גוף הבקשה ל-REST או ל-gRPC כקואורדינטות של קו רוחב/אורך. לדוגמה, לראות את דוגמה ל-HTTP במסמך Compute מטריצת מסלולים, או הגדרת ציון דרך ביניים במסמך ציון נקודות ציון ברמת ביניים.
המרת פרמטרים
בטבלאות הבאות מפורטים פרמטרים Directions API ו-Tracking Matrix API שמכילים שם שונה או שונה, או פרמטרים שלא נתמכים גרסה חדשה. אם אתם משתמשים באחד מהפרמטרים האלה, אתם צריכים לעדכן את הקוד.
המרות של פרמטרים של בקשות
הפרמטר של מטריצת המרחק או המסלולים | פרמטר של 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" |
ב-Directions API, במסלול של תחבורה ציבורית, כל אחד קטע בנסיעה עם אותו מצב נסיעה (לדוגמה, הליכה או תחבורה ציבורית) נחשבת כשלב אחד, ומסלולים נפרדים עבור שמצב הנסיעה הוא בתת-שלבי משנה. לעומת זאת, 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 |