Data jalan yang dikumpulkan

Data jalan terakumulasi mengacu pada data yang dapat Anda buat dari waktu ke waktu untuk rute yang dipilih. Anda akan mulai menerima data setelah membuat rute dengan Roads Selection API. Data ini kemudian dapat digunakan untuk analisis mendalam, perencanaan strategis, dan pemahaman tentang perilaku jangka panjang rute.

Data jalan terakumulasi disediakan sebagai data deret waktu, yang mencakup:

  • Durasi perjalanan
  • Interval pembacaan kecepatan (SRI)
  • Geometri rute

Menyiapkan BigQuery

Sebelum dapat mengakses data jalan di BigQuery, Anda harus menyiapkan project Google Cloud dan berlangganan pertukaran data.

Prasyarat

Pastikan project dan akun Google Cloud Anda memiliki konfigurasi berikut:

  1. Aktifkan BigQuery API. Untuk mengetahui petunjuknya, lihat Membuat kueri set data publik dengan Konsol Google Cloud.
  2. Aktifkan Analytics Hub API. Lihat Analytics Hub API.
  3. Berikan peran IAM yang diperlukan. Pastikan akun Anda memiliki peran berikut untuk melakukan tugas pelanggan dan membuat set data:
  4. Pelanggan Analytics Hub (roles/analyticshub.subscriber)

Berlangganan pertukaran data

Data jalan Anda dibagikan kepada Anda melalui pertukaran data pribadi di BigQuery (Analytics Hub). Anda akan menerima link langganan tertentu dari partner Google untuk mengakses data Anda. Set data ini mematuhi konvensi penamaan berikut:

historical_roads_data_PROJECT_NUMBER.

Untuk berlangganan data Anda:

  1. Klik link langganan yang diberikan oleh partner Google Anda. Link ini akan mengarahkan Anda langsung ke pertukaran data di Konsol Google Cloud.
  2. Di Konsol Google Cloud, tinjau detail pertukaran data.
  3. Klik tombol Berlangganan di dialog.
  4. Setelah langganan selesai, set data tertaut akan muncul di panel Explorer BigQuery di Konsol Google Cloud. Sekarang Anda dapat menggunakan nama tabel yang ditampilkan di panel Explorer untuk mengakses data dalam kueri SQL.

Tabel BigQuery

Data jalan terakumulasi dari rute yang Anda pilih dihosting di set data BigQuery terisolasi dari project cloud milik Google. Data ini dibagikan kepada Anda melalui pertukaran data pribadi yang dibuat khusus untuk Anda di berbagi BigQuery (Analytics Hub). Untuk mengakses data, Anda harus berlangganan pertukaran data dan membuat set data tertaut di project Google Cloud Anda.

Set data BigQuery bersama mencakup beberapa tabel BigQuery yang ditentukan dan dibuat oleh Google. Berikut detail setiap tabel.

Tabel historical_travel_time

Berikut skema untuk tabel BigQuery historical_travel_time:

Nama Mode Jenis Deskripsi
selected_route_id NULLABLE STRING selected_route_id rute
display_name NULLABLE STRING Nama tampilan rute
record_time NULLABLE TIMESTAMP Stempel waktu saat data rute dihitung
duration_in_seconds NULLABLE FLOAT Durasi rute yang mempertimbangkan kondisi lalu lintas
static_duration_in_seconds NULLABLE FLOAT Durasi rute yang tidak mempertimbangkan kondisi lalu lintas
route_geometry NULLABLE GEOGRAPHY Geometri polyline rute yang mempertimbangkan kondisi lalu lintas

Perilaku dan fakta tabel

  • Tabel dipartisi berdasarkan hari dan memiliki masa berlaku 10 tahun yang ditetapkan untuk setiap partisi.
  • Tabel diperbarui setiap jam dengan data lalu lintas terbaru yang ditulis dalam batch.
  • Setelah rute baru dibuat di Roads Selection API, Anda harus menunggu hingga 1 jam untuk melihat data yang tersedia di tabel ini.
  • Setelah rute dihapus dari Roads Selection API, tidak ada data baru yang ditulis ke tabel ini untuk rute tersebut. Namun, data historis akan tetap ada hingga masa berlakunya berakhir.

Tabel recent_roads_data

Catatan: Tabel ini hanya tersedia jika kontrak Anda mencakup Data jalan real-time.

Berbeda dengan historical_travel_time, tabel ini juga menyimpan data SpeedReadingInterval. Berikut skemanya di BigQuery:

Nama Mode Jenis Deskripsi
selected_route_id NULLABLE STRING selected_route_id rute
display_name NULLABLE STRING Nama tampilan rute
record_time NULLABLE TIMESTAMP Stempel waktu saat data rute dihitung
duration_in_seconds NULLABLE FLOAT Durasi rute yang mempertimbangkan kondisi lalu lintas
static_duration_in_seconds NULLABLE FLOAT Durasi rute yang tidak mempertimbangkan kondisi lalu lintas
route_geometry NULLABLE GEOGRAPHY Geometri polyline rute yang mempertimbangkan kondisi lalu lintas
speed_reading_intervals REPEATED RECORD Interval yang mewakili kepadatan lalu lintas di seluruh rute. Lihat definisi aslinya di Routes API
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Geometri untuk interval ini
speed_reading_intervals.speed NULLABLE STRING Klasifikasi kecepatan untuk interval ini. Nilai yang mungkin: NORMAL, SLOW, TRAFFIC_JAM

Perilaku dan fakta tabel

  • Tabel dipartisi berdasarkan hari dan memiliki masa berlaku 60 hari yang ditetapkan untuk setiap partisi.
  • Tabel diperbarui setiap jam dengan data lalu lintas terbaru yang ditulis dalam batch.
  • Setelah rute baru dibuat di Roads Selection API, Anda harus menunggu hingga 1 jam untuk melihat data yang tersedia di tabel ini.
  • Setelah rute dihapus dari Roads Selection API, tidak ada data baru yang akan ditulis ke tabel ini untuk rute tersebut. Namun, data historis akan tetap ada hingga masa berlakunya berakhir.

Tabel routes_status

Tabel ini berisi metadata dan informasi status rute yang dipilih. Tabel ini bertujuan untuk menyediakan cara yang lebih mudah untuk melihat semua rute dan status. Tabel ini dapat digabungkan dengan dua tabel lainnya untuk pemfilteran data. Berikut skemanya di BigQuery:

Nama Mode Jenis Deskripsi
selected_route_id NULLABLE STRING selected_route_id rute
display_name NULLABLE STRING Nama tampilan rute
status* NULLABLE STRING Status rute
validation_error NULLABLE STRING Error validasi rute
low_road_usage_start_time NULLABLE TIMESTAMP Waktu saat rute pertama kali mengamati penggunaan jalan yang rendah selama validasi ulang. Waktu ini dikaitkan dengan VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Atribut kustom untuk rute yang dipilih

*Status rute dalam tabel ini dimulai dengan STATUS_, bukan STATE_. Status ini konsisten dengan Roads Selection API.

Perilaku dan fakta tabel

  • Hanya rute dengan status STATUS_RUNNING atau STATUS_INVALID yang disertakan dalam tabel ini.
  • Metadata dan status rute diperbarui setiap jam, tanpa henti.
  • Setelah rute baru dibuat di Roads Selection API, Anda harus menunggu hingga 1 jam untuk melihat rute yang tersedia di tabel ini.
  • Setelah rute dihapus dari Roads Selection API, Anda harus menunggu hingga 1 jam untuk melihat rute yang dipilih dihapus dari tabel ini.