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
Kalkış ve varış noktanızı ayarlayın.
Kalkış saatiniz gelecekteyse
departure_time
parametresini kullanarak saati ekleyin. Kalkış saati belirtmezseniz varsayılan olarak şu anki saat kullanılır.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ülenduration_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ılanBEST_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ülenduration_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ülenduration_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"
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"