Seçtiğiniz trafik tercihleri, rota ayrıntılarının doğruluğunu istek performansı ile dengeler. Bir istekte bulunduğunuzda, mümkün olan en doğru sonuçları mı döndürmenin yoksa sonuçları olabildiğince hızlı döndürmenin mi daha iyi olduğu konusunda karar vermek istersiniz. Routes API, yanıt verilerinin kalitesi ile yanıtın gecikmesini karşılaştırmanıza olanak tanıyan seçenekler sunar.
Trafik verilerinin düzeyini ayarlama
Routes API, rotaların hesaplanması için yönlendirme tercihlerini belirtmenizi sağlayan RoutingPreference (REST) ve RoutingPreference (gRPC) özellikleri sunar. Bu tercihler, trafik koşullarının, rota hesaplamasına dahil edilme düzeyi açısından farklılık gösterir. Her yönlendirme tercihi rota kalitesi, tahmini tahmini varış süresi ve yanıt gecikmesi açısından belirli ölçüde farklı sonuçlar üretir.
Trafik koşulları, trafik akış hızını tanımlar. Örneğin:
- Trafik yoğunluğu olmadığında, trafik koşulları normal kabul edilir ve trafik kesintisiz olarak normal hızda akar.
- Yoğun saatlere yaklaşırken trafik yoğunluğu artar. Bu da trafiğin yavaşlayarak hafif ve orta derece trafik koşullarına neden olur.
- Tampondan tamper arasındaki trafikte, akış hızı durup yoğun trafik koşullarına neden olur.
Trafik bilgisi yok
TRAFFIC_UNAWARE
yönlendirme tercihini belirlediğinizde, rotalar mevcut trafik koşulları dikkate alınmadan hesaplanır. Bu yönlendirme tercihi en düşük yanıt gecikmesini sağlar (yanıtlar en hızlı şekilde döndürülür).
TRAFFIC_UNAWARE
, varsayılan ayardır.
Yanıtta:
TVS,
duration
yanıt özelliğinde yer alır.duration
vestaticDuration
yanıt özellikleri aynı değeri içerir.
Yanıtların en hızlı şekilde döndürülmesini istiyorsanız ve yaklaşık yönlendirme ayrıntıları yeterince iyiyse bu yönlendirme tercihini kullanın.
Trafiğe duyarlı
TRAFFIC_AWARE
yönlendirme tercihini belirlediğinizde rotalar, mevcut trafik koşulları dikkate alınarak hesaplanır. Sonuç olarak, rota ve rota ayrıntıları gerçek dünya koşullarını daha doğru yansıtıyor. Veri kalitesindeki bu artış yanıt gecikmesinden kaynaklandığından, gecikmenin büyük bir kısmını azaltmak için performans optimizasyonları uygulanır.
Yanıtta:
Gerçek zamanlı trafiği dikkate alan TVS,
duration
yanıt özelliğinde yer alır.staticDuration
yanıtı özelliği, trafik koşulları dikkate alınmadan rotadaki seyahat süresini içerir.
TRAFFIC_UNAWARE
seçeneğinden daha doğru yönlendirme ayrıntıları istiyorsanız ve yanıtların gecikmede orta düzeyde bir artışla döndürülmesinin sizin için bir sakıncası yoksa bu yönlendirme tercihini kullanın.
Trafiğe duyarlı optimum
TRAFFIC_AWARE_OPTIMAL
yönlendirme tercihini belirlediğinizde, rotalar mevcut trafik koşullarına göre hesaplanır ancak performans optimizasyonu uygulanmaz. Bu modda, sunucu en uygun rotayı bulmak için yol ağında daha kapsamlı bir arama gerçekleştirir.
TRAFFIC_AWARE_OPTIMAL
yönlendirme tercihi, maps.google.com ve Google Haritalar mobil uygulaması tarafından kullanılan moda eşdeğerdir.
Bu seçenek İşlem Rota Matrisi ile kullanıldığında, bir istekteki öğe sayısı (kaynak sayısı × hedef sayısı) 100'ü aşamaz. İşlem Rota Matrisi sınırları hakkında daha fazla bilgi için Rota matrisi hesaplama bölümünü inceleyin.
Yanıtta:
Gerçek zamanlı trafiği dikkate alan TVS,
duration
yanıt özelliğinde yer alır.staticDuration
yanıtı özelliği, trafik koşulları dikkate alınmadan rotadaki seyahat süresini içerir.
Bu yönlendirme tercihi en yüksek yanıt gecikmesini sağlar (yani yanıtlar en uzun gecikmeyle geri döner). Yanıtların ne kadar sürdüğüne bakılmaksızın, en yüksek kalitedeki sonuçları istediğinizde bu yönlendirme tercihini kullanın.
Kalkış saatini ayarlamanın etkisi
İsteğe bağlı olarak bir seyahatin kalkış saatini ayarlamak için departureTime
özelliğini kullanabilirsiniz. departureTime
özelliğini ayarlamazsanız varsayılan olarak istekte bulunduğunuz zaman kullanılır.
Rota ve süre seçimi yol ağına ve ortalama süreden bağımsız trafik koşullarına dayalı olduğundan
TRAFFIC_UNAWARE
içindepartureTime
ayarlayamazsınız.Canlı trafik koşullarını dikkate alan
TRAFFIC_AWARE
veTRAFFIC_AWARE_OPTIMAL
içindepartureTime
yaklaştıkça canlı trafik daha önemli hale gelir. Kalkış saatini ne kadar uzak bir tarihe ayarlarsanız, geçmiş trafik koşulları o kadar dikkate alınır.
Örnek ayar yönlendirme tercihi
Aşağıdaki JSON kodu, bir istek mesajı varlığı gövdesinde yönlendirme tercihinin nasıl ayarlanacağını gösterir.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }
Çoklu çizgilerde trafiği yapılandırma
Routes API, trafiğe duyarlı bir çoklu çizgi boyunca trafik koşulları hakkında bilgi istemenize olanak tanır. Daha fazla bilgi için Çoklu çizgi isteme bölümüne bakın.