Trafik verilerinin düzeyini ayarlama

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ı)

  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 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 ve TRAFFIC_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.