트래픽 모델은 특정 알고리즘 및 요소를 사용하여 트래픽 양상을 예측합니다
특정 경로의 총 이동 시간에 영향을 미치는 상황입니다. Routes API는 트래픽의 시간을 계산하는 데 사용되는 다양한 요소에 우선순위를 지정하는 다양한 트래픽 모델 유형을 제공합니다. 원하는 트래픽 모델 유형을 지정하고
경로 또는 경로의 소요 시간을 계산할 때 사용할 경로 등
행렬입니다. 트래픽 모델 유형을 설정하면 duration
필드에 반환되는 값은 선택한 트래픽 모델에 따라 다릅니다.
Routes API Compute Routes
및
Compute Route Matrix
메서드는 트래픽 모델 유형을 지원합니다.
기본적으로 두 메서드 모두 BEST_GUESS
트래픽 모델 유형을 사용합니다.
트래픽 유형 지정
출발지와 목적지를 설정합니다.
출발 시간이 미래인 경우
departure_time
매개변수 출발 시간을 지정하지 않으면 기본값은 지금입니다.trafficModel
매개변수와 함께 사용할 트래픽 모델을 선택합니다. 다음 유형 중 하나:BEST_GUESS
(기본값):duration_in_traffic
를 반환하도록 요청합니다. 두 지점 모두에 대해 알려진 정보를 고려할 때 최적의 예상 이동 시간 이전 교통상황 및 실시간 교통정보 실시간 교통정보departure_time
이 지금에 가까울수록 중요합니다. 기본 유형 사용BEST_GUESS
의 경우 대다수의 사용자에게 가장 유용한 예측을 제공합니다. 사용할 수 있습니다PESSIMISTIC
: 반환된duration_in_traffic
가 교통량이 적은 날의 과거 교통 상황을 기반으로 시간을 모델링하도록 요청합니다. 이 유형은 대부분의 날에 실제 이동 시간보다 더 길 수 있는 예상 소요 시간을 제공합니다. 가끔 악성 트래픽이 조건이 이 예상치를 초과할 수 있습니다.OPTIMISTIC
는 반환된duration_in_traffic
가 교통량이 좋은 날의 이전 교통상황을 기준으로 시간이 계산됩니다. 이 유형은 대부분의 날에 실제 이동 시간보다 짧을 가능성이 높은 예상 소요 시간을 제공합니다. 특히 양호한 상태가 여전히 이 예상치보다 빠를 수 있습니다.
예를 들면 다음과 같습니다.
"trafficModel": "OPTIMISTIC"
필드 마스크에
routes.duration
필드를 지정합니다.REST
-H X-Goog-FieldMask: routes.duration
RPC
const (fieldMask = "routes.duration")
Routes API는 교통량을 고려한 시간을 추정할 때 요청한 교통 모델 유형을 사용합니다.
예: 트래픽 모델 요청
예를 들어 이 요청은
특정 출발 시간의 OPTIMISTIC
교통정보 모델 유형:
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'
이 요청은 OPTIMISTIC
트래픽 모델을 사용하여 예상 시간을 반환합니다.
경로 유형:
"duration": "1238s"
트래픽 모델 유형을 PESSIMISTIC
로 변경하면 반환되는 기간은 다음과 같습니다.
더 오래:
"duration": "2436s"