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, 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ünü 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 şu anki saat kullanılır.

  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ü kullanmak, 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, çoğu gün gerçek seyahat süresinden daha uzun bir tahmini süre verir. Özellikle kötü hava koşullarının olduğu bazı günlerde bu tahmin aşılabilir.

    • OPTIMISTIC döndürülen duration_in_traffic değerinin, trafiğin iyi olduğu günlerdeki 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"