העברה מ-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

מרחק מטריצת ה-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 במסמך חישוב מטריצת מסלולים, או בהגדרת נקודת ציון ביניים במסמך ציון נקודות ציון ביניים.

המרת פרמטרים

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

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

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

נוספה תמיכה ב-TWO_WHEELER וגם TRANSIT.

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

הקובץ לא נכלל בתשובה. צריך לכלול את הפרטים הבאים כאשר מציגים את התוצאות למשתמשים:

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. מכיל פרטי תגובות בקידוד גיאוגרפי רק עבור ציוני דרך שצוינו ככתובות.
bounds viewport
legs.end_address לא זמין.
legs.start_address לא זמין.
overview_polyline קו פוליגוני
summary description
waypoint_order optimizedIntermediateWaypointIndex