Dữ liệu đường tích luỹ là dữ liệu mà bạn có thể xây dựng theo thời gian cho các tuyến đường đã chọn. Bạn sẽ bắt đầu nhận được dữ liệu sau khi tạo một tuyến đường bằng Roads Selection API. Sau đó, dữ liệu này có thể được dùng để phân tích chuyên sâu, lập kế hoạch chiến lược và hiểu rõ hành vi dài hạn của các tuyến đường.
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 gian di chuyển, khoảng thời gian đọc tốc độ (SRI) và hình học tuyến đường cho từng tuyến đường. Dữ liệu này được lưu trữ và truy cập thông qua BigQuery.
Thiết lập BigQuery
Trước khi có thể truy cập vào dữ liệu đường 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 của bạn trên Google Cloud 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 bảng điều khiển Cloud.
- Bật Analytics Hub API. Xem Analytics Hub API.
- Cấp các vai trò IAM cần thiết. Đảm bảo tài khoản của bạn có các vai trò sau đây để thực hiện các tác vụ của người đăng ký và tạo tập dữ liệu:
- Người đăng ký Analytics Hub (
roles/analyticshub.subscriber) - Người dùng BigQuery (
roles/bigquery.user)
- Người đăng ký Analytics Hub (
Đăng ký trao đổi dữ liệu
Dữ liệu đường của bạn được chia sẻ thông qua một hoạt động trao đổi dữ liệu riêng tư trong BigQuery (Analytics Hub). 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 theo quy ước đặt tên sau:
historical_roads_data_PROJECT_NUMBER.
Cách đăng ký 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 trực tiếp đến hoạt động trao đổi dữ liệu trong bảng điều khiển Cloud của Google.
- Trong bảng điều khiển Cloud, hãy xem thông tin chi tiết về hoạt động trao đổi dữ liệu.
- Nhấp vào nút Subscribe (Đăng ký) trong hộp thoại.
- Khi quá trình đăng ký hoàn tất, 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 bảng điều khiển Google Cloud. Giờ đây, bạn có thể sử dụng tên bảng hiển thị trong bảng điều khiển Explorer (Trình khám phá) để truy cập vào dữ liệu trong các truy vấn SQL.
Bảng BigQuery
Dữ liệu đường tích luỹ của các tuyến đường đã 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 hoạt động trao đổi dữ liệu riêng tư được tạo riêng cho bạn trong tính năng chia sẻ BigQuery (Analytics Hub). Để truy cập vào dữ liệu, bạn cần đăng ký trao đổi dữ liệu và tạo tập dữ liệu được liên kết trong dự án trên đám mây của mình 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 của 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 | NULLABLE | STRING | selected_route_id của tuyến đường |
| display_name | NULLABLE | STRING | Tên hiển thị của tuyến đường |
| record_time | NULLABLE | TIMESTAMP | Dấu thời gian khi dữ liệu tuyến đường được tính toán |
| duration_in_seconds | NULLABLE | FLOAT | Thời lượng của tuyến đường có tính đến tình hình giao thông |
| static_duration_in_seconds | NULLABLE | FLOAT | Thời lượng của tuyến đường không tính đến tình hình giao thông |
| route_geometry | NULLABLE | GEOGRAPHY | Hình học đường thẳng có tính đến tình hình giao thông của tuyến đường |
Hành vi và thông tin về bảng
- Bảng được phân vùng theo ngày và có thời gian hết hạn là 10 năm cho mỗi phân vùng.
- Bảng được cập nhật mỗi giờ bằng dữ liệu giao thông 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 phải đợi tối đa 1 giờ để xem dữ liệu có trong bảng này.
- Sau khi xoá một tuyến đường khỏi Roads Selection API, không có dữ liệu mới nào được ghi vào bảng này cho tuyến đường đó. Tuy nhiên, dữ liệu trong quá khứ vẫn còn cho đến khi hết hạn.
Bảng recent_roads_data
Lưu ý: Bảng này chỉ có 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 chứa dữ liệu SpeedReadingInterval. Sau đây là giản đồ trong BigQuery:
| Tên | Chế độ | Loại | Mô tả |
|---|---|---|---|
| selected_route_id | NULLABLE | STRING | selected_route_id của tuyến đường |
| display_name | NULLABLE | STRING | Tên hiển thị của tuyến đường |
| record_time | NULLABLE | TIMESTAMP | Dấu thời gian khi dữ liệu tuyến đường được tính toán |
| duration_in_seconds | NULLABLE | FLOAT | Thời lượng của tuyến đường có tính đến tình hình giao thông |
| static_duration_in_seconds | NULLABLE | FLOAT | Thời lượng của tuyến đường không tính đến tình hình giao thông |
| route_geometry | NULLABLE | GEOGRAPHY | Hình học đường thẳng có tính đến tình hình giao thông của tuyến đường |
| speed_reading_intervals | REPEATED | RECORD | Khoảng thời gian biểu thị mật độ giao thông trên tuyến đường. Xem định nghĩa ban đầu trong Routes API |
| speed_reading_intervals.interval_coordinates | REPEATED | GEOGRAPHY | Hình học cho khoảng thời gian này |
| speed_reading_intervals.speed | NULLABLE | STRING | Phân loại tốc độ cho khoảng thời gian này. Các giá trị có thể sử dụng: NORMAL, SLOW, TRAFFIC_JAM |
Hành vi và thông tin về bảng
- Bảng được phân vùng theo ngày và có thời gian hết hạn là 60 ngày cho mỗi phân vùng.
- Bảng được cập nhật mỗi giờ bằng dữ liệu giao thông 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 phải đợi tối đa 1 giờ để xem dữ liệu có trong bảng này.
- Sau khi xoá một tuyến đường khỏi Roads Selection API, không có dữ liệu mới nào được ghi vào bảng này cho tuyến đường đó. Tuy nhiên, dữ liệu trong quá khứ vẫn còn cho đến khi hết hạn.
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 đường đã chọn. Mục đích của bảng này 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 2 bảng còn lại để lọc dữ liệu. Sau đây là giản đồ trong BigQuery:
| Tên | Chế độ | Loại | Mô tả |
|---|---|---|---|
| selected_route_id | NULLABLE | STRING | selected_route_id của tuyến đường |
| display_name | NULLABLE | STRING | Tên hiển thị của tuyến đường |
| trạng thái* | NULLABLE | STRING | Trạng thái của tuyến đường |
| validation_error | NULLABLE | STRING | Lỗi xác thực của tuyến đường |
| low_road_usage_start_time | NULLABLE | TIMESTAMP | Thời điểm tuyến đường lần đầu tiên quan sát thấy mức sử dụng đường thấp trong quá trình xác thực lại. Trạng thái này được liên kết với VALIDATION_ERROR_LOW_ROAD_USAGE. |
| route_attributes | NULLABLE | STRING | Thuộc tính tuỳ chỉnh cho tuyến đường đã chọn |
*Trạng thái tuyến đường trong bảng này bắt đầu bằng STATUS_ thay vì STATE_. Trạng thái này nhất quán với Roads Selection API.
Hành vi và thông tin về bảng
- Chỉ những tuyến đường có 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 các 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 phải đợi tối đa 1 giờ để xem tuyến đường có trong bảng này.
- Sau khi xoá một tuyến đường khỏi Roads Selection API, bạn phải đợi tối đa 1 giờ để thấy tuyến đường đã chọn bị xoá khỏi bảng này.