이 페이지는 Cloud Translation API를 통해 번역되었습니다.

경로 유효성 검사 이해

경로를 만들면 Roads Selection API에서 검증 프로세스를 실행합니다. 이 검증을 통해 도로 관리 통계 내에서 데이터 수집 및 업데이트에 적합한 경로인지 확인할 수 있습니다. 이 프로세스는 일반적으로 몇 분 내에 완료됩니다.

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

경로 상태

SelectedRoute 리소스의 state 필드는 현재 유효성 검사 및 작동 상태를 나타냅니다. 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으로 다시 변경될 수 있습니다.