Data jalan yang dikumpulkan

Data jalan yang diakumulasikan 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 perilaku rute jangka panjang.

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

Menyiapkan BigQuery

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

Prasyarat

Pastikan project dan akun Google Cloud Anda memiliki konfigurasi berikut:

  1. Aktifkan BigQuery API. Untuk mengetahui petunjuknya, lihat Mengkueri set data publik dengan konsol Google Cloud.
  2. Mengaktifkan Analytics Hub API. Lihat Analytics Hub API.
  3. Memberikan 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 ke pertukaran data Anda

Data jalan Anda dibagikan kepada Anda melalui pertukaran data pribadi di BigQuery (Analytics Hub). Anda akan menerima link berlangganan 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 berlangganan yang diberikan 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. Sekarang Anda dapat menggunakan nama tabel yang ditampilkan di panel Explorer untuk mengakses data dalam kueri SQL Anda.

Tabel BigQuery

Data jalan yang terakumulasi dari rute yang Anda pilih dihosting di set data BigQuery yang 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 ke 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 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 dari 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 memperhitungkan lalu lintas. Dihilangkan (NULL) jika has_road_closure adalah true.
static_duration_in_seconds NULLABLE FLOAT Durasi rute tanpa memperhitungkan lalu lintas
route_geometry NULLABLE GEOGRAPHY Geometri polyline rute yang memperhitungkan lalu lintas
road_segment_ids BERULANG STRING Segmen jalan di sepanjang rute, yang direpresentasikan sebagai ID Tempat
has_road_closure NULLABLE BOOLEAN Apakah ada penutupan jalan penuh di rute tersebut. Jika true, duration_in_seconds akan dihilangkan (NULL) karena rute tidak dapat dilalui. Nilai NULL menunjukkan bahwa informasi penutupan jalan belum ditentukan.

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 traffic terbaru yang ditulis dalam batch.
  • Setelah rute baru dibuat di Roads Selection API, tunggu 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 berlakunya habis.
  • Segmen jalan di sepanjang rute mengikuti urutan topologi dan selalu terhubung.
  • Flag has_road_closure konsisten dengan status penutupan jalan penuh di Google Maps.

Tabel recent_roads_data

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

Berbeda dengan historical_travel_time, tabel ini juga menyimpan interval pembacaan kecepatan berbasis offset (speed_reading_offsets) dan interval pembacaan kecepatan berbasis koordinat lama (speed_reading_intervals). Berikut adalah skema di BigQuery:

Nama Mode Jenis Deskripsi
selected_route_id NULLABLE STRING selected_route_id dari 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 memperhitungkan lalu lintas. Dihilangkan (NULL) jika has_road_closure adalah true.
static_duration_in_seconds NULLABLE FLOAT Durasi rute tanpa memperhitungkan lalu lintas
route_geometry NULLABLE GEOGRAPHY Geometri polyline rute yang memperhitungkan lalu lintas
speed_reading_intervals BERULANG RECORD Interval pembacaan kecepatan berbasis koordinat lama. Mungkin akan berhenti diisi pada atau setelah 9 November 2026. Sebagai gantinya, gunakan speed_reading_offsets. Lihat Interval pembacaan kecepatan.
speed_reading_intervals.interval_coordinates BERULANG GEOGRAPHY Legacy. Mungkin berhenti diisi pada atau setelah 9 November 2026. Sebagai gantinya, gunakan speed_reading_offsets. Geometri untuk interval ini
speed_reading_intervals.speed NULLABLE STRING Legacy. Mungkin berhenti diisi pada atau setelah 9 November 2026. Sebagai gantinya, gunakan speed_reading_offsets. Klasifikasi kecepatan untuk interval ini. Nilai yang mungkin: NORMAL, SLOW, TRAFFIC_JAM. Dalam kolom lama ini, kemacetan lalu lintas yang parah (merah tua) juga dilaporkan sebagai TRAFFIC_JAM; TRAFFIC_JAM_HEAVY tidak pernah digunakan.
road_segment_ids BERULANG STRING Segmen jalan di sepanjang rute, yang direpresentasikan sebagai ID Tempat
speed_reading_offsets BERULANG RECORD Interval pembacaan kecepatan berbasis offset yang mewakili kepadatan lalu lintas di seluruh rute; setiap interval dibatasi oleh offset jarak dari awal rute. Dihilangkan jika has_road_closure adalah true. Lihat Interval pembacaan kecepatan.
speed_reading_offsets.start_offset NULLABLE BILANGAN BULAT Offset jarak dari awal rute dalam meter untuk awal interval (inklusif)
speed_reading_offsets.end_offset NULLABLE BILANGAN BULAT Offset jarak dari awal rute dalam meter untuk akhir interval (eksklusif; sama dengan start_offset interval berikutnya)
speed_reading_offsets.speed NULLABLE STRING Klasifikasi kecepatan untuk interval ini, yang disesuaikan dengan warna di lapisan lalu lintas Google Maps. Nilai yang mungkin: NORMAL (hijau), SLOW (kuning), TRAFFIC_JAM (merah), TRAFFIC_JAM_HEAVY (merah tua, tersedia mulai 8 Oktober 2026)
has_road_closure NULLABLE BOOLEAN Apakah ada penutupan jalan penuh di rute tersebut. Jika true, duration_in_seconds, dan speed_reading_offsets dihilangkan karena rute tidak dapat dilalui. Nilai NULL menunjukkan bahwa informasi penutupan jalan belum ditentukan.

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 traffic terbaru yang ditulis dalam batch.
  • Setelah rute baru dibuat di Roads Selection API, tunggu 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 berlakunya habis.
  • Segmen jalan di sepanjang rute mengikuti urutan topologi dan selalu terhubung.
  • Kolom speed_reading_offsets diisi untuk baris yang dicatat pada atau setelah 8 Oktober 2026. Baris sebelumnya memiliki array kosong.
  • Kolom speed_reading_intervals lama mungkin akan berhenti diisi pada atau setelah 9 November 2026. Sebagai gantinya, gunakan speed_reading_offsets.
  • Flag has_road_closure konsisten dengan status penutupan jalan penuh di Google Maps.

Tabel routes_status

Tabel ini berisi metadata rute yang dipilih dan informasi status. 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 dari 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 diamati memiliki 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
dynamic_routing NULLABLE BOOLEAN Menunjukkan apakah rute bersifat dinamis (true) atau tetap (false). Lihat dynamicRouting.
asal NULLABLE GEOGRAPHY Titik jalan asal rute
destination NULLABLE GEOGRAPHY Titik jalan tujuan rute
intermediates BERULANG GEOGRAPHY Titik jalan perantara rute
static_route_geometry NULLABLE GEOGRAPHY Geometri polyline rute statis yang dihitung tanpa lalu lintas live dari titik jalan
road_segment_ids BERULANG STRING Segmen jalan di sepanjang rute statis yang dihitung tanpa lalu lintas live, yang direpresentasikan sebagai ID Tempat

Perilaku dan fakta tabel

  • Hanya rute dalam 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, tunggu hingga 1 jam untuk melihat rute yang tersedia di tabel ini.
  • Setelah rute dihapus dari Roads Selection API, tunggu hingga 1 jam untuk melihat rute yang dipilih dihapus dari tabel ini.
  • Untuk rute tetap (dynamic_routing: false), ID Tempat di road_segment_ids akan otomatis diperbarui untuk mencerminkan perubahan pada jaringan jalan Google, sekaligus tetap mewakili rute yang sama. Untuk rute dinamis (dynamic_routing: true), road_segment_ids tidak diperbarui.