מדריך מקוצר ל-Route Optimization API

‫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: הגדרה

חבילות רשמיות של 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: טעויות נפוצות

  • הבעיה: בקריאות 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

במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.