מעבר מ-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`