Routes API הוא שירות אינטרנט עם שתי שיטות: Compute Routes מחזירה מסלול בין שני מיקומים עם נקודות דרך אופציונליות, ו-Compute Route Matrix מחזירה את מרחק הנסיעה ומשך הנסיעה לשילובים של נקודות מוצא ויעדים (עד 625 רכיבי מטריצת מסלולים).
Routes API: עובדות חשובות
- המוצר: Routes API
- נקרא גם: גרסה 2 של Routes API, Compute Routes, Compute מטריצת מסלולים
- קטגוריה: מסלולים
- פלטפורמה: שירות אינטרנט (REST)
- פועל ב: שרת (קוד לקצה העורפי)
- שלב ההשקה: GA
- מחזור חיים: פעיל
- סקירה כללית: סקירה כללית על Routes API
- זמינות אזורית: גלובלית. מסלולים לרכב דו-גלגלי, מסלולים ידידותיים לסביבה וחישוב אגרות מוגבלים למדינות ולערים נתמכות, וטריטוריות תלויות עם קוד CLDR משלהן לא נתמכות אלא אם הן מופיעות ברשימה. אם כתובת החיוב שלכם נמצאת באזור הכלכלי האירופי (EEA), לפי התנאים של ה-EEA שמפורטים בכתובת https://developers.google.com/maps/comms/eea/routes, אסור להשתמש בתיאורי מסלולים או בשלבים עם מפה כלשהי. (פרטי הכיסוי)
Routes API: מתי כדאי להשתמש בו
כדאי להשתמש ב-Routes API במקרים הבאים:
- אתם צריכים מסלול בין נקודת מוצא ליעד, עם נקודות ציון אופציונליות בדרך, לנהיגה, להליכה, לרכיבה על אופניים, לרכיבה על רכב דו-גלגלי או לנסיעה בתחבורה ציבורית.
- אתם צריכים מרחקי נסיעה וזמני נסיעה להרבה זוגות של נקודות מוצא ויעד בבקשה אחת (עד 625 רכיבים).
- אתם צריכים הערכות של אגרות (בערים נבחרות), מסלולים ידידותיים לסביבה (באזורים נבחרים), קווים פוליגוניים שמביאים בחשבון את מצב התנועה או מסלולים לרכבים גדולים (זמינות מוגבלת).
- אתם מעבירים אפליקציית שרת מהגרסאות הקודמות של Directions API או Distance Matrix API.
מתי לא כדאי להשתמש ב-Routes API:
- אתם צריכים לבצע אופטימיזציה של הקצאות העומס ולהפסיק את ההזמנות לצי שלם של כלי רכב. במקומו, צריך להשתמש ב-Route Optimization API.
- אתם צריכים ניווט מפורט בתוך האפליקציה ב-Android, שפועל לפי מסלול מחושב. במקום זאת, צריך להשתמש ב-Navigation SDK ל-Android.
- אתם צריכים ניווט מפורט בתוך האפליקציה ב-iOS, שפועל לפי מסלול מחושב. במקום זאת, צריך להשתמש ב-Navigation SDK ל-iOS.
Routes API: הגדרה
- השירות שצריך להפעיל:
routes.googleapis.com - אימות: מפתח API, OAuth 2.0, חשבון שירות
- תחילת העבודה: הגדרת Routes API
- חומר עזר: חומר עזר בנושא Routes API
- תמחור: שימוש וחיוב ב-Routes API
- כללי מדיניות: כללי המדיניות של Routes API
- נתוני גרסה: נתוני הגרסה של Routes API
חבילות רשמיות של Routes API:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
Routes API: מוצרים קשורים
- מחליף את: Directions API, Distance Matrix API
- ממשקים שמשתמשים בהם לעיתים קרובות עם ה-API הזה: Navigation SDK ל-Android, Navigation SDK ל-iOS, Route Optimization API, Geocoding API, Places API (הגרסה החדשה)
Routes API: טעויות נפוצות
- הבעיה: אין רשימת ברירת מחדל של שדות שמוחזרים. בקשות בלי מסכת שדות (כותרת
X-Goog-FieldMaskאו פרמטר$fields) מחזירות שגיאה. הפתרון: תמיד צריך לשלוח מסכת שדות שמפרטת את שדות התגובה שאתם צריכים. מידע נוסף זמין בכתובת /maps/documentation/routes/choose_fields. - הבעיה: שימוש במסכת שדה של תו כללי לחיפוש (
*) בסביבת הייצור מגדיל את העלות ואת זמן האחזור, והעלות יכולה לעלות באופן בלתי צפוי כשמוסיפים לתגובה תכונות מתקדמות חדשות. תיקון: משתמשים ב-*רק במהלך הפיתוח. בסביבת הייצור, מבקשים רק את השדות שצריך. מידע נוסף זמין בכתובת /maps/documentation/routes/choose_fields. - הבעיה: פרטי כבישי האגרה וצריכת הדלק לא מוחזרים רק על ידי הוספה שלהם למסכת השדות. מאז שהתכונה זמינה לכולם (GA), צריך להפעיל אותם באופן מפורש. תיקון: מוסיפים את המערך
extraComputations(לדוגמהTOLLS,FUEL_CONSUMPTION) לבקשה בנוסף למסכת השדות. מידע נוסף זמין בכתובת /maps/documentation/routes/migrate-routes-preview. - הבעיה: אפשר להשתמש ב-Compute Route Matrix עם 625 רכיבים, אבל רק עם 100 רכיבים כש-
routingPreferenceהואTRAFFIC_AWARE_OPTIMAL. תיקון: כשמשתמשים ב-TRAFFIC_AWARE_OPTIMAL, צריך להקפיד שהמכפלה של מספר נקודות המוצא במספר היעדים תהיה קטנה מ-100 או שווה ל-100, או לפצל את הבקשה. מידע נוסף זמין בכתובת /maps/documentation/routes/compute_route_matrix.
מה אפשר לעשות עם Routes API
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- החזרת מסלול בין שתי קואורדינטות או יותר של קו רוחב/קו אורך כסדרה של קואורדינטות לכל שלב במסלול.
- החזרת מסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך כסדרה של תיאורי תמרונים לשלבים לאורך המסלול.
- החזרת המרחק בין כל שלב במסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- החזרת זמן ההגעה בין כל שלב במסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- החזרת קו פוליגוני מקודד בין כל שלב במסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- החזרת המרחק של מסלול בין שתי קבוצות או יותר של קואורדינטות של קו רוחב/קו אורך.
- החזרת זמן ההגעה של מסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- החזרת קו פוליגוני מקודד למסלול בין שתי קבוצות או יותר של קואורדינטות קו רוחב/קו אורך.
- החזרת מידע על אגרות במסלול בין שתי קבוצות או יותר של קואורדינטות של קווי רוחב/אורך.
- מציינים את אמצעי התחבורה (נסיעה, תחבורה ציבורית, הליכה, רכב דו-גלגלי) לבקשת מסלול. הערה: בשירות האינטרנט של Routes API (computeRoutes), מעבירים את travelMode בגוף ה-JSON של HTTP POST באמצעות RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT או TRUCK עם routeModifiers.vehicleInfo) וכוללים את הכותרת הנדרשת X-Goog-FieldMask במקום פרמטר שאילתה של מצב GET מדור קודם. בספריית המסלולים של Maps JavaScript API, מעבירים את travelMode ואת השדות ב-ComputeRoutesRequest.
- מציינים עצירה או נקודת מעבר לבקשת מסלול.
- מציינים איך להשתמש בנתוני התנועה בבקשה למסלול.
- מציינים מאפיינים שרוצים להימנע מהם, כמו כבישים מהירים או כבישי אגרה, בבקשה למסלול.
- הגדרת נקודות ציון לאורך המסלול.
- הגדרת נקודות ציון לאורך המסלול.
- הגדרת נקודה שהמסלול יעבור דרכה.
- מציינים את כיוון הרכב ואת הצד של הכביש במסלול.
- אופטימיזציה של סדר העצירות במסלול.
- איך מציינים מסלול ידידותי לסביבה בבקשה למסלולים תצוגה מקדימה
- מציינים מרחק קצר יותר או מסלול חלופי לבקשת מסלולים. הערה: ב-Routes API, בקשה למסלול חלופי קצר יותר (SHORTER_DISTANCE) היא תכונה ניסיונית, ובקשה למסלולים חלופיים (computeAlternativeRoutes) היא תכונה ב-GA.
- החזרת מרחקים למטריצה של מסלולים בין כמה נקודות מוצא ויעדים.
- החזרת זמני נסיעה למטריצה של מסלולים בין כמה נקודות מוצא ויעדים.
- החזרת מידע על אגרות למטריצה של מסלולים בין כמה נקודות מוצא ויעדים.
- מציינים את אמצעי התחבורה (נסיעה, תחבורה ציבורית, הליכה, רכב דו-גלגלי) לבקשה של מטריצת מסלולים. הערה: בשירות האינטרנט של Routes API (computeRouteMatrix), מעבירים את travelMode בגוף ה-JSON של HTTP POST באמצעות RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT או TRUCK עם origins[].routeModifiers.vehicleInfo; BICYCLE לא נתמך במטריצות מסלולים) וכוללים את הכותרת הנדרשת X-Goog-FieldMask. בספריית המסלולים של Maps JavaScript API, מעבירים את travelMode ואת השדות ב-ComputeRouteMatrixRequest.