Route Optimization API, sağladığınız hedeflere ve kısıtlamalara (ör. zaman aralıkları, araç kapasitesi, sürücü çalışma saatleri ve maliyetler) göre optimizasyon yaparak bir araç filosuna görevler ve rotalar atar. REST, gRPC veya istemci kitaplıkları aracılığıyla çağrılan bu API; ziyaret sıralarını, sevkiyat atamalarını, tahmini süreleri ve rota metriklerini döndürür.
Route Optimization API: Önemli bilgiler
- Ürün: Route Optimization API
- Diğer adları: GMPRO
- Kategori: Rotalar
- Platform: Web hizmeti (REST)
- Çalıştığı yer: Sunucu (arka uç kodu)
- Lansman aşaması: GA
- Yaşam döngüsü: Etkin
- Genel bakış: Route Optimization API'ye genel bakış
Route Optimization API: Ne zaman kullanılır?
Route Optimization API'yi şu durumlarda kullanın:
- Zaman aralıkları, araç kapasitesi, sürücü çalışma saatleri ve maliyetleri dikkate alarak gönderileri veya görevleri birden fazla araca atamanız gerekir.
- Birden fazla teslim alma, teslimat veya randevusu olan bir araç için en iyi durak sırasına ihtiyacınız vardır.
injectedFirstSolutionRoutesveyainjectedSolutionConstraintkullanarak yeni siparişler (ör. isteğe bağlı sevkiyat) için etkin rotaları yeniden optimize etmeniz gerekir.- Navigation SDK'ya iletilecek optimize edilmiş bir planın her ayağı için rota jetonlarına ihtiyacınız vardır.
Route Optimization API'yi şu durumlarda kullanmayın:
- Sürücülerin planı nasıl uyguladığını canlı olarak takip etmeniz gerekir. API, gerçek zamanlı araç rotalarını değil, planlanan çoklu çizgileri döndürür. Bunun yerine Fleet Engine hizmetini kullanın.
- Sürücüler için optimize edilmiş rota boyunca uygulama içi adım adım rehberliğe ihtiyacınız vardır. Bunun yerine Android için Navigasyon SDK'sını kullanın.
- iOS'te sürücüler için optimize edilmiş rota boyunca uygulama içi adım adım rehberliğe ihtiyacınız var. Bunun yerine iOS için Navigasyon SDK'sını kullanın.
Route Optimization API: kurulum
- Etkinleştirilecek hizmet:
routeoptimization.googleapis.com - Kimlik doğrulama: OAuth 2.0, hizmet hesabı
- Başlangıç: Route Optimization API'yi ayarlama
- Referans: Route Optimization API referansı
- Fiyatlandırma: Route Optimization API kullanımı ve faturalandırması
- Politikalar: Route Optimization API politikaları
- Sürüm notları: Route Optimization API sürüm notları
Resmi Route Optimization API paketleri:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Android için Navigation SDK, iOS için Navigation SDK, Fleet Engine hizmeti, Maps JavaScript API
Route Optimization API: Sık yapılan hatalar
- Sorun: Engelleme
OptimizeToursuç noktasına yapılan REST çağrılarında, varsayılan 60 saniyelik son tarih, 60 saniyeden uzun olan tüm istek içeriğitimeoutdeğerlerini geçersiz kılar. Düzeltme: Son tarihi uzatmak içinX-Server-Timeoutüstbilgisini (saniye cinsinden, "s" son eki olmadan) ayarlayın. İstemci kitaplıkları ve gRPC varsayılan olarak 3.600 saniyedir. /maps/documentation/route-optimization/timeouts sayfasına bakın. - Sorun:
timeoutve son tarih değerleri 1.800 saniyeyle sınırlıdır. Düzeltme:allowLargeDeadlineDespiteInterruptionRiskdeğerinitrueolarak ayarlayarak 3.600 saniyeye kadar izin verin ve daha yüksek kesinti hatası riskini kabul edin. /maps/documentation/route-optimization/timeouts sayfasına bakın. - Sorun: Maliyet parametreleri (ör.
costPerHourveyacostPerKilometer) olmadan, optimize edici tüm çözümleri eşit olarak değerlendirir. Düzeltme: Araçlarda işletme maliyetlerinizi yansıtan maliyet parametreleri tanımlayın. /maps/documentation/route-optimization/make-first-request adresini ziyaret edin. - Sorun: API anahtarıyla kimliği doğrulanan istekler başarısız oluyor; her isteğin bir OAuth jetonuna ihtiyacı var. Düzeltme:
https://www.googleapis.com/auth/cloud-platformkapsamına sahip bir OAuth jetonu kullanın (ör. Uygulama Varsayılan Kimlik Bilgileri veya hizmet hesabı aracılığıyla). /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token adresini ziyaret edin.
Route Optimization API ile yapabilecekleriniz
Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.
- Belirtilen rota, maliyet, gönderi ve araç kısıtlamalarına göre optimize edilmiş, çok duraklı bir teslimat planı döndürür.
- Optimize edilmiş bir teslimat planındaki her durak için başlangıç ve bitiş zamanlarını döndürme
- Optimize edilmiş bir teslimat planındaki her durak arasındaki seyahat, gecikme, mola ve bekleme sürelerini döndürür.
- Optimize edilmiş bir teslimat planındaki her durakta araç yükü bilgilerini döndürün.
- Optimize edilmiş bir teslimat planındaki her gönderim için maliyet bilgilerini döndürür.
- Optimize edilmiş bir teslimat planındaki her durak arasındaki rota için kodlanmış bir çoklu çizgi döndürün.
- Optimize edilmiş bir teslimat planındaki her durak arasındaki rota için bir navigasyon rotası jetonu döndürün.
- Optimize edilmiş bir teslimat planı için toplu gönderi, araç ve maliyet metriklerini döndürme
- Çok duraklı bir teslimat planı için başlangıç ve bitiş zaman aralığını belirtin.
- Çok duraklı teslimat planındaki her araç için başlangıç ve bitiş zamanı müsaitlik durumunu ve konumlarını belirtin.
- Çok duraklı teslimat planındaki her araç için araç zaman maliyetlerini belirtin.
- Çok duraklı bir teslimat planı için maliyet modeli parametrelerini belirtme
- Çok duraklı bir teslimat planındaki her gönderi için teslim alma ve teslimat süresi kısıtlamalarını belirtin.
- Birden fazla durak içeren bir teslimat planı için araç atamalarını belirtme
- Çok duraklı bir teslimat planındaki her araç için yük sınırlarını belirtin.
- Birden fazla duraklı teslimat planı için canlı trafik bilgilerinin dikkate alınıp alınmayacağını belirtin.
- Çok duraklı teslimat planı optimizasyon isteğini toplu olarak işleme ve yanıtı Google Cloud Storage'a yazma
- Teslimat yapmadan önce park yeri için zaman ayırın.
- Yakınlardaki ziyaretlere öncelik vererek bunları arka arkaya yapın.
- Çok duraklı bir araç rotasında U dönüşü yapmaktan kaçının. Deneysel Not: Deneysel özellik; GKST öncesi şartlara ve sınırlamalara tabidir.
- Önceden tanımlanmış hedefler için optimizasyon yapın. Deneysel Not: Deneysel özellik; GKST öncesi şartlara ve sınırlamalara tabidir.
- Önce daha ağır gönderileri teslim edin. Deneysel Not: Deneysel özellik; GKST öncesi şartlara ve sınırlamalara tabidir.