Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

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çin BEST_GUESS (varsayılan) kullanılır. departure_time şimdi yaklaştıkça canlı trafik daha da önem kazanıyor. Varsayılan BEST_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çin PESSIMISTIC. 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ülen duration_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"
```
Not: BEST_GUESS ile seyahat süresi tahmininin, OPTIMISTIC değerinden kısa veya PESSIMISTIC değerinden uzun olması mümkündür. Bunun nedeni, BEST_GUESS ürününün canlı trafik bilgilerini entegre etme şeklidir.

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"