Seçtiğiniz trafik tercihleri, rota ayrıntılarının doğruluğunu istek performansıyla dengeler. Bir istek gönderirken mümkün olan en doğru sonuçları döndürmenin mi yoksa sonuçları mümkün olduğunca hızlı döndürmenin mi daha iyi olduğunu değerlendirmeniz gerekir. Routes API, yanıt verilerinin kalitesini ve yanıtın gecikmesini kontrol etmenize olanak tanıyan seçenekler sunar.
Trafik verilerinin düzeyini ayarlama
Rotalar API'si, rotaları hesaplamak için yönlendirme tercihlerini belirtmenize olanak tanıyan RoutingPreference (REST) ve RoutingPreference (gRPC) sağlar. Bu tercihler, rota hesaplamasında trafik koşullarını ne ölçüde hesaba kattıkları açısından farklılık gösterir. Her yönlendirme tercihi, rota kalitesi, tahmini varış zamanı ve yanıt gecikmesi açısından bir derece farklı sonuçlar verir.
Trafik koşulları, trafik akış hızını karakterize eder. Örneğin:
- Trafik sıkışıklığı olmadığında trafik koşulları normal kabul edilir ve trafik normal, engelsiz hızda akar.
- Yoğun saatlere yaklaşıldığında trafik yoğunluğu artar. Bu da trafiğin yavaşlamasına neden olur ve hafif ile orta düzeyde trafik koşulları oluşturur.
- Trafik sıkışık olduğunda akış hızı yavaşlar ve yoğun trafik koşulları oluşur.
Trafik bilgisi yok
TRAFFIC_UNAWARE
yönlendirme tercihini ayarlarken 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:
ETA,
duration
yanıt özelliğinde yer alır.duration
vestaticDuration
yanıt özellikleri aynı değeri içeriyor.
Yanıtların en hızlı şekilde döndürülmesini istediğiniz ve yaklaşık yönlendirme ayrıntılarının yeterli olduğu durumlarda bu yönlendirme tercihini kullanın.
Trafik bilinci
TRAFFIC_AWARE
yönlendirme tercihini ayarlarken 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ır. Veri kalitesindeki bu artış, yanıt gecikmesi pahasına gerçekleştiğinden gecikmenin büyük bir kısmını azaltmak için performans optimizasyonları uygulanır.
Yanıtta:
Gerçek zamanlı trafiği dikkate alan ETA,
duration
yanıt mülkünde yer alır.staticDuration
yanıt mülkü, trafik koşullarını dikkate almadan rotadaki seyahat süresini içerir.
TRAFFIC_UNAWARE
'ten daha doğru yönlendirme ayrıntıları istediğinizde ancak yanıtların gecikmede orta düzeyde bir artışla döndürülmesinin sakıncası olmadığında bu yönlendirme tercihini kullanın.
Trafik bilinciyle optimize edilmiş
TRAFFIC_AWARE_OPTIMAL
Yönlendirme tercihini belirlediğinizde, mevcut trafik koşulları dikkate alınarak rotalar hesaplanır ancak performans optimizasyonu uygulanmaz. Bu modda sunucu, en uygun rotayı bulmak için yol ağında daha kapsamlı bir arama yapar.
TRAFFIC_AWARE_OPTIMAL
rota tercihi, maps.google.com ve Google Haritalar mobil uygulaması tarafından kullanılan modla eşdeğerdir.
Bu seçenek, rota matrisini hesaplama ile birlikte kullanıldığında bir istekteki öğe sayısı (başlangıç sayısı × hedef sayısı) 100'ü aşamaz. Compute rota matrisi sınırları hakkında daha fazla bilgi için Rota matrisi hesaplama başlıklı makaleyi inceleyin.
Yanıtta:
Gerçek zamanlı trafiği dikkate alan ETA,
duration
yanıt mülkünde yer alır.staticDuration
yanıt mülkü, trafik koşullarını dikkate almadan rotadaki seyahat süresini içerir.
Bu yönlendirme tercihi, en yüksek yanıt gecikmesini sağlar (yani yanıtlar en uzun gecikmede döndürülür). Yanıtların ne kadar sürdüğüne bakılmaksızın en yüksek kaliteli sonuçları elde etmek istediğinizde bu yönlendirme tercihini kullanın.
Kalkış saatini ayarlama
İsteğe bağlı olarak departureTime
mülkünü kullanarak bir seyahatin kalkış saatini ayarlayabilirsiniz. departureTime
mülkünü ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır.
Rota ve süre seçimi, yol ağına ve zamana bağlı olmayan ortalama trafik koşullarına bağlı olduğundan
TRAFFIC_UNAWARE
içindepartureTime
değerini ayarlayamazsınız.Canlı trafik koşullarını dikkate alan
TRAFFIC_AWARE
veTRAFFIC_AWARE_OPTIMAL
içindepartureTime
'nin şimdiye ne kadar yakın olduğu canlı trafiğin önemini belirler. Kalkış saatini ne kadar ileriye ayarlarsanız geçmiş trafik koşulları o kadar fazla dikkate alınır.
Yönlendirme tercihi ayarlama örneği
Aşağıdaki JSON kodunda, istek mesajı öğe gövdesinde yönlendirme tercihinin nasıl ayarlanacağı gösterilmektedir.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }
Poli çizgilerdeki trafiği yapılandırma
Routes API, trafik bilincine sahip bir çok çizgi boyunca trafik koşulları hakkında bilgi istemenize olanak tanır. Daha fazla bilgi için Çoklu çizgi isteğinde bulunma başlıklı makaleyi inceleyin.