Trafik verilerinin nasıl ve nasıl ekleneceğini belirtin

Seçtiğiniz trafik tercihleri, rota ayrıntılarının doğruluğunu istek performansıyla dengeler. Bir istekte bulunduğunuzda, mümkün olan en doğru sonuçları döndürmenin mi yoksa sonuçları olabildiğince hızlı bir şekilde döndürmenin mi daha iyi olduğunu değerlendirmeniz gerekir. Routes API, yanıt verilerinin kalitesini ve yanıtın gecikmesini kontrol etmenizi sağlayan seçenekler sunar.

Trafik verilerinin düzeyini ayarlama

Routes API, rotaları hesaplamak için yönlendirme tercihlerini belirtmenize olanak tanıyan RoutingPreference (REST) ve RoutingPreference (gRPC) özelliklerini sunar. Bu tercihler, rota hesaplamasında trafik koşullarını hesaba katmak bakımından farklılık gösterir. Her yönlendirme tercihi; rota kalitesi, tahmini TVS ve yanıt gecikmesi açısından belirli ölçüde farklı sonuçlar üretir.

Trafik koşulları, trafik akış hızını gösterir. Örneğin:

• Trafik sıkışıklık olmadığında trafik koşulları normal olarak kabul edilir ve trafik akışı, normal kesintisiz hızda gerçekleşir.
• Yoğun kullanım saatlerine yaklaşırken trafik yoğunluğu artar. Bu da trafiğin yavaşlamasına ve hafif ile orta arası trafik koşullarına neden olur.
• Bumper'dan bumper'a olan trafikte akış hızı durdurularak yoğun trafik koşullarına neden olur.

Trafik farkında değil

TRAFFIC_UNAWARE yönlendirme tercihini ayarladığınızda 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:

• GMR, duration yanıt özelliğinde yer alır.

• duration ve staticDuration yanıt özellikleri aynı değeri içerir.

Yanıtların en hızlı şekilde döndürülmesini istediğinizde ve yaklaşık yönlendirme ayrıntıları yeterince iyi olduğunda bu yönlendirme tercihini kullanın.

Trafiğe duyarlı

TRAFFIC_AWARE yönlendirme tercihini ayarladığınızda 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 şekilde yansıtır. Veri kalitesindeki bu artış yanıt gecikmesi pahasına yapıldığından gecikmenin büyük bir kısmını azaltmak için performans optimizasyonları uygulanır.

Yanıtta:

• Gerçek zamanlı trafiği dikkate alan TVS, duration yanıt özelliğinde yer alır.

• staticDuration yanıt özelliği, trafik koşulları dikkate alınmadan rotada seyahatin süresini içerir.

TRAFFIC_UNAWARE ürününden daha doğru yönlendirme ayrıntıları istediğinizde bu yönlendirme tercihini kullanın. Bununla birlikte, yanıtların gecikmede orta düzeyde artışla döndürülmesi sizin için sorun yaratmaz.

Trafiğe duyarlı optimum

TRAFFIC_AWARE_OPTIMAL yönlendirme tercihini ayarladığınızda rotalar mevcut trafik koşulları dikkate alınarak hesaplanır ancak performans optimizasyonu uygulanmaz. Bu modda sunucu, en iyi rotayı bulmak için yol ağında daha kapsamlı bir arama yapar.

TRAFFIC_AWARE_OPTIMAL yönlendirme tercihi, maps.google.com ve Google Haritalar mobil uygulaması tarafından kullanılan modla eşdeğerdir.

Bu seçenek Compute Rota Matrisi ile birlikte kullanıldığında, bir istekteki öğe sayısı (kaynak sayısı × hedef sayısı) 100'ü aşamaz. İşlem Rota Matrisi sınırları hakkında daha fazla bilgi için Rota matrisi hesaplama bölümüne bakın.

Yanıtta:

• Gerçek zamanlı trafiği dikkate alan TVS, duration yanıt özelliğinde yer alır.

• staticDuration yanıt özelliği, trafik koşulları dikkate alınmadan rotada seyahatin süresini içerir.

Bu yönlendirme tercihi en yüksek yanıt gecikmesini sağlar (yani yanıtlar en uzun gecikmeyle döndürülür). Yanıtların ne kadar zaman aldığından bağımsız olarak en yüksek kalitede sonuçlar almak istediğinizde bu yönlendirme tercihini kullanın.

Kalkış saatini ayarlamanın etkisi

İsteğe bağlı olarak, bir gezinin kalkış saatini ayarlamak için departureTime özelliğini kullanabilirsiniz. departureTime özelliğini ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır.

• Rota ve süre seçimi yol ağına ve zamandan bağımsız ortalama trafik koşullarına dayalı olduğundan TRAFFIC_UNAWARE için departureTime değerini ayarlayamazsınız.

• Canlı trafik koşullarının dikkate alındığı TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL için canlı trafik, departureTime ne kadar yakın olursa o kadar önemli hale gelir. Kalkış saatini ileriye ne kadar uzaklaştırırsanız geçmiş trafik koşulları da o kadar göz önünde bulundurulur.

Yönlendirme tercihi ayarı örneği

Aşağıdaki JSON kodu, bir istek mesajı varlığı gövdesinde 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, trafiğe duyarlı çoklu çizgi üzerinden trafik koşulları hakkında bilgi istemenize olanak tanır. Daha fazla bilgi için Çoklu çizgi isteme bölümüne göz atın.