Route Optimization API מקצה משימות ומסלולים לצי רכבים, ומבצע אופטימיזציה בהתאם ליעדים ולאילוצים שאתם מגדירים, כמו חלונות זמן, קיבולת הרכב, שעות הנהג והעלויות. אתם יכולים להפעיל אותו באמצעות REST, gRPC או ספריות לקוח, והוא מחזיר רצפי ביקורים, הקצאות משלוחים, זמנים משוערים ומדדי מסלולים.
Route Optimization API: עובדות חשובות
- המוצר: Route Optimization API
- ידוע גם בשם: GMPRO
- קטגוריה: מסלולים
- פלטפורמה: שירות אינטרנט (REST)
- פועל ב: שרת (קוד לקצה העורפי)
- שלב ההשקה: GA
- מחזור חיים: פעיל
- סקירה כללית: סקירה כללית על Route Optimization API
מתי כדאי להשתמש ב-Route Optimization API
מתי כדאי להשתמש ב-Route Optimization API:
- אתם צריכים להקצות משלוחים או משימות לכמה כלי רכב, תוך התחשבות בחלונות הזמן, בקיבולת של כלי הרכב, בשעות העבודה של הנהגים ובעלויות.
- אתם צריכים את רצף העצירות הטוב ביותר לרכב אחד עם כמה איסופים, משלוחים או פגישות.
- צריך לבצע אופטימיזציה מחדש של מסלולים פעילים להזמנות חדשות (כמו שיגור על פי דרישה) באמצעות
injectedFirstSolutionRoutesאוinjectedSolutionConstraint. - כדי להעביר טוקנים של מסלולים ל-Navigation SDK, צריך טוקן לכל מקטע בתוכנית שעברה אופטימיזציה.
מתי לא כדאי להשתמש ב-Route Optimization API:
- אתם צריכים מעקב בזמן אמת אחרי האופן שבו הנהגים מבצעים את התוכנית. ה-API מחזיר קווים פוליגוניים מתוכננים, ולא מסלולי רכב בזמן אמת. במקום זאת, צריך להשתמש ב-Fleet Engine Service.
- אתם צריכים הנחיות מפורטות באפליקציה לנהגים לאורך המסלול שעבר אופטימיזציה. במקום זאת, צריך להשתמש ב-Navigation SDK ל-Android.
- אתם צריכים הנחיות מפורטות בתוך האפליקציה לנהגים ב-iOS לאורך המסלול שעבר אופטימיזציה. במקום זאת, צריך להשתמש ב-Navigation SDK ל-iOS.
Route Optimization API: הגדרה
- השירות שצריך להפעיל:
routeoptimization.googleapis.com - אימות: OAuth 2.0, חשבון שירות
- תחילת העבודה: הגדרת Route Optimization API
- חומר עזר: מאמרי העזרה של Route Optimization API
- תמחור: שימוש ב-Route Optimization API וחיוב
- כללי מדיניות: כללי המדיניות של Route Optimization API
- נתוני גרסה: נתוני הגרסה של Route Optimization API
חבילות רשמיות של Route Optimization API:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: מוצרים קשורים
- בדרך כלל משתמשים בו עם: Navigation SDK ל-Android, Navigation SDK ל-iOS, Fleet Engine Service, Maps JavaScript API
Route Optimization API: טעויות נפוצות
- הבעיה: בקריאות REST לנקודת הקצה החוסמת
OptimizeTours, המועד האחרון שמוגדר כברירת מחדל (60 שניות) מבטל כל ערך שלtimeoutבגוף הבקשה שגדול מ-60 שניות. תיקון: מגדירים את הכותרתX-Server-Timeout(שניות, בלי הסיומת "s") כדי להאריך את המועד האחרון. ברירת המחדל בספריות הלקוח וב-gRPC היא 3,600 שניות. למידע נוסף, ראו /maps/documentation/route-optimization/timeouts. - הבעיה: הערכים של
timeoutושל המועד האחרון מוגבלים ל-1,800 שניות. הפתרון: מגדירים אתallowLargeDeadlineDespiteInterruptionRiskלערךtrueכדי לאפשר עד 3,600 שניות, ומקבלים את הסיכון הגבוה יותר לשגיאות שקשורות להפרעות. למידע נוסף, ראו /maps/documentation/route-optimization/timeouts. - הבעיה: בלי פרמטרים של עלות (לדוגמה,
costPerHourאוcostPerKilometer), הכלי לפתרון בעיות אופטימיזציה מתייחס לכל הפתרונות באופן שווה. הפתרון: מגדירים פרמטרים של עלות בכלי הרכב שמשקפים את עלויות העסק. מידע נוסף זמין בכתובת /maps/documentation/route-optimization/make-first-request. - הבעיה: בקשות שמאומתות באמצעות מפתח API נכשלות. כל בקשה צריכה אסימון OAuth. הפתרון: משתמשים באסימון OAuth עם ההיקף
https://www.googleapis.com/auth/cloud-platform, לדוגמה באמצעות Application Default Credentials או חשבון שירות. אפשר לקרוא מידע נוסף במאמר /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.
מה אפשר לעשות עם Route Optimization API
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- החזרת תוכנית משלוחים עם כמה עצירות, שעברה אופטימיזציה על סמך אילוצים ספציפיים של מסלול, עלות, משלוח ורכב.
- החזרת שעות ההתחלה והסיום של כל עצירה בתוכנית משלוחים שעברה אופטימיזציה.
- החזרת משך הנסיעה, העיכוב, ההפסקה וההמתנה בין כל עצירה בתוכנית משלוחים שעברה אופטימיזציה.
- החזרת מידע על העומס ברכב בכל עצירה בתוכנית משלוחים שעברה אופטימיזציה.
- החזרת מידע על העלות של כל משלוח בתוכנית משלוחים שעברה אופטימיזציה.
- החזרת קו פוליגוני מקודד למסלול בין כל עצירה בתוכנית משלוחים שעברה אופטימיזציה.
- החזרת אסימון של מסלול ניווט בין כל עצירה בתוכנית משלוחים שעברה אופטימיזציה.
- החזרת מדדים מצטברים של משלוחים, כלי רכב ועלויות לתוכנית משלוחים שעברה אופטימיזציה.
- מציינים את חלון הזמן של ההתחלה והסיום של תוכנית משלוחים עם כמה עצירות.
- ציינו את זמני ההתחלה והסיום של הזמינות והמיקומים של כל רכב בתוכנית משלוחים עם כמה עצירות.
- ציינו את עלויות הזמן של כל רכב בתוכנית משלוחים עם כמה עצירות.
- מציינים את הפרמטרים של מודל העלות לתוכנית משלוחים עם כמה עצירות.
- מגדירים אילוצים של זמני איסוף ומסירה לכל משלוח בתוכנית משלוחים עם כמה עצירות.
- הגדרת הקצאות של כלי רכב לתוכנית משלוחים עם כמה עצירות.
- מגדירים מגבלות עומס לכל רכב בתוכנית משלוחים עם כמה עצירות.
- מציינים אם להביא בחשבון מידע על מצב התנועה בזמן אמת בתוכנית משלוחים עם כמה עצירות.
- עיבוד באצווה של בקשה לאופטימיזציה של תוכנית משלוחים עם כמה עצירות, וכתיבת התגובה ב-Google Cloud Storage.
- לפני שאתם יוצאים למשלוחים, כדאי לשריין זמן לחנייה.
- תעדפו ביקורים במקומות קרובים כדי לבצע אותם ברצף.
- הימנעות מביצוע פניית פרסה במסלול רכב עם כמה עצירות. ניסיוני הערה: תכונה ניסיונית, בכפוף לתנאים ולהגבלות של גרסת טרום-GA.
- אופטימיזציה לפי יעדים מוגדרים מראש. ניסיוני הערה: תכונה ניסיונית, בכפוף לתנאים ולהגבלות של גרסת טרום-GA.
- קודם שולחים את המשלוחים הכבדים יותר. ניסיוני הערה: תכונה ניסיונית, בכפוף לתנאים ולהגבלות של גרסת טרום-GA.