Dữ liệu đường tích luỹ được cung cấp dưới dạng dữ liệu chuỗi thời gian, bao gồm:
- Thời lượng chuyến đi
- Khoảng thời gian đọc nhanh (SRI)
- Hình dạng tuyến đường
Thiết lập BigQuery
Trước khi có thể truy cập vào dữ liệu đường bộ trong BigQuery, bạn phải thiết lập dự án trên đám mây của Google Cloud và đăng ký trao đổi dữ liệu.
Điều kiện tiên quyết
Đảm bảo dự án trên đám mây và tài khoản Google Cloud của bạn có các cấu hình sau:
- Bật BigQuery API. Để biết hướng dẫn, hãy xem bài viết Truy vấn tập dữ liệu công khai bằng Google Cloud Console.
- Bật Analytics Hub API. Xem Trung tâm phân tích.
- Cấp các vai trò cần thiết trong IAM. Đảm bảo tài khoản của bạn có các vai trò sau để thực hiện các nhiệm vụ của người đăng ký và tạo tập dữ liệu:
- Người đăng ký Trung tâm phân tích
(
roles/analyticshub.subscriber)- Người dùng BigQuery
(
roles/bigquery.user)
- Người dùng BigQuery
(
Đăng ký trao đổi dữ liệu
Dữ liệu đường của bạn được chia sẻ với bạn thông qua một sàn giao dịch dữ liệu riêng tư trong BigQuery (Trung tâm phân tích). Bạn sẽ nhận được một đường liên kết đăng ký cụ thể từ một đối tác của Google để truy cập vào dữ liệu của mình. Tập dữ liệu này tuân thủ quy ước đặt tên sau:
historical_roads_data_PROJECT_NUMBER.
Cách đăng ký nhận dữ liệu:
- Nhấp vào đường liên kết để đăng ký do đối tác của Google cung cấp. Đường liên kết này sẽ đưa bạn đến thẳng trang trao đổi dữ liệu trong Google Cloud Console.
- Trong Google Cloud Console, hãy xem thông tin chi tiết về hoạt động trao đổi dữ liệu.
- Nhấp vào nút Đăng ký trong hộp thoại.
- Khi bạn hoàn tất việc đăng ký, tập dữ liệu được liên kết sẽ xuất hiện trong bảng điều khiển Explorer (Trình khám phá) của BigQuery trong Google Cloud Console. Giờ đây, bạn có thể sử dụng tên bảng hiển thị trong bảng điều khiển Explorer để truy cập vào dữ liệu trong các truy vấn SQL.
Bảng BigQuery
Dữ liệu đường đi tích luỹ của các tuyến đường bạn chọn được lưu trữ trong một tập dữ liệu BigQuery riêng biệt của một dự án trên đám mây do Google sở hữu. Dữ liệu này được chia sẻ với bạn thông qua một sàn giao dịch dữ liệu riêng tư được tạo riêng cho bạn trong tính năng chia sẻ của BigQuery (Trung tâm phân tích). Để truy cập vào dữ liệu, bạn cần đăng ký trao đổi dữ liệu và tạo một tập dữ liệu được liên kết trong dự án trên đám mây của bạn trên Google Cloud.
Tập dữ liệu BigQuery được chia sẻ bao gồm một vài bảng BigQuery do Google xác định và tạo. Sau đây là thông tin chi tiết về từng bảng.
Bảng historical_travel_time
Sau đây là giản đồ cho bảng BigQuery historical_travel_time:
| Tên | Chế độ | Loại | Mô tả |
|---|---|---|---|
| selected_route_id | CÓ THỂ RỖNG | STRING | selected_route_id của tuyến đường |
| tên hiển thị | CÓ THỂ RỖNG | STRING | Tên hiển thị của tuyến đường |
| record_time | CÓ THỂ RỖNG | DẤU THỜI GIAN | Dấu thời gian khi dữ liệu tuyến đường được tính toán |
| duration_in_seconds | CÓ THỂ RỖNG | FLOAT | Thời lượng của tuyến đường có tính đến tình hình giao thông. Bỏ qua (NULL)
khi has_road_closure là true. |
| static_duration_in_seconds | CÓ THỂ RỖNG | FLOAT | Thời gian di chuyển trên tuyến đường khi không tính đến tình hình giao thông |
| route_geometry | CÓ THỂ RỖNG | KHU VỰC ĐỊA LÝ | Hình học nhiều đường có tính đến tình hình giao thông của tuyến đường |
| road_segment_ids | LẶP LẠI | STRING | Các đoạn đường dọc theo tuyến đường, được biểu thị dưới dạng Mã địa điểm |
| has_road_closure | CÓ THỂ RỖNG | BOOLEAN | Liệu có đoạn đường nào bị đóng hoàn toàn trên tuyến đường hay không. Khi true,
duration_in_seconds bị bỏ qua (NULL) vì
tuyến đường không thể đi qua. Giá trị NULL cho biết thông tin về việc đóng đường chưa được xác định. |
Hành vi và thông tin thực tế về bảng
- Bảng được phân vùng theo ngày và có thời hạn 10 năm cho mỗi phân vùng.
- Bảng này được cập nhật hằng giờ bằng dữ liệu lưu lượng truy cập mới nhất được ghi theo lô.
- Sau khi tạo một tuyến đường mới trong Roads Selection API, bạn có thể phải đợi tối đa 1 giờ mới thấy dữ liệu trong bảng này.
- Sau khi một tuyến đường bị xoá khỏi Roads Selection API, hệ thống sẽ không ghi dữ liệu mới vào bảng này cho tuyến đường đó. Tuy nhiên, dữ liệu trong quá khứ vẫn được lưu giữ cho đến khi hết hạn.
- Các đoạn đường dọc theo tuyến đường tuân theo thứ tự cấu trúc liên kết và luôn được kết nối.
- Cờ
has_road_closurenhất quán với trạng thái đường bị đóng hoàn toàn trên Google Maps.
Bảng recent_roads_data
Lưu ý: Bảng này chỉ có sẵn khi hợp đồng của bạn bao gồm Dữ liệu đường theo thời gian thực.
Khác với historical_travel_time, bảng này cũng lưu giữ các khoảng thời gian đọc tốc độ dựa trên độ lệch (speed reading intervals) (speed_reading_offsets) và các khoảng thời gian đọc tốc độ dựa trên toạ độ cũ (speed_reading_intervals). Sau đây là giản đồ trong BigQuery:
| Tên | Chế độ | Loại | Mô tả |
|---|---|---|---|
| selected_route_id | CÓ THỂ RỖNG | STRING | selected_route_id của tuyến đường |
| tên hiển thị | CÓ THỂ RỖNG | STRING | Tên hiển thị của tuyến đường |
| record_time | CÓ THỂ RỖNG | DẤU THỜI GIAN | Dấu thời gian khi dữ liệu tuyến đường được tính toán |
| duration_in_seconds | CÓ THỂ RỖNG | FLOAT | Thời lượng của tuyến đường có tính đến tình hình giao thông. Bỏ qua (NULL)
khi has_road_closure là true. |
| static_duration_in_seconds | CÓ THỂ RỖNG | FLOAT | Thời gian di chuyển trên tuyến đường khi không tính đến tình hình giao thông |
| route_geometry | CÓ THỂ RỖNG | KHU VỰC ĐỊA LÝ | Hình học nhiều đường có tính đến tình hình giao thông của tuyến đường |
| speed_reading_intervals | LẶP LẠI | RECORD | Khoảng thời gian đọc tốc độ dựa trên toạ độ cũ. Có thể ngừng được điền sớm nhất từ ngày 9 tháng 11 năm 2026. Thay vào đó, hãy sử dụng speed_reading_offsets. Hãy xem phần Khoảng thời gian đọc tốc độ. |
| speed_reading_intervals.interval_coordinates | LẶP LẠI | KHU VỰC ĐỊA LÝ | Cũ. Có thể ngừng được điền sớm nhất từ ngày 9 tháng 11 năm 2026. Thay vào đó, hãy sử dụng speed_reading_offsets. Hình học cho khoảng thời gian này |
| speed_reading_intervals.speed | CÓ THỂ RỖNG | STRING | Cũ. Có thể ngừng được điền sớm nhất từ ngày 9 tháng 11 năm 2026. Thay vào đó, hãy sử dụng speed_reading_offsets. Phân loại tốc độ cho khoảng thời gian này. Các giá trị có thể có: NORMAL, SLOW, TRAFFIC_JAM. Trong trường cũ này, tình trạng tắc nghẽn giao thông nghiêm trọng (màu đỏ đậm) cũng được báo cáo là TRAFFIC_JAM; TRAFFIC_JAM_HEAVY không bao giờ được sử dụng. |
| road_segment_ids | LẶP LẠI | STRING | Các đoạn đường dọc theo tuyến đường, được biểu thị dưới dạng Mã địa điểm |
| speed_reading_offsets | LẶP LẠI | RECORD | Khoảng thời gian đọc tốc độ dựa trên độ lệch thể hiện mật độ giao thông
trên toàn tuyến đường; mỗi khoảng thời gian được phân định bằng độ lệch khoảng cách
từ điểm bắt đầu của tuyến đường. Bỏ qua khi has_road_closure là true. Hãy xem phần Khoảng thời gian đọc tốc độ. |
| speed_reading_offsets.start_offset | CÓ THỂ RỖNG | INTEGER | Khoảng cách tính từ điểm bắt đầu của tuyến đường (tính bằng mét) cho điểm bắt đầu của khoảng thời gian (bao gồm cả điểm này) |
| speed_reading_offsets.end_offset | CÓ THỂ RỖNG | INTEGER | Khoảng cách tính từ điểm bắt đầu của tuyến đường (tính bằng mét) cho đến điểm kết thúc của khoảng thời gian (không bao gồm; bằng start_offset của khoảng thời gian tiếp theo) |
| speed_reading_offsets.speed | CÓ THỂ RỖNG | STRING | Phân loại tốc độ cho khoảng thời gian này, phù hợp với màu sắc trong lớp giao thông của Google Maps. Các giá trị có thể có: NORMAL (màu xanh lục), SLOW (màu vàng), TRAFFIC_JAM (màu đỏ), TRAFFIC_JAM_HEAVY (màu đỏ đậm, có hiệu lực từ ngày 8 tháng 10 năm 2026) |
| has_road_closure | CÓ THỂ RỖNG | BOOLEAN | Liệu có đoạn đường nào bị đóng hoàn toàn trên tuyến đường hay không. Khi true,
duration_in_seconds và speed_reading_offsets
bị bỏ qua vì không thể đi qua tuyến đường này. Giá trị NULL cho biết thông tin về việc đường bị đóng chưa được xác định. |
Hành vi và thông tin thực tế về bảng
- Bảng được phân vùng theo ngày và có thời hạn 60 ngày cho mỗi phân vùng.
- Bảng này được cập nhật hằng giờ bằng dữ liệu lưu lượng truy cập mới nhất được ghi theo lô.
- Sau khi tạo một tuyến đường mới trong Roads Selection API, bạn có thể phải đợi tối đa 1 giờ mới thấy dữ liệu trong bảng này.
- Sau khi một tuyến đường bị xoá khỏi Roads Selection API, dữ liệu mới sẽ không được ghi vào bảng này cho tuyến đường đó. Tuy nhiên, dữ liệu trong quá khứ vẫn được lưu giữ cho đến khi hết hạn.
- Các đoạn đường dọc theo tuyến đường tuân theo thứ tự cấu trúc liên kết và luôn được kết nối.
- Cột
speed_reading_offsetsđược điền sẵn cho các hàng được ghi lại vào hoặc sau ngày 8 tháng 10 năm 2026. Các hàng trước đó có mảng trống. - Cột
speed_reading_intervalscũ có thể ngừng được điền dữ liệu vào hoặc sau ngày 9 tháng 11 năm 2026. Thay vào đó, hãy sử dụngspeed_reading_offsets. - Cờ
has_road_closurenhất quán với trạng thái đường bị đóng hoàn toàn trên Google Maps.
Bảng routes_status
Bảng này chứa siêu dữ liệu và thông tin trạng thái của các tuyến đã chọn. Mục đích là để cung cấp một cách dễ dàng hơn để xem tất cả các tuyến đường và trạng thái. Bạn có thể kết hợp bảng này với hai bảng còn lại để lọc dữ liệu. Dưới đây là giản đồ trong BigQuery:
| Tên | Chế độ | Loại | Mô tả |
|---|---|---|---|
| selected_route_id | CÓ THỂ RỖNG | STRING | selected_route_id của tuyến đường |
| tên hiển thị | CÓ THỂ RỖNG | STRING | Tên hiển thị của tuyến đường |
| status* | CÓ THỂ RỖNG | STRING | Trạng thái của tuyến đường |
| validation_error | CÓ THỂ RỖNG | STRING | Lỗi xác thực của tuyến đường |
| low_road_usage_start_time | CÓ THỂ RỖNG | DẤU THỜI GIAN | Thời điểm tuyến đường lần đầu tiên được ghi nhận là có mức sử dụng đường thấp trong quá trình xác thực lại. Lỗi này liên quan đến VALIDATION_ERROR_LOW_ROAD_USAGE. |
| route_attributes | CÓ THỂ RỖNG | STRING | Thuộc tính tuỳ chỉnh cho tuyến đường đã chọn |
| dynamic_routing | CÓ THỂ RỖNG | BOOLEAN | Cho biết tuyến đường là động (true) hay cố định (false). Xem dynamicRouting. |
| nguồn gốc | CÓ THỂ RỖNG | KHU VỰC ĐỊA LÝ | Điểm tham chiếu xuất phát của tuyến đường |
| tài khoản đích | CÓ THỂ RỖNG | KHU VỰC ĐỊA LÝ | Điểm tham chiếu đích của tuyến đường |
| trung gian | LẶP LẠI | KHU VỰC ĐỊA LÝ | Điểm tham chiếu trung gian của tuyến đường |
| static_route_geometry | CÓ THỂ RỖNG | KHU VỰC ĐỊA LÝ | Hình học đa tuyến của tuyến đường tĩnh được tính toán mà không có lưu lượng truy cập trực tiếp từ các điểm tham chiếu |
| road_segment_ids | LẶP LẠI | STRING | Các đoạn đường dọc theo tuyến đường tĩnh được tính toán mà không có thông tin giao thông trực tiếp, được biểu thị dưới dạng Mã địa điểm |
Hành vi và thông tin thực tế về bảng
- Chỉ những tuyến đường ở trạng thái STATUS_RUNNING hoặc STATUS_INVALID mới được đưa vào bảng này.
- Siêu dữ liệu và trạng thái của tuyến đường được cập nhật liên tục mỗi giờ.
- Sau khi tạo một tuyến đường mới trong Roads Selection API, bạn có thể phải đợi tối đa 1 giờ để thấy tuyến đường đó trong bảng này.
- Sau khi một tuyến đường bị xoá khỏi Roads Selection API, bạn có thể phải đợi tối đa 1 giờ để thấy tuyến đường đã chọn bị xoá khỏi bảng này.
- Đối với các tuyến đường cố định (
dynamic_routing: false), Mã địa điểm trongroad_segment_idssẽ tự động cập nhật để phản ánh các thay đổi trong mạng lưới đường bộ của Google trong khi vẫn thể hiện cùng một tuyến đường. Đối với các tuyến động (dynamic_routing: true),road_segment_idskhông được cập nhật.