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

מממשק 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 כדי להתאים מספר גדול של נקודות דרך למגבלת התווים של כתובת ה-URL, שהיא 16,384 תווים. התכונה הזו לא נחוצה ב-Routes API כי אפשר להעביר ציוני דרך בגוף הבקשה ל-REST או ל-gRPC כקואורדינטות של קו רוחב/קו אורך. לדוגמה, תוכלו לעיין בדוגמה ל-HTTP במסמך חישוב מטריצת מסלולים, או בהגדרת נקודת ציון ביניים במסמך ציון נקודות ציון ביניים.

המרת פרמטרים

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