Data jalan yang dikumpulkan

Data jalan yang terakumulasi mengacu pada data yang dapat Anda kumpulkan 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 rute dalam jangka panjang.

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

  • Durasi perjalanan
  • Interval membaca cepat (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 mendapatkan petunjuk, lihat Mengkueri 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. Analytics Hub Subscriber (roles/analyticshub.subscriber)

Berlangganan pertukaran data Anda

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 disediakan oleh partner Google Anda. Link ini akan membawa Anda langsung ke pertukaran data di konsol Google Cloud.
  2. Di konsol Google Cloud, tinjau detail pertukaran data.
  3. Klik tombol Subscribe di dialog.
  4. Setelah langganan selesai, set data tertaut akan muncul di panel Explorer BigQuery di konsol Google Cloud. Anda kini dapat menggunakan nama tabel yang ditampilkan di panel Penjelajah untuk mengakses data dalam kueri SQL.

Tabel BigQuery

Data jalan yang dikumpulkan 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 BigQuery sharing (Analytics Hub). Untuk mengakses data, Anda harus berlangganan bursa 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 adalah detail setiap tabel.

Tabel historical_travel_time

Berikut adalah 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 memperhitungkan lalu lintas
route_geometry NULLABLE GEOGRAPHY Geometri polyline rute yang sesuai dengan kondisi lalu lintas

Perilaku dan fakta tabel

  • Tabel dipartisi menurut hari dan memiliki masa berlaku 10 tahun yang ditetapkan untuk setiap partisi.
  • Tabel diperbarui setiap jam dengan data traffic 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 tetap ada hingga masa berlaku 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 adalah skema 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 memperhitungkan lalu lintas
route_geometry NULLABLE GEOGRAPHY Geometri polyline rute yang sesuai dengan kondisi lalu lintas
speed_reading_intervals BERULANG RECORD Interval yang menunjukkan kepadatan lalu lintas di seluruh rute. Lihat definisi asli di Routes API
speed_reading_intervals.interval_coordinates BERULANG 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 menurut hari dan memiliki masa berlaku 60 hari yang ditetapkan untuk setiap partisi.
  • Tabel diperbarui setiap jam dengan data traffic 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 tetap ada hingga masa berlaku berakhir.

Tabel routes_status

Tabel ini berisi metadata dan informasi status rute yang dipilih. Tujuannya adalah untuk memberikan cara yang lebih mudah dalam melihat semua rute dan status. Tabel ini dapat digabungkan dengan dua tabel lainnya untuk pemfilteran data. Berikut adalah skema 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 ketika rute pertama kali mengamati penggunaan jalan yang rendah selama validasi ulang. Error ini terkait dengan VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Atribut khusus untuk rute yang dipilih

*Status rute dalam tabel ini dimulai dengan STATUS_, bukan STATE_. Selain itu, API 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 agar rute tersebut 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.