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. 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ü ayarlarken 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.

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 ş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. departure_time ne kadar yakınsa canlı trafik o kadar önemli olur. Varsayılan BEST_GUESS türünü kullanmak, 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 değerinin, kötü trafik günlerindeki geçmiş trafik koşullarına göre zamanı modellemesini istemek için. 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 işlemi gerçekleştirildiğinde, 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, çoğu gün gerçek seyahat süresinden daha kısa olan bir tahmini süre verir. 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

    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 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, 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 uzun:

"duration": "2436s"