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, trafikte 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ü 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ü belirtmek için

  1. Kalkış ve varış noktanızı ayarlayın.

  2. Kalkış saatiniz gelecekteyse departure_time parametresini kullanarak saati ekleyin. Kalkış saati belirtmezseniz varsayılan olarak şimdi olur.

  3. trafficModel parametresi ve aşağıdaki türlerden biriyle kullanılacak trafik modelini seçin:

    • 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 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.

    • PESSIMISTIC döndürülen duration_in_traffic işlevinin, 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 ç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 değerinin, iyi trafik günlerindeki geçmiş trafik koşullarına göre zamanı modellemesini istemek için. Bu tür, çoğu gün gerçek seyahat süresinden daha kısa olan bir tahmini süre verir. Özellikle iyi koşulların olduğu bazı günlerde bu tahminden daha hızlı teslimat yapılabilir.

    Ö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 istekte sürenin belirli bir kalkış saatinde OPTIMISTIC trafik modeli türü kullanılarak tahmin edilmesi belirtilmektedir:

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 uzundur:

"duration": "2436s"