Seçtiğiniz trafik tercihleri, rota ayrıntılarının doğruluğunu iki yoldan biriyle istek performansıyla dengeler:
Trafik bilinir: Mümkün olan en doğru sonuçları döndürme (daha yüksek gecikme).
Trafik bilgisi yok: Sonuçları mümkün olduğunca hızlı döndürme (en düşük gecikme).
Bir istekte bulunurken 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ğerlendirin. Routes API, yanıt verilerinin kalitesini yanıtın gecikmesine göre kontrol etmenize olanak tanıyan seçenekler sunar.
Trafik düzeyini ayarlama
Rotalar API'si, rotaları hesaplamak için yönlendirme tercihlerini belirtmenize olanak tanıyan RoutingPreference (REST) ve RoutingPreference (gRPC) sağlar.
Varsayılan değer, trafik bilgisi olmayan sonuçlardır. Trafik seçeneklerini TRAFFIC_UNAWARE
, TRAFFIC_AWARE
ve TRAFFIC_AWARE_OPTIMAL
yönlendirme tercihleriyle seçersiniz. Her yönlendirme tercihi, rota kalitesi, tahmini varış zamanı ve yanıt gecikmesi açısından farklı sonuçlar verir.
Trafik koşulları
Trafik koşulları, trafik akışının hızını karakterize eder:
Normal trafik: Trafik normal hızda akıyor ve trafik sıkışıklığı yok.
Az ila orta düzeyde trafik: Trafik yoğunluğu artıyor ve trafik daha düşük bir hızda akıyor.
Yoğun trafik: Trafik hızı çok düşük ve trafik çok sıkışık.
Trafik bilgisi yok
TRAFFIC_UNAWARE
varsayılan ayardır. 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.
TRAFFIC_UNAWARE
rotaları, mevcut trafik koşulları dikkate alınmadan hesaplanır. Bu yönlendirme tercihi, en hızlı istek yanıtını (en düşük gecikmeyi) sağlar.
TRAFFIC_UNAWARE
seçeneğini belirlerseniz rota ve süre, mevcut yol koşullarına değil, yol ağına ve zamana bağlı olmayan ortalama trafik koşullarına göre belirlenir. Bu nedenle, rotalar geçici olarak kapalı olan yollar içerebilir. Belirli bir istek için sonuçlar, yol ağındaki değişiklikler, güncellenen ortalama trafik koşulları ve hizmetin dağıtılmış yapısı nedeniyle zaman içinde değişiklik gösterebilir. Sonuçlar, herhangi bir zamanda veya sıklıkta neredeyse eşdeğer rotalar arasında da değişiklik gösterebilir.
Göreceğiniz yanıtlar şunlardır:
duration
: Rotanın tahmini varış süresini içerir.staticDuration
: Yalnızca geçmiş trafik bilgilerini dikkate alan rotanın TVS'si.TRAFFIC_UNAWARE
için bu,duration
ile aynı değeri içerir.
Trafik bilinci
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.
TRAFFIC_AWARE
rota tercihini belirlediğinizde hizmet, rotayı mevcut trafik koşullarını dikkate alarak hesaplar. 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.
Göreceğiniz yanıtlar şunlardır:
duration
: Gerçek zamanlı trafik bilgilerini dikkate alan tahmini varış süresi.staticDuration
Yalnızca geçmiş trafik bilgilerini dikkate alan rotanın tahmini varış zamanı.
Trafik bilinciyle optimize edilmiş
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. Bu yönlendirme tercihi, yanıtların döndürülmesinde en uzun gecikmeye (en yüksek gecikmeye) sahiptir.
TRAFFIC_AWARE_OPTIMAL
rota tercihini ayarlarken hizmet, rotayı mevcut trafik koşullarını dikkate alarak hesaplar ancak performans optimizasyonları uygulamaz. 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çeneği Compute Route Matrix ile kullandığınızda bir istekteki öğe sayısı (başlangıç sayısı × hedef sayısı)
- Compute Route Matrix sınırları hakkında daha fazla bilgi için Rota matrisi hesaplama başlıklı makaleyi inceleyin.
Göreceğiniz yanıtlar şunlardır:
duration
: Gerçek zamanlı trafik bilgileri dikkate alınarak rotanın tahmini varış süresi.staticDuration
: Yalnızca geçmiş trafik bilgilerini dikkate alan rotanın TVS'si.
Kalkış saatini ayarlama (isteğe bağlı)
Bu özelliği yalnızca kalkış saatinin gelecekte olması gereken trafik bilinçli istekler için kullanın. departureTime
mülkünü ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zamana ayarlanır.
Hizmetin rota seçerken trafiği tahmin etme şeklini ayarlamak istediğinizde departureTime
mülkü ile birlikte TRAFFIC_AWARE
ve TRAFFIC_AWARE_OPTIMAL
seçeneklerini kullanın.
TRAFFIC_UNAWARE
: Rota ve süre seçimi yol ağına ve zamana bağlı olmayan ortalama trafik koşullarına göre yapıldığından önerilmez.TRAFFIC_AWARE
veTRAFFIC_AWARE_OPTIMAL
: Bu tercihler canlı trafik koşullarını dikkate aldığından yakın zamanda yapılacak seyahatler için önerilir. Canlı trafik,departureTime
'ün şimdiye ne kadar yakın olduğuna bağlı olarak daha önemli ve alakalı hale gelir. Kalkış saatini ne kadar ileriye ayarlarsanız rota seçiminde geçmiş trafik koşullarına o kadar fazla dikkat edilir.
Örnek: Trafik bilinçli yönlendirmeyi seçme
Aşağıdaki JSON kodunda, istek mesajı öğe gövdesinde TRAFFIC_AWARE_OPTIMAL
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.