מעבר מ-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 או Distance matrix פרמטר של 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 או Distance matrix פרמטר של 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