Büyük araç rotalandırma, fiziksel boyutları, ağırlığı ve römork sayısını belirterek filo rotalarını büyük araçlar için optimize etmenize olanak tanıyan bir özellikler grubudur. API, bu özellikleri kullanarak kısıtlanmış yollardan, alçak köprülerden veya ağırlık sınırlı rotalardan kaçınan uygun rotaları hesaplar.
Büyük araç rotalandırma ile ağır ve büyük araçların filo lojistiğiyle ilgili sorunları çözebilirsiniz. Örneğin:
- Yoldaki tehlikelerden kaçının: Araçları alçak tavan boşluklarından, ağırlık kısıtlaması olan yollardan ve diğer fiziksel tehlikelerden uzaklaştıran rota planları oluşturun.
- Ayrıntılı araç bilgileri belirtin: Kesin boyutları, toplam ağırlığı, aks sayısını ve römork yapılandırmalarını filo genelindeki rota planlarına dahil edin.
- Filo genelinde planlamayı iyileştirme: Tüm atamaların fiziksel yol kısıtlamalarına uygun olmasını sağlarken tüm kamyon filonuz için verimli rota planları oluşturun.
Sınırlamalar
Başlamadan önce aşağıdaki sınırlamaları ve koşulları bilmeniz gerekir.
- Coğrafi kullanılabilirlik: Büyük araç yönlendirme yalnızca ABD'nin bitişik 48 eyaletinde kullanılabilir.
- Sürücü tavsiyesi ve güvenlik: Sürücüler, güvenli veya yasal olmak için yalnızca bu API tarafından döndürülen rotalara güvenmemelidir. Rotaların araca uygun olduğu garanti edilmez ve bu rotaları takip etmek sürücüleri alçak köprüler veya büyük araçların yasak olduğu yollar gibi tehlikelere maruz bırakabilir.
- En iyi çaba rotaları: Bazı durumlarda API, seyahat kısıtlamalarına tam olarak uyan bir rota bulamaz. Bunun yerine, kısıtlanmış alanlardan geçmeye devam edebilecek bir "en iyi çaba" rotası döndürür.
- Desteklenmeyen özellikler: Büyük araç rotası, aşağıdakileri desteklemez:
- Kamyon geçiş ücretleri
- Hız sınırları
- Radyoaktif tehlikeli maddeler için rota oluşturma
- Faturalandırma: Google, isteklerin büyük araç rotalandırma özelliklerini yapılandırıp yapılandırmadığına bakılmaksızın tüm
optimizeToursisteklerini aynı şekilde faturalandırır. - Uzun mesafeli rotalar: 500 kilometre veya daha uzun mesafeli kamyon rotaları, daha kısa rotalara kıyasla daha fazla hesaplama süresi gerektirir ve daha düşük kaliteli rota verileri döndürebilir. Rota kalitesini korumak için gönderiler, aracın başlangıç konumları ve aracın bitiş konumları arasındaki mesafeleri sınırlayın. Uzun rotalara ihtiyacınız varsa
DEADLINE_EXCEEDEDhatalarının olasılığını azaltmak için istek son tarihlerini uzatın.
Özellikler
Büyük araç yönlendirme özelliklerini kullanmak için fiziksel boyutlarını belirterek bir araç yapılandırmanız ve yönlendirme modunu kamyon olarak ayarlamanız gerekir.
Aşağıdaki tabloda, büyük araç yönlendirmesini yapılandırmak için kullanılan üst düzey özellikler listelenmiştir:
| Mülk | Tür | Gereksinim | Açıklama |
|---|---|---|---|
travelMode |
dize | Zorunlu | Aracın seyahat modunu belirtir. Büyük araç rotalandırma özelliklerini etkinleştirmek için bu değeri TRUCK olarak ayarlayın. |
routeModifiers |
nesne | Zorunlu | vehicleInfo dahil olmak üzere rotaya özgü yapılandırmaları içerir. |
vehicleInfo
vehicleInfo nesnesi, aracın fiziksel özelliklerini içerir. Bu nesneyi routeModifiers özelliği içinde tanımlayın.
vehicleInfo nesnesini sağlamanız gerekir. travelMode öğesini TRUCK olarak ayarlarsanız.
Aşağıdaki tabloda vehicleInfo nesnesinde bulunan özellikler listelenmektedir:
| Mülk | Tür | Gereksinim | Açıklama |
|---|---|---|---|
totalHeightMm |
tam sayı | Zorunlu | Aracın toplam yüksekliğini milimetre cinsinden belirtir. Bu değer, pozitif bir tam sayı olmalıdır. |
totalWidthMm |
tam sayı | Zorunlu | Aracın toplam genişliğini milimetre cinsinden belirtir. Bu değer, pozitif bir tam sayı olmalıdır. |
totalWeightKg |
tam sayı | Zorunlu | Aracın toplam ağırlığını kilogram cinsinden belirtir. Bu değer, pozitif bir tam sayı olmalıdır. |
totalLengthMm |
tam sayı | Zorunlu | Aracın toplam uzunluğunu milimetre cinsinden belirtir. Bu değer, pozitif bir tam sayı olmalıdır. |
trailerInfo |
dizi | İsteğe bağlı | Her bir fragmanın uzunluğunu milimetre cinsinden belirtmek için lengthMm özelliğini içeren bir fragman spesifikasyonları dizisi içerir. |
totalAxleCount |
tam sayı | Zorunlu | Araçtaki toplam aks sayısını belirtir. Bu değer, 2'ye eşit veya 2'den büyük bir tam sayı olmalıdır. |
Örnekler
Bu bölümde iki tür örnek ele alınmaktadır:
- Büyük araç rotalandırmasının yapısını gösteren kod örneği
- Özelliği içeren bir istek örneği.
Kod örneği
Aşağıdaki örnekte, büyük araç rotası oluşturma için kullanılan özelliklerin yapısı gösterilmektedir:
"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 } } } ]
İstek örneği
Aşağıdaki örnekte, büyük araç rotalandırması içeren temel bir optimizeTours isteğinin yapısı gösterilmektedir:
{ "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 } ] } }