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

Trafik modelleri, trafik koşullarının belirli bir rotanın toplam seyahat süresini nasıl etkilediğini tahmin etmek için belirli algoritmalar ve faktörler kullanır. Routes API, trafikte sürenin hesaplanmasında kullanılan farklı faktörlere öncelik vermek 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 bağlı olarak 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.

Trafik türünü belirtmek için

1. Kalkış ve varış noktanızı ayarlayın.

2. Kalkış saatiniz gelecekteyse departure_time parametresini kullanarak saati ekleyin. Kalkış saati belirtmezseniz varsayılan olarak şimdi olur.

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

   • BEST_GUESS (varsayılan) değerini seçerek döndürülen duration_in_traffic değerinin, hem geçmiş trafik koşulları hem de canlı trafik hakkında bilinenler göz önüne alındığında yolculuk süresinin en iyi tahmini olmasını isteyin. departure_time ne kadar yakınsa canlı trafik o kadar önemli olur. Varsayılan BEST_GUESS türünün kullanılması, kullanım alanlarının büyük çoğunluğu için en yararlı tahminleri sağlar.

   • PESSIMISTIC döndürülen duration_in_traffic işlevinin, kötü trafik günlerindeki geçmiş trafik koşullarına göre zamanı modellemesini istemek için. Bu tür, çoğu gün gerçek seyahat süresinden daha uzun bir tahmini süre verir. Özellikle kötü hava koşullarının olduğu bazı günler bu tahmini aşabilir.

   • OPTIMISTIC: döndürülen duration_in_traffic öğesinin zamanı trafiğin uygun günlerdeki geçmiş trafik koşullarına göre modellemesini isteyin. Bu tür, çoğu gündeki gerçek seyahat süresinden büyük olasılıkla daha kısa olan tahmini bir süre verir. Yine de, özellikle iyi koşulların olduğu ara sıra günler 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

   RPC

   const (fieldMask = "routes.duration")

Routes API, trafikte geçen süreyi tahmin ederken istediğiniz trafik modeli türünü kullanır.

Örnek: Trafik modeli isteği

Örneğin, bu istekte sürenin belirli bir kalkış saatinde OPTIMISTIC trafik modeli türü kullanılarak tahmin edilmesi belirtilmektedir:

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, seyahat 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 uzundur:

"duration": "2436s"