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

Trafik modelleri, trafiğin nasıl etkilendiğini tahmin etmek için belirli algoritmaları ve faktörleri kullanır. belirli bir rota için toplam seyahat süresini etkiler. Routes API kullanılan farklı faktörleri önceliklendirmek için farklı trafik modeli türleri sunar. trafikteki süreyi hesaplama. İstediğiniz trafik modeli türünü (ör. rotalarınızın veya rotalarınızın süresini hesaplarken kullanacağınız rotalarınız) matristir. Trafik modeli türünü ayarladığınızda, duration alanı, seçtiğiniz trafik modeline bağlı olarak değişiklik gösterir.

Routes API Compute Routes ve 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ü belirtmek için

1. Kalkış ve varış noktalarınızı belirleyin.

2. İleri bir saatte kalkış saatiniz gelecekteyse departure_time parametresinden yararlanın. Kalkış saati belirtmezseniz şimdiye kadar varsayılan değere sahiptir.

3. trafficModel parametresiyle kullanılacak trafik modelini seçin ve şu türlerden birini tercih edebilirsiniz:

   • Döndürülen duration_in_traffic değerini istemek için BEST_GUESS (varsayılan) her iki konum hakkında da bilinenler göz önüne alındığında, en iyi seyahat süresi tahminidir. geçmiş trafik koşulları ve canlı trafik. Canlı trafik, departure_time şimdiye ne kadar yaklaşırsa o kadar önemlidir. Varsayılan türü kullanma BEST_GUESS metriğinin sağladığı tahmini sonuçlar, reklamların büyük çoğunluğu için en yararlı tahminleri verir örnekler üzerinden görüntüleyebilirsiniz.

   • PESSIMISTIC: Döndürülen duration_in_traffic modelin trafiğin yoğun olduğu günlerdeki geçmiş trafik koşullarına dayalı olarak hesaplanan süre. Bu tür, büyük olasılıkla şundan daha uzun olan tahmini bir süre sağlar: çoğu gündeki gerçek seyahat süresidir. Zaman zaman özellikle kötü olan günler bu tahmini aşabilir.

   • OPTIMISTIC: Döndürülen duration_in_traffic modelin trafiğin iyi olduğu günlerdeki geçmiş trafik koşullarına dayalı olarak hesaplanan süre. Bu tür, büyük olasılıkla 2023'e kadar olan süreden daha kısa çoğu gündeki gerçek seyahat süresidir. Zaman zaman, özellikle bu tahminden daha hızlı da 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 model türünü belirtin.

Örnek: Trafik modeli isteği

Örneğin, bu istek, sürenin Belirli bir kalkış saatindeki OPTIMISTIC trafik modeli türü:

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, OPTIMISTIC trafik modelini kullanarak tahmini süreyi döndürür seyahat için tür:

"duration": "1238s"

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

"duration": "2436s"

.