Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

경로 유효성 검사 이해

경로를 만든 후 Roads Selection API가 유효성 검사 프로세스를 실행합니다. 이 유효성 검사를 통해 경로가 도로 관리 정보 내에서 데이터 수집 및 업데이트에 적합한지 확인합니다. 이 프로세스는 일반적으로 몇 분 이내에 완료됩니다.

API 응답의 state 필드를 통해 경로의 유효성 검사 상태를 모니터링할 수 있습니다. 선택한 경로 가져오기에 설명된 대로 get 엔드포인트를 사용하거나 BigQuery의 routes_status 테이블을 검사하여 이를 확인할 수 있습니다.

경로 상태

state 필드는 SelectedRoute 리소스의 현재 유효성 검사 및 운영 상태를 나타냅니다. state 필드는 다음 값을 가질 수 있습니다.

STATE_UNSPECIFIED: 이 경로의 유효성 검사 상태가 설정되지 않았습니다.
STATE_VALIDATING: 경로의 유효성 검사가 진행 중입니다.
STATE_RUNNING: 경로가 유효성 검사를 통과했으며 이제 활성 상태입니다. API가 데이터를 적극적으로 수집하고 이 경로에 대한 주기적인 업데이트를 BigQuery, Pub/Sub 또는 둘 다로 전송합니다.
STATE_DELETING: 경로가 삭제 대상으로 표시되었으며 시스템에서 삭제되고 있습니다.
STATE_INVALID: 경로가 특정 기준에 따라 유효성 검사에 실패했습니다. 경로가 STATE_INVALID 상태인 경우 응답에 validationError 필드에 유효성 검사가 실패한 이유에 관한 세부정보가 포함됩니다.

SelectedRoute 리소스의 state가 STATE_INVALID인 경우 API 응답에 validationError 필드가 포함됩니다. 이 필드는 유효성 검사 실패에 대한 구체적인 이유를 제공합니다.

validationError 필드는 다음 값을 가질 수 있습니다.

VALIDATION_ERROR_UNSPECIFIED: 이 경로의 유효성 검사 오류가 설정되지 않았습니다.
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: 경로가 프로젝트의 승인된 관할 구역 외부에 있습니다.
VALIDATION_ERROR_LOW_ROAD_USAGE: 경로의 도로 사용량이 적습니다. 즉, 의미 있는 분석을 위해 수집할 수 있는 교통정보 데이터가 충분하지 않습니다. 도로 사용량이 적어 무효로 분류된 경로는 트래픽 볼륨이 미리 정해진 기준점을 초과하면 다시 유효해질 수 있습니다. 도로 사용량이 적은 경로에서 자세히 알아보세요.

API에서 일관된 분석을 위한 교통정보 데이터가 충분하지 않다고 판단하는 경우 경로에 VALIDATION_ERROR_LOW_ROAD_USAGE가 지정될 수 있습니다. 이는 초기 유효성 검사 또는 지속적인 평가 중에 발생할 수 있습니다.

도로 사용량이 적은 경로에 예상되는 사항은 다음과 같습니다.

BigQuery로의 데이터 게시 계속: 도로 사용량이 적어 경로가 STATE_INVALID로 분류되더라도 API는 해당 경로에 사용 가능한 데이터를 계속 처리하고 BigQuery에 게시합니다.
Pub/Sub 업데이트 중지: 경로의 state가 STATE_INVALID로 변경되면 Pub/Sub에 대한 주기적인 실시간 업데이트가 중지됩니다.
분기별 평가: API는 모든 활성 경로의 트래픽 볼륨에 대해 분기별 평가를 실행합니다.
- 평가 중에 트래픽이 적은 것으로 감지되면 API는 경고를 SelectedRoute 리소스 내에서 발행합니다.
- 트래픽이 적은 상태가 4분기 연속으로 지속되면 경로의 state가 STATE_INVALID로 변경되고 Pub/Sub 업데이트가 중지됩니다.
재유효성 검사 가능: 경로가 STATE_INVALID이더라도 지속적인 트래픽 평가의 대상이 됩니다. 후속 평가에서 트래픽 볼륨이 미리 정해진 기준점을 초과하면 경로가 유효한 (STATE_RUNNING) 것으로 다시 분류될 수 있습니다.
상태 모니터링: 선택한 경로 가져오기에 설명된 대로 get 엔드포인트를 사용하거나 BigQuery의 routes_status 테이블을 검사하여 경로의 유효성 검사 상태를 모니터링할 수 있습니다.

경로 state가 STATE_INVALID인 경우 수신한 validationError에 따라 다음 문제 해결 가이드라인을 따르세요.

VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: 이 오류는 정의된 경로가 프로젝트에 승인된 지리적 영역을 벗어난다는 것을 나타냅니다. 이 문제를 해결하려면 기존 경로를 삭제하고 경로를 다시 만들어 모든 지점 (출발지, 목적지, 중간 지점)이 승인된 프로젝트의 관할 구역 내에 있는지 확인합니다.
VALIDATION_ERROR_LOW_ROAD_USAGE: 이 오류는 선택한 경로에 의미 있는 분석 및 업데이트를 위한 도로 사용량 데이터가 충분하지 않음을 의미합니다. 이 문제를 해결하려면 기존 경로를 삭제하고 도로 사용량 또는 '혼잡도'가 더 높은 영역을 선택하여 데이터를 수집하는 경로를 다시 만듭니다. 경로에 이 오류가 있는 경우 경로의 상태가 도로 사용량이 적은 경로 에 설명된 대로 시간이 지남에 따라 트래픽이 증가하면 STATE_RUNNING으로 다시 변경될 수 있습니다.