누적된 도로 데이터

누적된 도로 데이터는 선택한 경로에 대해 시간이 지남에 따라 빌드할 수 있는 데이터를 의미합니다. Roads Selection API로 경로를 만들면 데이터 수신이 시작됩니다. 이 데이터는 심층 분석, 전략적 계획, 경로의 장기적 동작 이해에 사용할 수 있습니다.

누적된 도로 데이터는 각 경로의 이동 시간, 속도 읽기 간격 (SRI), 경로 지오메트리를 포함하는 시계열 데이터로 제공됩니다. 이 데이터는 BigQuery를 통해 저장되고 액세스됩니다.

BigQuery 설정하기

BigQuery에서 도로 데이터에 액세스하려면 먼저 Google Cloud 프로젝트를 설정하고 데이터 거래소를 구독해야 합니다.

기본 요건

Google Cloud 프로젝트 및 계정에 다음 구성이 있는지 확인합니다.

  1. BigQuery API를 사용 설정합니다. 안내는 Google Cloud 콘솔로 공개 데이터 세트 쿼리를 참고하세요.
  2. Analytics Hub API를 사용 설정합니다. Analytics Hub API를 참고하세요.
  3. 필요한 IAM 역할을 부여합니다. 구독자 작업을 실행하고 데이터 세트를 만들려면 계정에 다음 역할이 있어야 합니다.

데이터 거래소 구독

도로 데이터는 BigQuery(Analytics Hub)의 비공개 데이터 거래소를 통해 공유됩니다. 데이터에 액세스하려면 Google 파트너로부터 특정 구독 링크를 받게 됩니다. 이 데이터 세트는 다음 이름 지정 규칙을 준수합니다.

historical_roads_data_PROJECT_NUMBER.

데이터를 구독하려면 다음 단계를 따르세요.

  1. Google 파트너가 제공한 구독 링크를 클릭합니다. 이 링크를 클릭하면 Google Cloud 콘솔의 데이터 거래소로 바로 이동합니다.
  2. Google Cloud 콘솔에서 데이터 거래소 세부정보를 검토합니다.
  3. 대화상자에서 구독 버튼을 클릭합니다.
  4. 구독이 완료되면 연결된 데이터 세트가 Google Cloud 콘솔의 BigQuery 탐색기 패널에 표시됩니다. 이제 탐색기 패널에 표시된 테이블 이름을 사용하여 SQL 쿼리의 데이터에 액세스할 수 있습니다.

BigQuery 테이블

선택한 경로의 누적된 도로 데이터는 Google 소유 클라우드 프로젝트의 격리된 BigQuery 데이터 세트에서 호스팅됩니다. BigQuery 공유(Analytics Hub)에서 독점적으로 생성된 비공개 데이터 거래소를 통해 공유됩니다. 데이터에 액세스하려면 데이터 거래소를 구독하고 Google Cloud 프로젝트에서 연결된 데이터 세트를 만들어야 합니다.

공유 BigQuery 데이터 세트에는 Google에서 정의하고 만든 몇 가지 BigQuery 테이블이 포함되어 있습니다. 각 테이블의 세부정보는 다음과 같습니다.

historical_travel_time 테이블

다음은 BigQuery 테이블 historical_travel_time의 스키마입니다.

이름 모드 유형 설명
selected_route_id null 허용 STRING 경로의 selected_route_id
display_name null 허용 STRING 경로의 표시 이름
record_time null 허용 TIMESTAMP 경로 데이터가 계산되는 타임스탬프
duration_in_seconds null 허용 FLOAT 트래픽을 인식하는 경로의 기간
static_duration_in_seconds null 허용 FLOAT 트래픽을 인식하지 않는 경로의 기간
route_geometry null 허용 GEOGRAPHY 트래픽을 인식하는 경로의 폴리라인 지오메트리

테이블 동작 및 사실

  • 테이블은 날짜별로 파티션이 나뉘며 각 파티션에 10년의 만료 시간이 설정되어 있습니다.
  • 테이블은 일괄 처리로 작성된 최신 트래픽 데이터로 매시간 업데이트됩니다.
  • Roads Selection API에서 새 경로를 만든 후 이 테이블에서 데이터를 사용할 수 있을 때까지 최대 1시간이 걸릴 수 있습니다.
  • Roads Selection API에서 경로를 삭제하면 경로에 대해 이 테이블에 새 데이터가 작성되지 않습니다. 하지만 이전 데이터는 만료될 때까지 유지됩니다.

recent_roads_data 테이블

참고: 이 테이블은 계약에 실시간 도로 데이터가 포함된 경우에만 사용할 수 있습니다.

historical_travel_time과 달리 이 테이블에는 SpeedReadingInterval 데이터도 포함되어 있습니다. 다음은 BigQuery의 스키마입니다.

이름 모드 유형 설명
selected_route_id null 허용 STRING 경로의 selected_route_id
display_name null 허용 STRING 경로의 표시 이름
record_time null 허용 TIMESTAMP 경로 데이터가 계산되는 타임스탬프
duration_in_seconds null 허용 FLOAT 트래픽을 인식하는 경로의 기간
static_duration_in_seconds null 허용 FLOAT 트래픽을 인식하지 않는 경로의 기간
route_geometry null 허용 GEOGRAPHY 트래픽을 인식하는 경로의 폴리라인 지오메트리
speed_reading_intervals REPEATED RECORD 경로 전반의 트래픽 밀도를 나타내는 간격입니다. Routes API의 원래 정의를 참고하세요.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY 이 간격의 지오메트리
speed_reading_intervals.speed null 허용 STRING 이 간격의 속도 분류입니다. 가능한 값: NORMAL, SLOW, TRAFFIC_JAM

테이블 동작 및 사실

  • 테이블은 날짜별로 파티션이 나뉘며 각 파티션에 60일의 만료 시간이 설정되어 있습니다.
  • 테이블은 일괄 처리로 작성된 최신 트래픽 데이터로 매시간 업데이트됩니다.
  • Roads Selection API에서 새 경로를 만든 후 이 테이블에서 데이터를 사용할 수 있을 때까지 최대 1시간이 걸릴 수 있습니다.
  • Roads Selection API에서 경로를 삭제하면 경로에 대해 이 테이블에 새 데이터가 작성되지 않습니다. 하지만 이전 데이터는 만료될 때까지 유지됩니다.

routes_status 테이블

테이블에는 선택한 경로 메타데이터 및 상태 정보가 포함되어 있습니다. 모든 경로와 상태를 더 쉽게 볼 수 있도록 하는 것이 목표입니다. 데이터 필터링을 위해 다른 두 테이블과 조인할 수 있습니다. 다음은 BigQuery의 스키마입니다.

이름 모드 유형 설명
selected_route_id null 허용 STRING 경로의 selected_route_id
display_name null 허용 STRING 경로의 표시 이름
status* null 허용 STRING 경로의 상태
validation_error null 허용 STRING 유효성 검사 오류 경로
low_road_usage_start_time null 허용 TIMESTAMP 재검증 중에 경로에서 처음으로 낮은 도로 사용량이 관찰된 시간입니다. VALIDATION_ERROR_LOW_ROAD_USAGE와 연결되어 있습니다.
route_attributes null 허용 STRING 선택한 경로의 맞춤 속성

*이 테이블의 경로 상태는 STATE_ 대신 STATUS_로 시작합니다. 그 외에는 Roads Selection API와 일관됩니다.

테이블 동작 및 사실

  • STATUS_RUNNING 또는 STATUS_INVALID 상태의 경로만 이 테이블에 포함됩니다.
  • 경로 메타데이터 및 상태는 매시간 중단 없이 업데이트됩니다.
  • Roads Selection API에서 새 경로를 만든 후 이 테이블에서 경로를 사용할 수 있을 때까지 최대 1시간이 걸릴 수 있습니다.
  • Roads Selection API에서 경로를 삭제하면 이 테이블에서 선택한 경로가 삭제될 때까지 최대 1시간이 걸릴 수 있습니다.