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

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

עדכון נקודות הקצה ל-API ל-REST

צריך לעדכן את הקוד כדי להשתמש בנקודות הקצה החדשות של Routes API

מ-API של המסלול

API של המסלול https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

מממשק API של מטריצת מרחק

מרחק API מטריקס https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

המרת פרמטרים של כתובת אתר לשימוש בגוף בקשת HTTPS

בעזרת Directions API ו-mile Matrix API, תוכלו להעביר מאפייני הגדרה כפרמטרים של כתובת URL לבקשת HTTP GET. לדוגמה, ב-Directions API:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

באמצעות Routes API, אפשר להעביר פרמטרים בגוף הבקשה או בכותרות כחלק מבקשת HTTP POST. דוגמאות:

המרת ציוני דרך מקודדים בפוליגונים לציוני דרך במיקום

אפשר לציין ציוני דרך כקווים פוליגונים מקודדים ב-Directions API כדי להתאים למספר גדול של ציוני דרך במגבלת כתובת ה-URL של 16384 תווים. התכונה הזו לא נחוצה ב-Routes API, כי ציוני דרך ניתנים להעברה בגוף הבקשה ל-REST או ל-gRPC כקואורדינטות של קווי אורך ורוחב. לדוגמה, תוכלו לעיין בדוגמה ל-HTTP במסמך Compute a path matrix או בהגדרה של נקודת ציון ביניים במסמך ציון ציוני דרך של ביניים.

המרת פרמטרים

בטבלאות הבאות מפורטים פרמטרים ב-Directions API וב-מרחק 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 לא זמינה למטריצת מסלולים.
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