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 istek gönderirken 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ğerlendirmeniz gerekir. Routes API, yanıt verilerinin kalitesini ve yanıtın gecikmesini kontrol etmenize olanak tanıyan seçenekler sunar.

Trafik verilerinin düzeyini ayarlama

Rotalar API'si, rotaları hesaplamak için yönlendirme tercihlerini belirtmenize olanak tanıyan RoutingPreference (REST) ve RoutingPreference (gRPC) sağlar. Bu tercihler, rota hesaplamasında trafik koşullarını ne ölçüde hesaba kattıkları açısından farklılık gösterir. Her yönlendirme tercihi, rota kalitesi, tahmini varış zamanı ve yanıt gecikmesi açısından bir derece farklı sonuçlar verir.

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

  • Trafik sıkışıklığı olmadığında trafik koşulları normal kabul edilir ve trafik normal, engelsiz hızda akar.
  • Yoğun saatlere yaklaşıldığında trafik yoğunluğu artar. Bu da trafiğin yavaşlamasına neden olur ve hafif ile orta düzeyde trafik koşulları oluşturur.
  • Trafik sıkışık olduğunda akış hızı yavaşlar ve yoğun trafik koşulları oluşur.

Trafik bilgisi yok

TRAFFIC_UNAWARE yönlendirme tercihini ayarlarken 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:

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

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

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.

Trafik bilinci

TRAFFIC_AWARE yönlendirme tercihini ayarlarken 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ı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.

Yanıtta:

  • Gerçek zamanlı trafiği dikkate alan ETA, duration yanıt mülkünde yer alır.

  • staticDuration yanıt mülkü, trafik koşullarını dikkate almadan rotadaki seyahat süresini içerir.

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.

Trafik bilinciyle optimize edilmiş

TRAFFIC_AWARE_OPTIMAL Yönlendirme tercihini belirlediğinizde, mevcut trafik koşulları dikkate alınarak rotalar hesaplanır ancak performans optimizasyonu uygulanmaz. 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çenek, rota matrisini hesaplama ile birlikte kullanıldığında bir istekteki öğe sayısı (başlangıç sayısı × hedef sayısı) 100'ü aşamaz. Compute rota matrisi sınırları hakkında daha fazla bilgi için Rota matrisi hesaplama başlıklı makaleyi inceleyin.

Yanıtta:

  • Gerçek zamanlı trafiği dikkate alan ETA, duration yanıt mülkünde yer alır.

  • staticDuration yanıt mülkü, trafik koşullarını dikkate almadan rotadaki seyahat süresini içerir.

Bu yönlendirme tercihi, en yüksek yanıt gecikmesini sağlar (yani yanıtlar en uzun gecikmede döndürülür). 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.

Kalkış saatini ayarlama

İsteğe bağlı olarak departureTime mülkünü kullanarak bir seyahatin kalkış saatini ayarlayabilirsiniz. departureTime mülkünü ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır.

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

  • Canlı trafik koşullarını dikkate alan TRAFFIC_AWARE ve TRAFFIC_AWARE_OPTIMAL için departureTime'nin şimdiye ne kadar yakın olduğu canlı trafiğin önemini belirler. Kalkış saatini ne kadar ileriye ayarlarsanız geçmiş trafik koşulları o kadar fazla dikkate alınır.

Yönlendirme tercihi ayarlama örneği

Aşağıdaki JSON kodunda, istek mesajı öğe gövdesinde 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.