ניתוב כלי רכב גדולים הוא קבוצה של מאפיינים שמאפשרים לכם לבצע אופטימיזציה של מסלולי צי רכב לכלי רכב גדולים, על ידי ציון המידות הפיזיות, המשקל ומספר הנגררים. ה-API משתמש במאפיינים האלה כדי לחשב מסלולים אפשריים שבהם נמנעים מכבישים עם הגבלות, מגשרים נמוכים או ממסלולים עם הגבלות משקל.
בעזרת תכנון מסלולים לרכבים גדולים, תוכלו לפתור אתגרים לוגיסטיים של ציי רכב עבור רכבים כבדים וגדולים, למשל:
- הימנעות מסכנות בדרכים: יצירת תוכניות מסלול שמכוונות את כלי הרכב כך שיעקפו גשרים עם מרווח גובה נמוך, כבישים עם הגבלת משקל וסכנות פיזיות אחרות.
- ציון פרטים על כלי הרכב: אפשר לשלב תוכניות נסיעה לכל צי הרכב עם מידות מדויקות, משקל כולל, מספר סרנים והגדרות של נגררים.
- שיפור התכנון של כל צי המשאיות: יצירת תוכניות מסלולים יעילות לכל צי המשאיות, תוך הקפדה על כך שכל המשימות יתאימו למגבלות הפיזיות של הכבישים.
מגבלות
לפני שמתחילים, חשוב להכיר את המגבלות והדרישות הבאות.
- זמינות גיאוגרפית: ניתוב של כלי רכב גדולים זמין רק ב-48 המדינות הרציפות בארצות הברית.
- המלצות לנהגים ובטיחות: הנהגים לא יכולים להסתמך רק על המסלולים שמוחזרים על ידי ה-API הזה כדי להבטיח בטיחות או חוקיות. אין ערובה לכך שהמסלולים יתאימו לרכב, וייתכן שהנהגים ייחשפו לסכנות כמו גשרים נמוכים או כבישים שאסור לכלי רכב גדולים לנסוע בהם.
- מסלולים במאמץ מרבי: במקרים מסוימים, ה-API לא יכול למצוא מסלול שעומד באופן מלא בהגבלות הנסיעה. במקום זאת, המערכת מחזירה מסלול 'במאמץ הכי טוב' שיכול להיות שהוא עדיין עובר באזורים מוגבלים.
- תכונות שלא נתמכות: אי אפשר להשתמש בתכונות הבאות כשמגדירים ניווט לרכבים גדולים:
- מחירי אגרה למשאיות
- מגבלות מהירות
- ניתוב של חומרים מסוכנים רדיואקטיביים
- חיוב: Google מחייבת את כל הבקשות ל-
optimizeToursבאופן אחיד, בלי קשר לשאלה אם הבקשות מגדירות מאפיינים של ניתוב כלי רכב גדולים. - מסלולים ארוכים: מסלולים ארוכים למשאיות באורך של 500 ק"מ או יותר דורשים יותר זמן חישוב ממסלולים קצרים יותר, ויכול להיות שהם יחזירו נתוני מסלול באיכות נמוכה יותר. כדי לשמור על איכות המסלול, מומלץ להגביל את המרחקים בין המשלוחים, בין נקודות ההתחלה של כלי הרכב ובין נקודות הסיום של כלי הרכב. אם אתם צריכים מסלולים ארוכים, כדאי להאריך את המועדים האחרונים של הבקשות כדי להקטין את הסיכוי לשגיאות
DEADLINE_EXCEEDED.
מאפיינים
כדי להשתמש במאפייני ניתוב לרכבים גדולים, צריך להגדיר רכב עם המידות הפיזיות שלו ולהגדיר את מצב הניתוב שלו למשאית.
בטבלה הבאה מפורטים מאפיינים ברמה העליונה להגדרת ניתוב של רכבים גדולים:
| נכס | סוג | דרישה | תיאור |
|---|---|---|---|
travelMode |
מחרוזת | חובה | מציין את אמצעי התחבורה של הרכב. כדי להפעיל את מאפייני הניתוב של כלי רכב גדולים, צריך להגדיר את הערך הזה ל-TRUCK. |
routeModifiers |
אובייקט | חובה | מכיל הגדרות ספציפיות לנתיב, כולל vehicleInfo. |
vehicleInfo
אובייקט vehicleInfo מכיל את המפרט הפיזי של הרכב. מגדירים את האובייקט הזה במאפיין routeModifiers.
חובה לספק את האובייקט vehicleInfo אם מגדירים את travelMode כ-TRUCK.
בטבלה הבאה מפורטים המאפיינים שזמינים באובייקט vehicleInfo:
| נכס | סוג | דרישה | תיאור |
|---|---|---|---|
totalHeightMm |
מספר שלם | חובה | הגובה הכולל של הרכב במילימטרים. הערך חייב להיות מספר שלם חיובי. |
totalWidthMm |
מספר שלם | חובה | מציין את הרוחב הכולל של הרכב במילימטרים. הערך חייב להיות מספר שלם חיובי. |
totalWeightKg |
מספר שלם | חובה | מציין את המשקל הכולל של הרכב בקילוגרמים. הערך חייב להיות מספר שלם חיובי. |
totalLengthMm |
מספר שלם | חובה | מציין את האורך הכולל של הרכב במילימטרים. הערך חייב להיות מספר שלם חיובי. |
trailerInfo |
מערך | אופציונלי | מכיל מערך של מפרטי טריילרים, כולל המאפיין lengthMm לציון האורך של כל טריילר במילימטרים. |
totalAxleCount |
מספר שלם | חובה | מציין את המספר הכולל של הסרנים ברכב. הערך הזה חייב להיות מספר שלם שגדול מ-2 או שווה לו. |
דוגמאות
בקטע הזה יש שני סוגים של דוגמאות:
- דוגמת קוד שממחישה את המבנה של תכנון מסלול כלי רכב גדולים.
- דוגמה לבקשה שכוללת את התכונה.
דוגמת קוד
בדוגמה הבאה מוצג המבנה של המאפיינים שמשמשים לניתוב של כלי רכב גדולים:
"vehicles": [ { "travelMode": "TRUCK", "routeModifiers": { "vehicleInfo": { "totalHeightMm": TOTAL_HEIGHT_MM, "totalWidthMm": TOTAL_WIDTH_MM, "totalWeightKg": TOTAL_WEIGHT_KG, "totalLengthMm": TOTAL_LENGTH_MM, "trailerInfo": [ { "lengthMm": TRAILER_LENGTH_MM } ], "totalAxleCount": TOTAL_AXLE_COUNT } } } ]
דוגמה לבקשה
בדוגמה הבאה מוצג המבנה של בקשת optimizeTours בסיסית שמשלבת ניתוב של כלי רכב גדולים:
{ "model": { "shipments": [ { "pickups": [ { "arrivalLocation": { "latitude": 40.953523, "longitude": -72.2277846 } } ], "deliveries": [ { "arrivalLocation": { "latitude": 40.9546673, "longitude": -72.2580151 } } ] } ], "vehicles": [ { "travelMode": "TRUCK", "routeModifiers": { "vehicleInfo": { "totalHeightMm": 4000, "totalWidthMm": 2500, "totalWeightKg": 9000, "totalLengthMm": 20000, "trailerInfo": [ { "lengthMm": 15000 } ], "totalAxleCount": 5 } }, "costPerKilometer": 1.0 } ] } }