Trafik verilerinin düzeyini ayarlama

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

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

• Trafikten bağımsız: Sonuçları mümkün olduğunca hızlı döndürür (en düşük gecikme).

İstek gönderirken mümkün olan en doğru sonuçları mı yoksa en hızlı sonuçları mı döndürmenin daha iyi olacağını değerlendirin. Routes API, yanıt verilerinin kalitesini yanıtın gecikmesine göre kontrol etmenizi sağlayan seçenekler sunar.

Trafik düzeyini ayarlama

Routes API, rotaları hesaplamak için rota tercihlerini belirtmenize olanak tanıyan RoutingPreference (REST) ve RoutingPreference (gRPC) özelliklerini sunar.

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

Trafik koşulları

Trafik koşulları, trafik akış hızını tanımlar:

• Normal trafik: Trafik sıkışıklığı yoktur ve trafik normal hızda akmaktadır.

• Hafif ila orta yoğunlukta trafik: Trafik akışının daha düşük hızda olduğu, artan yoğunluk.

• Yoğun trafik: Trafik hızının büyük ölçüde azaldığı ciddi sıkışıklık.

Trafikten habersiz

TRAFFIC_UNAWARE varsayılan ayardır. Yanıtların en hızlı şekilde döndürülmesini istediğinizde ve yaklaşık rota ayrıntıları yeterli olduğunda bu rota tercihi 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 seçilen 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 bulunabilir. 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, neredeyse eşdeğer rotalar arasında herhangi bir zamanda veya sıklıkta da değişiklik gösterebilir.

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

• duration: Rotanın TVS'sini içerir.

• staticDuration: Yalnızca geçmiş trafik bilgileri dikkate alınarak rota için TVS. TRAFFIC_UNAWARE için bu, duration ile aynı değeri içerir.

Trafiğe duyarlı

TRAFFIC_UNAWARE seçeneğinden daha doğru rota ayrıntıları istediğinizde ve yanıtların gecikme süresinde orta düzeyde bir artışla döndürülmesini sorun etmediğinizde bu rota tercihini kullanın.

TRAFFIC_AWARE rota tercihini ayarladığınızda hizmet, mevcut trafik koşullarını dikkate alarak rotayı hesaplar. 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 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 TVS.

• staticDuration Yalnızca geçmiş trafik bilgilerini dikkate alan rota için TVS.

Trafiğe duyarlı optimum

Yanıtların ne kadar sürede alınacağını dikkate almadan en yüksek kalitede sonuçlar almak istediğinizde bu yönlendirme tercihini kullanın. Bu yönlendirme tercihi, yanıt döndürmede en uzun gecikmeye (en yüksek gecikme süresi) sahiptir.

TRAFFIC_AWARE_OPTIMAL rota 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 modla 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ı) sınırlıdır. 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 rota için TVS.

• staticDuration: Yalnızca geçmiş trafik bilgileri dikkate alınarak rota için TVS.

Kalkış saatini ayarlama (isteğe bağlı)

Bu özelliği yalnızca, kalkış zamanının 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 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 zamandan bağımsız ortalama trafik koşullarına dayandığı için önerilmez.

• TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL: Bu tercihler canlı trafik koşullarını dikkate aldığından yakın gelecekteki kalkışlar için önerilir. Canlı trafik, departureTime şu ana yaklaştıkça daha önemli ve alakalı hale gelir. Hareket saatini ne kadar ileri bir tarihe ayarlarsanız rota seçilirken geçmiş trafik koşulları o kadar fazla dikkate alınır.

Örnek: Trafiğe duyarlı rotayı seçme

Aşağıdaki JSON kodu, istek mesajı varlık 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"
}