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

במדריך הזה מוסבר איך להעביר אפליקציות שמשתמשות ב-Directions API או ב-Distance Matrix API לשימוש ב-Routes API. פרטים על Routes API זמינים בסקירה הכללית על המוצר.

שיטות מומלצות לחיוב במהלך העברה

ההנחיה הזו רלוונטית אם נפח השימוש ב-API גבוה מספיק כדי לעבור לרמת התמחור השנייה. כשעוברים לגרסה חדשה יותר של ממשק API, מחויב גם מק"ט אחר. כדי להימנע מעלייה בעלויות במהלך חודש המעבר, מומלץ לעבור ל-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