Seçtiğiniz trafik tercihleri, rota ayrıntılarının doğruluğunu istek performansıyla dengeler. Bir istekte bulunduğunuzda, mümkün olan en doğru sonuçları döndürmenin mi yoksa sonuçları olabildiğince hızlı bir şekilde döndürmenin mi daha iyi olduğunu değerlendirmeniz gerekir. Routes API, yanıt verilerinin kalitesini ve yanıtın gecikmesini kontrol etmenizi sağlayan seçenekler sunar.
Trafik verilerinin düzeyini ayarlama
Routes API, rotaları hesaplamak için yönlendirme tercihlerini belirtmenize olanak tanıyan RoutingPreference (REST) ve RoutingPreference (gRPC) özelliklerini sunar. Bu tercihler, rota hesaplamasında trafik koşullarını hesaba katmak bakımından farklılık gösterir. Her yönlendirme tercihi; rota kalitesi, tahmini TVS ve yanıt gecikmesi açısından belirli ölçüde farklı sonuçlar üretir.
Trafik koşulları, trafik akış hızını gösterir. Örneğin:
- Trafik sıkışıklık olmadığında trafik koşulları normal olarak kabul edilir ve trafik akışı, normal kesintisiz hızda gerçekleşir.
- Yoğun kullanım saatlerine yaklaşırken trafik yoğunluğu artar. Bu da trafiğin yavaşlamasına ve hafif ile orta arası trafik koşullarına neden olur.
- Bumper'dan bumper'a olan trafikte akış hızı durdurularak yoğun trafik koşullarına neden olur.
Trafik farkında değil
TRAFFIC_UNAWARE
yönlendirme tercihini ayarladığınızda 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:
GMR,
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 istediğinizde ve yaklaşık yönlendirme ayrıntıları yeterince iyi olduğunda bu yönlendirme tercihini kullanın.
Trafiğe duyarlı
TRAFFIC_AWARE
yönlendirme tercihini ayarladığınızda 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 şekilde yansıtır. Veri kalitesindeki bu artış yanıt gecikmesi pahasına yapıldığı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 rotada seyahatin süresini içerir.
TRAFFIC_UNAWARE
ürününden daha doğru yönlendirme ayrıntıları istediğinizde bu yönlendirme tercihini kullanın. Bununla birlikte, yanıtların gecikmede orta düzeyde artışla döndürülmesi sizin için sorun yaratmaz.
Trafiğe duyarlı optimum
TRAFFIC_AWARE_OPTIMAL
yönlendirme tercihini ayarladığınızda rotalar mevcut trafik koşulları dikkate alınarak hesaplanır ancak performans optimizasyonu uygulanmaz. Bu modda sunucu, en iyi rotayı bulmak için yol ağında daha kapsamlı bir arama yapar.
TRAFFIC_AWARE_OPTIMAL
yönlendirme tercihi, maps.google.com ve Google Haritalar mobil uygulaması tarafından kullanılan modla eşdeğerdir.
Bu seçenek Compute Rota Matrisi ile birlikte 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üne bakın.
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 rotada seyahatin süresini içerir.
Bu yönlendirme tercihi en yüksek yanıt gecikmesini sağlar (yani yanıtlar en uzun gecikmeyle döndürülür). Yanıtların ne kadar zaman aldığından bağımsız olarak en yüksek kalitede sonuçlar almak istediğinizde bu yönlendirme tercihini kullanın.
Kalkış saatini ayarlamanın etkisi
İsteğe bağlı olarak, bir gezinin kalkış saatini ayarlamak için departureTime
özelliğini kullanabilirsiniz. departureTime
özelliğini ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır.
Rota ve süre seçimi yol ağına ve zamandan bağımsız ortalama trafik koşullarına dayalı olduğundan
TRAFFIC_UNAWARE
içindepartureTime
değerini ayarlayamazsınız.Canlı trafik koşullarının dikkate alındığı
TRAFFIC_AWARE
veTRAFFIC_AWARE_OPTIMAL
için canlı trafik,departureTime
ne kadar yakın olursa o kadar önemli hale gelir. Kalkış saatini ileriye ne kadar uzaklaştırırsanız geçmiş trafik koşulları da o kadar göz önünde bulundurulur.
Yönlendirme tercihi ayarı örneği
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ı çoklu çizgi üzerinden trafik koşulları hakkında bilgi istemenize olanak tanır. Daha fazla bilgi için Çoklu çizgi isteme bölümüne göz atın.