Kullanılacak trafik modeli türünü belirtin

Trafik modelleri, trafik koşullarının belirli bir rota için toplam seyahat süresini nasıl etkilediğini tahmin etmek amacıyla belirli algoritmalar ve faktörlerden yararlanır. Routes API, trafikteki sürenin hesaplanmasında kullanılan farklı faktörlere öncelik verilmesi için farklı trafik modeli türleri sunar. Rotalarınızın veya rota matrisinizin süresini hesaplarken rotalarınızın kullanmasını istediğiniz trafik modeli türünü belirtebilirsiniz. Trafik modeli türünü ayarladığınızda duration alanında döndürülen değer, seçtiğiniz trafik modeline göre değişir.

Hem Routes API Compute Routes hem de Compute Route Matrix yöntemleri trafik modeli türlerini destekler.

Varsayılan olarak her iki yöntem de BEST_GUESS trafik modeli türünü kullanır.

Bir trafik türü belirtmek için

  1. Başlangıç ve varış noktalarınızı ayarlayın.

  2. Kalkış saatiniz gelecekteyse departure_time parametresini kullanarak saati ekleyin. Bir kalkış saati belirtmezseniz varsayılan olarak şu an kullanılır.

  3. trafficModel parametresiyle kullanılacak trafik modelini ve aşağıdaki türlerden birini seçin:

    • Hem geçmiş trafik koşulları hem de canlı trafik hakkında bilinenler göz önünde bulundurulduğunda döndürülen duration_in_traffic değerinin en iyi seyahat süresi tahmini olmasını istemek için BEST_GUESS (varsayılan) işlevini kullanın. Canlı trafik, departure_time tarihine yaklaştıkça daha önemli hale gelir. Varsayılan BEST_GUESS türünü kullanmak, kullanım alanlarının büyük çoğunluğu için en faydalı tahminleri sağlar.

    • Döndürülen duration_in_traffic öğesinin, kötü trafik günlerindeki geçmiş trafik koşullarına göre zamanı modellemesini istemek için PESSIMISTIC. Bu tür, çoğu günde gerçek seyahat süresinden büyük olasılıkla daha uzun bir tahmini süre verir. Zaman zaman özellikle kötü durumdaki günler bu tahmini değeri aşabilir.

    • Döndürülen duration_in_traffic öğesinin, iyi trafik günlerindeki geçmiş trafik koşullarına göre zamanı modellemesini istemek için OPTIMISTIC. Bu tür, çoğu gündeki gerçek seyahat süresinden büyük olasılıkla daha kısa bir tahmini süre verir. Özellikle iyi koşullara sahip olan ara sıra günler yine de bu tahminden daha hızlı olabilir.

    Örneğin: 

    "trafficModel": "OPTIMISTIC"

  4. Alan maskesinde routes.duration alanını belirtin.

    REST

    -H X-Goog-FieldMask: routes.duration

    TBG

    const (fieldMask = "routes.duration")

Routes API, trafikteki süreyi tahmin ederken istediğiniz trafik modeli türünü kullanır.

Örnek: Trafik modeli isteği

Örneğin bu istek, belirli bir kalkış saatinde OPTIMISTIC trafik modeli türü kullanılarak sürenin tahmin edileceğini belirtiyor:

curl -X POST -H 'content-type: application/json' -d ' {
"origin": {
  "address": "Kyoto, Japan"
  },
"destination": {
  "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s"
  },
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE_OPTIMAL",
"trafficModel": "OPTIMISTIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Bu istek, gezi için OPTIMISTIC trafik modeli türünü kullanarak tahmini süreyi döndürür:

"duration": "1238s"

Trafik modeli türünü PESSIMISTIC olarak değiştirirseniz döndürülen süre daha uzun olur:

"duration": "2436s"