Büyük araç rotası, fiziksel boyutları, ağırlığı ve römork sayıları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ırlaması olan rotalardan kaçınan uygun rotaları hesaplar.
Büyük araç rotalandırma ile ağır ve büyük araçlar için filo lojistiğiyle ilgili sorunları çözebilirsiniz. Örneğin:
- Yoldaki tehlikelerden kaçının: Araçları alçak tavanlı geçitlerden, ağırlık kısıtlaması olan yollardan ve diğer fiziksel tehlikelerden uzaklaştıran rota planları oluşturun.
- Ayrıntılı araç bilgilerini belirtme: Filo genelindeki rota planlarına tam boyutları, toplam ağırlığı, aks sayılarını ve römork yapılandırmalarını 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.
- Adım adım navigasyonu etkinleştirme: Optimize edilmiş filo rota planlaması için rota jetonları oluşturun ve sürücülere büyük araçlara özel navigasyonla yol göstermek üzere bunları Navigation SDK'sına iletin.
Sınırlamalar
Başlamadan önce aşağıdaki sınırlamaları ve koşulları göz önünde bulundurmanız 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 olması için yalnızca bu API tarafından döndürülen rotalara güvenmemelidir. Rotaların araç için 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 tahmine göre rotalar: Bazı durumlarda API, seyahat kısıtlamalarına tam olarak uyan bir rota bulamaz. Bunun yerine, kısıtlanmış alanlardan geçebilecek "en iyi" rotayı 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 eşit ş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, araç başlangıç konumları ve araç 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 artırın.
Özellikler
Büyük araç yönlendirme özelliklerini kullanmak için bir aracı fiziksel boyutlarıyla 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ç yönlendirme ö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 kullanılabilen özellikler listelenmiştir:
| 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ı 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ç rotası planlamayı 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 } ] } }
Sırada ne var?
- Adım adım rota sağlama: Her geçiş için döndürülen
routeTokendeğerini Android veya iOS için Navigasyon SDK'sına nasıl ileteceğinizi öğrenin. - Geçiş polylineleri ve rota jetonları oluşturma:
populateTransitionPolylineskullanarak rota jetonları istemeyi öğrenin. Geçiş polylineleri ve rota jetonları bölümünde bu konuyla ilgili bilgiler yer almaktadır. - API referansı:
optimizeToursreferansındaki alanların tam listesini görüntüleyin.