Trafik modelleri, trafik koşullarının belirli bir rota için toplam seyahat süresini nasıl etkilediğini tahmin etmek üzere belirli algoritmalar ve faktörlerden yararlanır. Routes API, trafikteki 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ü belirtmek için
Kalkış ve varış noktalarınızı belirleyin.
Kalkış saatiniz gelecekteyse
departure_time
parametresini kullanarak saati ekleyin. Kalkış saati belirtmezseniz varsayılan olarak şimdi olur.trafficModel
parametresi ve aşağıdaki türlerden biriyle kullanılacak trafik modelini seçin:Hem geçmiş trafik koşulları hem de canlı trafik hakkında bilinenlere göre, döndürülen
duration_in_traffic
değerinin en iyi seyahat süresi tahmini olduğunu istemek içinBEST_GUESS
(varsayılan) kullanılır.departure_time
şimdi yaklaştıkça canlı trafik daha da önem kazanıyor. VarsayılanBEST_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.Döndürülen
duration_in_traffic
kodunun, zamanı trafiğin kötü olduğu günlerde geçmiş trafik koşullarına göre modellemesini istemek içinPESSIMISTIC
. Bu tür, büyük olasılıkla çoğu gündeki gerçek seyahat süresinden daha uzun tahmini bir süre verir. Durumun özellikle kötü olduğu bazı günler bu tahmini aşabilir.OPTIMISTIC
: Döndürülenduration_in_traffic
kodunun, zamanı trafiğin iyi olduğu günlerde geçmiş trafik koşullarına göre modellemesini istemek için kullanın. 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"
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 ettiğinde istediğiniz trafik modeli türünü kullanır.
Örnek: Trafik modeli isteği
Örneğin, bu istek, sürenin belirli bir kalkış saatinde OPTIMISTIC
trafik modeli türü kullanılarak tahmin edileceğini belirtir:
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"