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

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Trafik modelleri, trafik koşullarının belirli bir rotanın toplam seyahat süresini nasıl etkileyeceğini tahmin etmek için belirli algoritmalar ve faktörler kullanır. Routes API, trafikteki süreyi hesaplarken 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 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öntemde de BEST_GUESS trafik modeli türü kullanılır.

Trafik türü belirtmek için

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

  2. Kalkış zamanınız gelecekteyse departure_time parametresini kullanarak saati ekleyin. Kalkış saati belirtmezseniz varsayılan olarak "şimdi" kullanılır.

  3. routingPreference parametresini TRAFFIC_AWARE_OPTIMAL olarak ayarlayın. routingPreference parametresini TRAFFIC_UNAWARE veya TRAFFIC_AWARE olarak ayarlamak, trafficModel parametresiyle uyumlu değildir.

  4. trafficModel parametresiyle kullanılacak trafik modelini ve aşağıdaki türlerden birini seçin:

    • BEST_GUESS (varsayılan) 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 seyahat süresinin en iyi tahmini olmasını istemek için kullanılır. Canlı trafik bilgileri, departure_time şu ana ne kadar yakınsa o kadar önemli hale gelir. 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 modellerinin, kötü trafik günlerinde geçmişteki trafik koşullarına göre zamanı modellemesini istemek için kullanılır. Bu tür, çoğu günde gerçek seyahat süresinden daha uzun olması muhtemel tahmini bir süre verir. Özellikle kötü koşulların olduğu bazı günlerde bu tahmin yine de aşılabilir.

    • OPTIMISTIC, döndürülen duration_in_traffic modellerinin, iyi trafik günlerinde geçmişteki trafik koşullarına göre zamanı modellemesini istemek için kullanılır. Bu tür, çoğu günde gerçek seyahat süresinden daha kısa olması muhtemel tahmini bir süre verir. Özellikle iyi koşulların olduğu bazı günlerde bu tahminden daha hızlı sonuç alınabilir.

    Örneğin: 

    "trafficModel": "OPTIMISTIC"

    BEST_GUESS

  5. Alan maskesinde routes.duration alanını belirtin.

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    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, sürenin belirli bir kalkış saatinde OPTIMISTIC trafik modeli türü kullanılarak tahmin edilmesini 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, 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"