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

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

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

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

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

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