Trafik verilerinin düzeyini ayarlama

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Seçtiğiniz trafik tercihleri, rota ayrıntılarının doğruluğu ile istek performansını iki şekilde dengeler:

  • Trafiğe duyarlı: Mümkün olan en doğru sonuçları döndürür (daha yüksek gecikme).

  • Trafik bilgisi yok: Sonuçları mümkün olduğunca hızlı (en düşük gecikme süresi) döndürün.

İstek gönderdiğinizde, mümkün olduğunca doğru sonuçlar mı yoksa mümkün olduğunca hızlı sonuçlar mı döndürmenin daha iyi olacağını değerlendirin. Routes API, yanıt verilerinin kalitesini yanıtın gecikme süresine göre kontrol etmenizi sağlayan seçenekler sunar.

Trafik düzeyini ayarlama

Routes API, rotaları hesaplamak için yönlendirme tercihlerini belirtmenize olanak tanıyan RoutingPreference (REST) ve RoutingPreference (gRPC) sağlar.

Varsayılan olarak trafikten bağımsız sonuçlar gösterilir. TRAFFIC_UNAWARE, TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL yönlendirme tercihleriyle trafik seçeneklerini belirleyebilirsiniz. Her yönlendirme tercihi, rota kalitesi, tahmini varış zamanı ve yanıt gecikmesi açısından farklı sonuçlar üretir.

Trafik koşulları

Trafik koşulları, trafik akışının hızını gösterir:

  • Normal trafik: Trafik normal hızda akarken tıkanıklık yoktur.

  • Hafif ila orta yoğunlukta trafik: Trafik akışının daha düşük bir hızda gerçekleştiği, artan tıkanıklık.

  • Yoğun trafik: Trafik hızının ciddi şekilde düştüğü, çok sıkışık trafik.

Trafiğe duyarsız

TRAFFIC_UNAWARE varsayılan ayardır. Yanıtların en hızlı şekilde döndürülmesini istediğinizde ve yaklaşık yönlendirme ayrıntıları yeterli olduğunda 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 gecikme süresi) sağlar.

TRAFFIC_UNAWARE seçeneğini belirlerseniz rota ve süre, mevcut yol koşullarına değil, yol ağına ve zamandan bağımsız ortalama trafik koşullarına göre belirlenir. Bu nedenle, rotalarda geçici olarak kapalı olan yollar yer alabilir. Yol ağındaki değişiklikler, güncellenen ortalama trafik koşulları ve hizmetin dağıtılmış yapısı nedeniyle belirli bir isteğin sonuçları zaman içinde değişebilir. Sonuçlar, neredeyse eşdeğer rotalar arasında da herhangi bir zamanda veya sıklıkta değişiklik gösterebilir.

Göreceğiniz yanıtlar şunlardır:

  • duration: Rotanın tahmini varış zamanını içerir.

  • staticDuration: Yalnızca geçmiş trafik bilgileri dikkate alınarak rotanın tahmini varış süresi. TRAFFIC_UNAWARE için bu, duration ile aynı değeri içerir.

Trafiğe duyarlı

TRAFFIC_UNAWARE'dan daha doğru rota ayrıntıları istediğinizde ancak yanıtların orta düzeyde gecikmeyle döndürülmesini sorun etmediğinizde bu yönlendirme tercihini kullanın.

TRAFFIC_AWARE yönlendirme tercihini ayarladığınızda hizmet, mevcut trafik koşullarını dikkate alarak rotayı hesaplar. Bu sayede 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 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 bilgileri dikkate alınarak hesaplanan tahmini varış süresi.

  • staticDuration Yalnızca geçmiş trafik bilgileri dikkate alınarak rotanın tahmini varış zamanı.

Trafiğe duyarlı en uygun rota

Yanıtların ne kadar süreceğine bakılmaksızın en yüksek kaliteli sonuçları istediğinizde bu yönlendirme tercihini kullanın. Bu yönlendirme tercihi, yanıt döndürme konusunda en uzun gecikmeye (en yüksek gecikme) sahiptir.

TRAFFIC_AWARE_OPTIMAL yönlendirme tercihini ayarladığınızda 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 moda eşdeğerdir.

Bu seçeneği Compute Route Matrix ile kullandığınızda bir istekteki öğe sayısı (başlangıç noktası sayısı × hedef sayısı)

  1. 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 bilgileri dikkate alınarak rotanın tahmini varış süresi.

Kalkış saatini ayarlayın (isteğe bağlı)

Bu özelliği yalnızca kalkış saatinin gelecekte olması gereken, trafiğe duyarlı istekler için kullanın. departureTime özelliğini ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır.

Hizmetin bir rota seçerken trafiği tahmin etme şeklini ayarlamak istediğinizde departureTime özelliğini TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL seçenekleriyle birlikte kullanın.

  • TRAFFIC_UNAWARE: Rota ve süre seçimi yol ağına ve ortalama zamandan bağımsız trafik koşullarına göre yapıldığından önerilmez.

  • TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL: Bu tercihler anlık trafik koşullarını dikkate aldığından yakın gelecekteki kalkışlar için önerilir. Canlı trafik, departureTime şu ana ne kadar yakın olursa o kadar önemli ve alakalı hale gelir. Kalkış saatini gelecekte ne kadar ileri bir tarihe ayarlarsanız rota seçiminde geçmiş trafik koşulları o kadar çok dikkate alınır.

Örnek: Trafiğe duyarlı yönlendirme nasıl seçilir?

Aşağıdaki JSON kodu, istek mesajı gövdesinde TRAFFIC_AWARE_OPTIMAL 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, trafik durumuna duyarlı bir çoklu çizgi üzerindeki 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.