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

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

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

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

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