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

מ-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

נוספה תמיכה ב-TWO_WHEELER וב-TRANSIT.
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

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

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