Trafik modelleri, trafik koşullarının belirli bir rota için toplam seyahat süresini nasıl etkilediğini tahmin etmek amacıyla belirli algoritmalar ve faktörlerden yararlanır. Routes API, trafikteki sürenin hesaplanmasında kullanılan farklı faktörlere öncelik verilmesi 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 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.
Bir trafik türü belirtmek için
Başlangıç ve varış noktalarınızı ayarlayın.
Kalkış saatiniz gelecekteyse
departure_time
parametresini kullanarak saati ekleyin. Bir kalkış saati belirtmezseniz varsayılan olarak şu an kullanılır.trafficModel
parametresiyle kullanılacak trafik modelini ve aşağıdaki türlerden birini seçin:Hem geçmiş trafik koşulları hem de canlı trafik hakkında bilinenler göz önünde bulundurulduğunda döndürülen
duration_in_traffic
değerinin en iyi seyahat süresi tahmini olmasını istemek içinBEST_GUESS
(varsayılan) işlevini kullanın. Canlı trafik,departure_time
tarihine yaklaştıkça daha önemli hale gelir. VarsayılanBEST_GUESS
türünü kullanmak, kullanım alanlarının büyük çoğunluğu için en faydalı tahminleri sağlar.Döndürülen
duration_in_traffic
öğesinin, kötü trafik günlerindeki geçmiş trafik koşullarına göre zamanı modellemesini istemek içinPESSIMISTIC
. Bu tür, çoğu günde gerçek seyahat süresinden büyük olasılıkla daha uzun bir tahmini süre verir. Zaman zaman özellikle kötü durumdaki günler bu tahmini değeri aşabilir.Döndürülen
duration_in_traffic
öğesinin, iyi trafik günlerindeki geçmiş trafik koşullarına göre zamanı modellemesini istemek içinOPTIMISTIC
. Bu tür, çoğu gündeki gerçek seyahat süresinden büyük olasılıkla daha kısa bir tahmini süre verir. Özellikle iyi koşullara sahip olan ara sıra günler yine de 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 ederken istediğiniz trafik modeli türünü kullanır.
Örnek: Trafik modeli isteği
Örneğin bu istek, belirli bir kalkış saatinde OPTIMISTIC
trafik modeli türü kullanılarak sürenin tahmin edileceğini belirtiyor:
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"