누적된 도로 데이터는 시계열 데이터로 제공되며 다음이 포함됩니다.
- 여행 기간
- 속도 측정 간격 (SRI)
- 경로 도형
BigQuery 설정하기
BigQuery에서 도로 데이터에 액세스하려면 먼저 Google Cloud 프로젝트를 설정하고 데이터 교환을 구독해야 합니다.
기본 요건
Google Cloud 프로젝트 및 계정에 다음 구성이 있는지 확인합니다.
- BigQuery API를 사용 설정합니다. 자세한 내용은 Google Cloud 콘솔로 공개 데이터 세트 쿼리를 참조하세요.
- Analytics Hub API를 사용 설정합니다. thought Analytics Hub API를 참조하세요.
- 필요한 IAM 역할을 부여합니다. 구독자 작업을 수행하고 데이터 세트를 만들려면 계정에 다음 역할이 있어야 합니다.
- Analytics Hub 구독자(
roles/analyticshub.subscriber)- BigQuery 사용자(
roles/bigquery.user)
- BigQuery 사용자(
데이터 교환 구독
도로 데이터는 BigQuery(Analytics Hub)의 비공개 데이터 교환을 통해 공유됩니다. Google 파트너로부터 데이터에 액세스할 수 있는 특정 구독 링크를 받게 됩니다. 이 데이터 세트는 다음 이름 지정 규칙을 따릅니다.
historical_roads_data_PROJECT_NUMBER.
데이터를 구독하려면 다음 안내를 따르세요.
- Google 파트너가 제공한 구독 링크를 클릭합니다. 이 링크를 클릭하면 Google Cloud 콘솔의 데이터 교환으로 바로 이동합니다.
- Google Cloud 콘솔에서 데이터 교환 세부정보를 검토합니다.
- 대화상자에서 구독 버튼을 클릭합니다.
- 구독이 완료되면 연결된 데이터 세트가 Google Cloud 콘솔의 BigQuery 탐색기 패널에 표시됩니다. 이제 탐색기 패널에 표시된 테이블 이름을 사용하여 SQL 쿼리의 데이터에 액세스할 수 있습니다.
BigQuery 테이블
선택한 경로의 누적 도로 데이터는 Google 소유 클라우드 프로젝트의 격리된 BigQuery 데이터 세트에서 호스팅됩니다. 이 데이터 세트는 BigQuery Sharing(Analytics Hub)에서 귀하만을 위해 생성된 비공개 데이터 교환을 통해 귀하와 공유됩니다. 데이터에 액세스하려면 데이터 교환을 구독하고 Google Cloud 프로젝트에서 연결된 데이터 세트를 만들어야 합니다.
공유 BigQuery 데이터 세트에는 Google에서 정의하고 만든 몇 가지 BigQuery 테이블이 포함되어 있습니다. 다음은 각 테이블의 세부정보입니다.
테이블 historical_travel_time개
다음은 BigQuery 테이블 historical_travel_time의 스키마입니다.
| 이름 | 모드 | 유형 | 설명 |
|---|---|---|---|
| selected_route_id | null 허용 | 문자열 | 경로의 selected_route_id |
| display_name | null 허용 | 문자열 | 경로의 표시 이름 |
| record_time | null 허용 | TIMESTAMP | 경로 데이터가 계산된 시점의 타임스탬프입니다. |
| duration_in_seconds | null 허용 | FLOAT | 경로의 트래픽 인식 소요 시간입니다. has_road_closure가 true인 경우 생략됩니다 (NULL). |
| static_duration_in_seconds | null 허용 | FLOAT | 경로의 교통정보를 고려하지 않은 소요 시간 |
| route_geometry | null 허용 | GEOGRAPHY | 경로의 교통정보를 반영한 다중선 도형 |
| road_segment_ids | REPEATED | 문자열 | 경로를 따라 있는 도로 세그먼트(장소 ID로 표시됨) |
| has_road_closure | null 허용 | 부울 | 경로에 도로가 완전히 폐쇄된 구간이 있는지 여부입니다. true인 경우 경로를 통과할 수 없으므로 duration_in_seconds가 생략됩니다 (NULL). NULL 값은 도로 폐쇄 정보가 결정되지 않았음을 나타냅니다. |
표 동작 및 사실
- 테이블은 날짜별로 파티션을 나누고 각 파티션에 대해 10년 만료가 설정됩니다.
- 테이블은 일괄로 작성된 최신 트래픽 데이터로 매시간 업데이트됩니다.
- Roads Selection API에서 새 경로가 생성되면 이 테이블에서 데이터를 사용할 수 있을 때까지 최대 1시간이 걸릴 수 있습니다.
- Roads Selection API에서 경로가 삭제되면 이 테이블에 경로에 대한 새 데이터가 기록되지 않습니다. 하지만 이전 데이터는 만료될 때까지 유지됩니다.
- 경로를 따라 있는 도로 세그먼트는 위상 순서를 따르며 항상 연결되어 있습니다.
has_road_closure플래그는 Google 지도의 전체 도로 폐쇄 상태와 일치하며과 일치합니다.
테이블 recent_roads_data개
참고: 이 표는 계약에 실시간 도로 데이터가 포함된 경우에만 사용할 수 있습니다.
historical_travel_time와 달리 이 테이블에는 오프셋 기반 속도 판독 간격(speed_reading_offsets)과 기존 좌표 기반 속도 판독 간격(speed_reading_intervals)도 포함됩니다. BigQuery의 스키마는 다음과 같습니다.
| 이름 | 모드 | 유형 | 설명 |
|---|---|---|---|
| selected_route_id | null 허용 | 문자열 | 경로의 selected_route_id |
| display_name | null 허용 | 문자열 | 경로의 표시 이름 |
| record_time | null 허용 | TIMESTAMP | 경로 데이터가 계산된 시점의 타임스탬프입니다. |
| duration_in_seconds | null 허용 | FLOAT | 경로의 트래픽 인식 소요 시간입니다. has_road_closure가 true인 경우 생략됩니다 (NULL). |
| static_duration_in_seconds | null 허용 | FLOAT | 경로의 교통정보를 고려하지 않은 소요 시간 |
| route_geometry | null 허용 | GEOGRAPHY | 경로의 교통정보를 반영한 다중선 도형 |
| speed_reading_intervals | REPEATED | 레코드 | 기존 좌표 기반 속도 읽기 간격입니다. 2026년 11월 9일 이후에 채워지지 않을 수 있습니다. 대신 speed_reading_offsets를 사용하세요. 속도 읽기 간격을 참고하세요. |
| speed_reading_intervals.interval_coordinates | REPEATED | GEOGRAPHY | 기존. 2026년 11월 9일 이후에 채워지지 않을 수 있습니다. 대신 speed_reading_offsets를 사용하세요. 이 간격의 도형입니다. |
| speed_reading_intervals.speed | null 허용 | 문자열 | 기존. 2026년 11월 9일 이후에 채워지지 않을 수 있습니다. 대신 speed_reading_offsets를 사용하세요. 이 간격의 속도 분류입니다. 가능한 값: NORMAL, SLOW, TRAFFIC_JAM 이 기존 필드에서는 심각한 교통 체증 (진한 빨간색)도 TRAFFIC_JAM으로 보고되며 TRAFFIC_JAM_HEAVY는 사용되지 않습니다. |
| road_segment_ids | REPEATED | 문자열 | 경로를 따라 있는 도로 세그먼트(장소 ID로 표시됨) |
| speed_reading_offsets | REPEATED | 레코드 | 경로의 교통 밀도를 나타내는 오프셋 기반 속도 판독 간격입니다. 각 간격은 경로 시작 지점으로부터의 거리 오프셋으로 구분됩니다. has_road_closure이 true인 경우 생략됩니다. 속도 읽기 간격을 참고하세요. |
| speed_reading_offsets.start_offset | null 허용 | 정수 | 간격의 시작(포함)에 대한 경로 시작 지점으로부터의 거리 오프셋(미터)입니다. |
| speed_reading_offsets.end_offset | null 허용 | 정수 | 간격의 끝에 대해 경로 시작 지점으로부터의 거리 오프셋 (미터 단위, 제외, 후속 간격의 start_offset와 동일) |
| speed_reading_offsets.speed | null 허용 | 문자열 | Google 지도 교통정보 레이어의 색상과 일치하는 이 구간의 속도 분류입니다. 가능한 값: NORMAL(녹색), SLOW (노란색), TRAFFIC_JAM (빨간색), TRAFFIC_JAM_HEAVY (진한 빨간색, 2026년 10월 8일부터 사용 가능) |
| has_road_closure | null 허용 | 부울 | 경로에 도로가 완전히 폐쇄된 구간이 있는지 여부입니다. true인 경우 경로를 통과할 수 없으므로 duration_in_seconds 및 speed_reading_offsets가 생략됩니다. NULL 값은 도로 폐쇄 정보가 확인되지 않았음을 나타냅니다. |
표 동작 및 사실
- 테이블은 날짜별로 파티션을 나누고 각 파티션에 대해 60일 만료 시간이 설정됩니다.
- 테이블은 일괄로 작성된 최신 트래픽 데이터로 매시간 업데이트됩니다.
- Roads Selection API에서 새 경로가 생성되면 이 테이블에서 데이터를 사용할 수 있을 때까지 최대 1시간이 걸릴 수 있습니다.
- Roads Selection API에서 경로가 삭제되면 이 테이블에 경로에 대한 새 데이터가 기록되지 않습니다. 하지만 이전 데이터는 만료될 때까지 유지됩니다.
- 경로를 따라 있는 도로 세그먼트는 위상 순서를 따르며 항상 연결되어 있습니다.
speed_reading_offsets열은 2026년 10월 8일 이후에 기록된 행에 채워집니다. 이전 행에는 빈 배열이 있습니다.- 기존
speed_reading_intervals열은 2026년 11월 9일 이후에 채워지지 않을 수 있습니다. 대신speed_reading_offsets를 사용합니다. has_road_closure플래그는 Google 지도의 전체 도로 폐쇄 상태와 일치하며과 일치합니다.
테이블 routes_status개
테이블에는 선택한 경로 메타데이터와 상태 정보가 포함됩니다. 모든 경로와 상태를 더 쉽게 볼 수 있는 방법을 제공하는 것이 목표입니다. 데이터 필터링을 위해 다른 두 테이블과 조인할 수 있습니다. BigQuery의 스키마는 다음과 같습니다.
| 이름 | 모드 | 유형 | 설명 |
|---|---|---|---|
| selected_route_id | null 허용 | 문자열 | 경로의 selected_route_id |
| display_name | null 허용 | 문자열 | 경로의 표시 이름 |
| status* | null 허용 | 문자열 | 경로의 상태 |
| validation_error | null 허용 | 문자열 | 경로의 유효성 검사 오류 |
| low_road_usage_start_time | null 허용 | TIMESTAMP | 재검증 중에 경로에서 도로 사용량이 처음으로 낮게 관찰된 시간입니다. VALIDATION_ERROR_LOW_ROAD_USAGE와 연결됩니다. |
| route_attributes | null 허용 | 문자열 | 선택한 경로의 맞춤 속성 |
| dynamic_routing | null 허용 | 부울 | 경로가 동적 (true)인지 고정(false)인지 나타냅니다. dynamicRouting를 참조하세요. |
| origin | null 허용 | GEOGRAPHY | 경로의 출발지 경유지 |
| destination | null 허용 | GEOGRAPHY | 경로의 목적지 경유지 |
| intermediates | REPEATED | GEOGRAPHY | 경로의 중간 경유지 |
| static_route_geometry | null 허용 | GEOGRAPHY | 경유지에서 실시간 교통정보 없이 계산된 정적 경로의 다중선 도형 |
| road_segment_ids | REPEATED | 문자열 | 실시간 교통정보 없이 계산된 정적 경로를 따라 장소 ID로 표시되는 도로 구간 |
표 동작 및 사실
- STATUS_RUNNING 또는 STATUS_INVALID 상태의 경로만 이 테이블에 포함됩니다.
- 경로 메타데이터와 상태는 매시간 중단 없이 업데이트됩니다.
- Roads Selection API에서 새 경로가 생성되면 이 표에 경로가 표시될 때까지 최대 1시간이 걸릴 수 있습니다.
- Roads Selection API에서 경로가 삭제되면 선택한 경로가 이 테이블에서 삭제되는 데 최대 1시간이 걸릴 수 있습니다.
- 고정 경로 (
dynamic_routing: false)의 경우road_segment_ids의 장소 ID가 자동으로 업데이트되어 Google 도로망의 변경사항을 반영하면서도 동일한 경로를 나타냅니다. 동적 경로(dynamic_routing: true)의 경우road_segment_ids가 업데이트되지 않습니다.