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 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 varsayılan olarak şu anki saat kullanılır.

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

    • 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 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, ç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, 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 uzundur:

"duration": "2436s"