מעבר מ-Directions API (מדור קודם) או מ-Distance Matrix API (מדור קודם)

מפתחים באזור הכלכלי האירופי (EEA)

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

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

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

מועבר בגוף הבקשה בפורמט JSON של POST ב-HTTP ב-method‏ computeRoutes או computeRouteMatrix, באמצעות ערכי RouteTravelMode (DRIVE,‏ TWO_WHEELER,‏ WALK,‏ TRANSIT,‏ TRUCK או BICYCLE ל-computeRoutes) במקום פרמטר של שאילתת כתובת URL ב-GET. נוספה תמיכה ב-TWO_WHEELER, ב-TRANSIT וב-TRUCK.
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" מידע נוסף

המרות של פרמטר התגובה

פרמטר של Directions או מטריצת מרחקים פרמטר של 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 לא זמין.

כדי לקבל מסלול מדויק, השתמשו במזהי מקומות במקום בקואורדינטות. מזהי המקומות מכילים נתונים שמאפשרים להצמיד את המסלול לנקודות הגישה הנכונות.

  • אם מתחילים עם כתובת: משתמשים בהשלמה אוטומטית למקומות או ב-Geocoding API כדי לפתור את הבעיה ולהמיר את הכתובת למזהה מקום.
  • אם מתחילים עם קואורדינטות: כדאי להשתמש בחיפוש יעדים כדי לספק מיקום משמעותי יותר. השגת כתובת מקואורדינטות בלבד יכולה להיות מורכבת ולהוביל להצמדה שגויה. ‫Routes API לא מבצע המרה של קואורדינטות לכתובות (reverse geocoding).
legs.start_address לא זמין.
overview_polyline קו פוליגוני
summary description
waypoint_order optimizedIntermediateWaypointIndex