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

המרת פרמטרים

בטבלאות הבאות מפורטים פרמטרים ב-Directions API וב-Distance Matrix API ששמם השתנה או שהם שונו, או פרמטרים שלא נתמכים בגרסת ה-GA. אם אתם משתמשים באחד מהפרמטרים האלה, אתם צריכים לעדכן את הקוד.

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

פרמטר של Directions API או מטריצת מרחקים פרמטרים של 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" מידע נוסף

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

פרמטר של Directions API או מטריצת מרחקים פרמטרים של 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. התגובה מכילה מידע על המרת כתובות לקואורדינטות (geocoding) רק עבור ציוני דרך שצוינו ככתובות.
bounds viewport
legs.end_address לא זמין.

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

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