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ı ile dengeler. Bir istekte bulunduğunuzda, mümkün olan en doğru sonuçları mı döndürmenin yoksa sonuçları olabildiğince hızlı döndürmenin mi daha iyi olduğu konusunda karar vermek istersiniz. Routes API, yanıt verilerinin kalitesi ile yanıtın gecikmesini karşılaştırmanıza olanak tanıyan seçenekler sunar.

Trafik verilerinin düzeyini ayarlama

Routes API, rotaların hesaplanması için yönlendirme tercihlerini belirtmenizi sağlayan RoutingPreference (REST) ve RoutingPreference (gRPC) özellikleri sunar. Bu tercihler, trafik koşullarının, rota hesaplamasına dahil edilme düzeyi açısından farklılık gösterir. Her yönlendirme tercihi rota kalitesi, tahmini tahmini varış süresi ve yanıt gecikmesi açısından belirli ölçüde farklı sonuçlar üretir.

Trafik koşulları, trafik akış hızını tanımlar. Örneğin:

• Trafik yoğunluğu olmadığında, trafik koşulları normal kabul edilir ve trafik kesintisiz olarak normal hızda akar.
• Yoğun saatlere yaklaşırken trafik yoğunluğu artar. Bu da trafiğin yavaşlayarak hafif ve orta derece trafik koşullarına neden olur.
• Tampondan tamper arasındaki trafikte, akış hızı durup yoğun trafik koşullarına neden olur.

Trafik bilgisi yok

TRAFFIC_UNAWARE yönlendirme tercihini belirlediğinizde, 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:

• TVS, 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 istiyorsanız ve yaklaşık yönlendirme ayrıntıları yeterince iyiyse bu yönlendirme tercihini kullanın.

Trafiğe duyarlı

TRAFFIC_AWARE yönlendirme tercihini belirlediğinizde 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 yansıtıyor. Veri kalitesindeki bu artış yanıt gecikmesinden kaynaklandığı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 rotadaki seyahat süresini içerir.

TRAFFIC_UNAWARE seçeneğinden daha doğru yönlendirme ayrıntıları istiyorsanız ve yanıtların gecikmede orta düzeyde bir artışla döndürülmesinin sizin için bir sakıncası yoksa bu yönlendirme tercihini kullanın.

Trafiğe duyarlı optimum

TRAFFIC_AWARE_OPTIMAL yönlendirme tercihini belirlediğinizde, rotalar mevcut trafik koşullarına göre hesaplanır ancak performans optimizasyonu uygulanmaz. Bu modda, sunucu en uygun rotayı bulmak için yol ağında daha kapsamlı bir arama gerçekleştirir.

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

Bu seçenek İşlem Rota Matrisi ile 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ünü inceleyin.

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 rotadaki seyahat süresini içerir.

Bu yönlendirme tercihi en yüksek yanıt gecikmesini sağlar (yani yanıtlar en uzun gecikmeyle geri döner). Yanıtların ne kadar sürdüğüne bakılmaksızın, en yüksek kalitedeki sonuçları istediğinizde bu yönlendirme tercihini kullanın.

Kalkış saatini ayarlamanın etkisi

İsteğe bağlı olarak bir seyahatin kalkış saatini ayarlamak için departureTime özelliğini kullanabilirsiniz. departureTime özelliğini ayarlamazsanız varsayılan olarak istekte bulunduğunuz zaman kullanılır.

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

• Canlı trafik koşullarını dikkate alan TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL için departureTime yaklaştıkça canlı trafik daha önemli hale gelir. Kalkış saatini ne kadar uzak bir tarihe ayarlarsanız, geçmiş trafik koşulları o kadar dikkate alınır.

Örnek ayar yönlendirme tercihi

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ı bir çoklu çizgi boyunca trafik koşulları hakkında bilgi istemenize olanak tanır. Daha fazla bilgi için Çoklu çizgi isteme bölümüne bakın.