Gesammelte Straßendaten

Kumulierte Straßendaten sind Daten, die Sie im Laufe der Zeit für Ihre ausgewählten Routen erfassen können. Sie erhalten Daten, sobald Sie eine Route mit der Roads Selection API erstellen. Diese Daten können dann für detaillierte Analysen, strategische Planung und das Verständnis des langfristigen Verhaltens von Routen verwendet werden.

Kumulierte Straßendaten werden als Zeitreihendaten bereitgestellt, darunter:

BigQuery einrichten

Bevor Sie in BigQuery auf Ihre Straßendaten zugreifen können, müssen Sie Ihr Google Cloud-Projekt einrichten und den Datenaustausch abonnieren.

Vorbereitung

Ihr Google Cloud-Projekt und Ihr Google Cloud-Konto müssen so konfiguriert sein:

  1. BigQuery API aktivieren. Eine Anleitung finden Sie unter Öffentliches Dataset mit der Google Cloud Console abfragen.
  2. Analytics Hub API aktivieren Siehe Analytics Hub API.
  3. Erforderliche IAM-Rollen zuweisen Prüfen Sie, ob Ihr Konto die folgenden Rollen hat, um Abonnentenaufgaben auszuführen und Datasets zu erstellen:
  4. Analytics Hub-Abonnent (roles/analyticshub.subscriber)

Datenpool abonnieren

Ihre Straßendaten werden über einen privaten Datenaustausch in BigQuery (Analytics Hub) mit Ihnen geteilt. Sie erhalten von einem Google-Partner einen speziellen Aktivierungslink, über den Sie auf Ihre Daten zugreifen können. Dieses Dataset entspricht der folgenden Namenskonvention:

historical_roads_data_PROJECT_NUMBER.

So abonnieren Sie Ihre Daten:

  1. Klicken Sie auf den Aktivierungslink, den Sie von Ihrem Google-Partner erhalten haben. Über diesen Link gelangen Sie direkt zum Datenaustausch in der Google Cloud Console.
  2. Prüfen Sie in der Google Cloud Console die Details zum Datenaustausch.
  3. Klicken Sie im Dialogfeld auf den Button Abonnieren.
  4. Wenn das Abo abgeschlossen ist, wird das verknüpfte Dataset im BigQuery-Bereich Explorer in der Google Cloud Console angezeigt. Sie können jetzt die im Explorer-Bereich angezeigten Tabellennamen verwenden, um in Ihren SQL-Abfragen auf die Daten zuzugreifen.

BigQuery-Tabellen

Die akkumulierten Straßendaten Ihrer ausgewählten Routen werden in einem isolierten BigQuery-Dataset eines Google-eigenen Cloud-Projekts gehostet. Sie werden über einen privaten Datenaustausch, der exklusiv für Sie in BigQuery Sharing (Analytics Hub) erstellt wurde, mit Ihnen geteilt. Wenn Sie auf die Daten zugreifen möchten, müssen Sie den Datenaustausch abonnieren und ein verknüpftes Dataset in Ihrem Google Cloud-Projekt erstellen.

Das freigegebene BigQuery-Dataset enthält einige BigQuery-Tabellen, die von Google definiert und erstellt wurden. Im Folgenden finden Sie die Details zu den einzelnen Tabellen.

historical_travel_time Tabelle

Im Folgenden finden Sie das Schema für die BigQuery-Tabelle historical_travel_time:

Name Modus Typ Beschreibung
selected_route_id NULLABLE STRING selected_route_id der Route
Anzeigename NULLABLE STRING Anzeigename der Route
record_time NULLABLE TIMESTAMP Der Zeitstempel, zu dem die Routendaten berechnet werden
duration_in_seconds NULLABLE GLEITKOMMAZAHL Die Dauer der Route unter Berücksichtigung der Verkehrslage. Wird weggelassen (NULL), wenn has_road_closure den Wert true hat.
static_duration_in_seconds NULLABLE GLEITKOMMAZAHL Die Dauer der Route ohne Berücksichtigung der Verkehrslage
route_geometry NULLABLE GEOGRAPHY Die verkehrsabhängige Polyliniengeometrie der Route
road_segment_ids REPEATED STRING Die Straßensegmente entlang der Route, dargestellt als Orts-IDs
has_road_closure NULLABLE BOOLEAN Ob es auf der Route eine vollständige Straßensperrung gibt. Wenn true, wird duration_in_seconds weggelassen (NULL), weil die Route unpassierbar ist. Der Wert NULL gibt an, dass keine Informationen zu Straßensperrungen vorliegen.

Verhalten und Fakten zu Tabellen

  • Die Tabelle ist nach Tag partitioniert und für jede Partition ist ein Ablaufdatum von 10 Jahren festgelegt.
  • Die Tabelle wird stündlich mit den neuesten Trafficdaten aktualisiert, die im Batch geschrieben werden.
  • Nachdem eine neue Route in der Roads Selection API erstellt wurde, kann es bis zu einer Stunde dauern, bis die Daten in dieser Tabelle verfügbar sind.
  • Sobald eine Route aus der Roads Selection API gelöscht wurde, werden für diese Route keine neuen Daten mehr in diese Tabelle geschrieben. Verlaufsdaten bleiben jedoch bis zum Ablauf erhalten.
  • Die Straßensegmente entlang der Route folgen einer topologischen Reihenfolge und sind immer verbunden.
  • Das Flag has_road_closure entspricht dem Status „Vollständige Straßensperrung“ in Google Maps.

recent_roads_data Tabelle

Hinweis: Diese Tabelle ist nur verfügbar, wenn Ihr Vertrag Echtzeit-Straßendaten enthält.

Im Unterschied zu historical_travel_time enthält diese Tabelle auch offsetbasierte Geschwindigkeitsmessintervalle (speed_reading_offsets) und ältere koordinatenbasierte Geschwindigkeitsmessintervalle (speed_reading_intervals). Hier ist das Schema in BigQuery:

Name Modus Typ Beschreibung
selected_route_id NULLABLE STRING selected_route_id der Route
Anzeigename NULLABLE STRING Anzeigename der Route
record_time NULLABLE TIMESTAMP Der Zeitstempel, zu dem die Routendaten berechnet werden
duration_in_seconds NULLABLE GLEITKOMMAZAHL Die Dauer der Route unter Berücksichtigung der Verkehrslage. Wird weggelassen (NULL), wenn has_road_closure den Wert true hat.
static_duration_in_seconds NULLABLE GLEITKOMMAZAHL Die Dauer der Route ohne Berücksichtigung der Verkehrslage
route_geometry NULLABLE GEOGRAPHY Die verkehrsabhängige Polyliniengeometrie der Route
speed_reading_intervals REPEATED RECORD Alte koordinatenbasierte Geschwindigkeitsmessintervalle. Wird möglicherweise ab dem 9. November 2026 nicht mehr ausgefüllt. Verwenden Sie stattdessen speed_reading_offsets. Siehe Intervalle für Geschwindigkeitsmessungen.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Legacy. Wird möglicherweise ab dem 9. November 2026 nicht mehr ausgefüllt. Verwenden Sie stattdessen speed_reading_offsets. Die Geometrie für dieses Intervall
speed_reading_intervals.speed NULLABLE STRING Legacy. Wird möglicherweise ab dem 9. November 2026 nicht mehr ausgefüllt. Verwenden Sie stattdessen speed_reading_offsets. Die Klassifizierung der Geschwindigkeit für dieses Intervall. Mögliche Werte: NORMAL, SLOW, TRAFFIC_JAM. In diesem alten Feld werden auch starke Staus (dunkelrot) als TRAFFIC_JAM gemeldet. TRAFFIC_JAM_HEAVY wird nie verwendet.
road_segment_ids REPEATED STRING Die Straßensegmente entlang der Route, dargestellt als Orts-IDs
speed_reading_offsets REPEATED RECORD Offsetbasierte Geschwindigkeitsintervalle, die die Verkehrsdichte auf der Route darstellen. Jedes Intervall wird durch den Entfernungs-Offset vom Start der Route abgegrenzt. Wird weggelassen, wenn has_road_closure true ist. Siehe Intervalle für Geschwindigkeitsmessungen.
speed_reading_offsets.start_offset NULLABLE INTEGER Der Abstand vom Start der Route in Metern für den Beginn des Intervalls (einschließlich)
speed_reading_offsets.end_offset NULLABLE INTEGER Der Abstand vom Start der Route in Metern für das Ende des Intervalls (exklusiv; entspricht dem start_offset des nachfolgenden Intervalls)
speed_reading_offsets.speed NULLABLE STRING Die Klassifizierung der Geschwindigkeit für dieses Intervall, abgestimmt auf die Farben in der Google Maps-Verkehrsebene. Mögliche Werte: NORMAL (grün), SLOW (gelb), TRAFFIC_JAM (rot), TRAFFIC_JAM_HEAVY (dunkelrot, verfügbar ab dem 8. Oktober 2026)
has_road_closure NULLABLE BOOLEAN Ob es auf der Route eine vollständige Straßensperrung gibt. Wenn true, werden duration_in_seconds und speed_reading_offsets weggelassen, da die Route nicht befahrbar ist. Der Wert NULL gibt an, dass keine Informationen zu Straßensperrungen vorliegen.

Verhalten und Fakten zu Tabellen

  • Die Tabelle ist nach Tag partitioniert und für jede Partition ist ein Ablauf von 60 Tagen festgelegt.
  • Die Tabelle wird stündlich mit den neuesten Trafficdaten aktualisiert, die im Batch geschrieben werden.
  • Nachdem eine neue Route in der Roads Selection API erstellt wurde, kann es bis zu einer Stunde dauern, bis die Daten in dieser Tabelle verfügbar sind.
  • Nachdem eine Route aus der Roads Selection API gelöscht wurde, werden für diese Route keine neuen Daten mehr in diese Tabelle geschrieben. Verlaufsdaten bleiben jedoch bis zum Ablauf erhalten.
  • Die Straßensegmente entlang der Route folgen einer topologischen Reihenfolge und sind immer verbunden.
  • Die Spalte speed_reading_offsets wird für Zeilen ausgefüllt, die am oder nach dem 8. Oktober 2026 aufgezeichnet wurden. Frühere Zeilen enthalten leere Arrays.
  • Die alte Spalte speed_reading_intervals wird möglicherweise ab dem 9. November 2026 nicht mehr ausgefüllt. Verwenden Sie stattdessen speed_reading_offsets.
  • Das Flag has_road_closure entspricht dem Status „Vollständige Straßensperrung“ in Google Maps.

routes_status Tabelle

Die Tabelle enthält die Metadaten und Statusinformationen der ausgewählten Routen. Ziel ist es, alle Routen und Status einfacher anzuzeigen. Sie kann mit den anderen beiden Tabellen zur Datenfilterung zusammengeführt werden. Hier ist das Schema in BigQuery:

Name Modus Typ Beschreibung
selected_route_id NULLABLE STRING selected_route_id der Route
Anzeigename NULLABLE STRING Anzeigename der Route
status* NULLABLE STRING Status der Route
validation_error NULLABLE STRING Validierungsfehler der Route
low_road_usage_start_time NULLABLE TIMESTAMP Der Zeitpunkt, zu dem die Route bei der erneuten Validierung zum ersten Mal eine geringe Straßennutzung aufwies. Er ist mit VALIDATION_ERROR_LOW_ROAD_USAGE verknüpft.
route_attributes NULLABLE STRING Benutzerdefinierte Attribute für die ausgewählte Route
dynamic_routing NULLABLE BOOLEAN Gibt an, ob die Route dynamisch (true) oder fest (false) ist. Weitere Informationen finden Sie unter dynamicRouting.
origin NULLABLE GEOGRAPHY Startwegpunkt der Route
Ziel NULLABLE GEOGRAPHY Zielwegpunkt der Route
intermediates REPEATED GEOGRAPHY Wegpunkte entlang der Route
static_route_geometry NULLABLE GEOGRAPHY Die Polyliniengeometrie der statischen Route, die ohne Live-Verkehrsdaten aus den Wegpunkten berechnet wird
road_segment_ids REPEATED STRING Die Straßensegmente entlang der statischen Route, die ohne Berücksichtigung der aktuellen Verkehrslage berechnet wurden, dargestellt als Orts-IDs

Verhalten und Fakten zu Tabellen

  • In dieser Tabelle sind nur Routen mit dem Status STATUS_RUNNING oder STATUS_INVALID enthalten.
  • Routenmetadaten und -status werden stündlich aktualisiert.
  • Nachdem eine neue Route in der Roads Selection API erstellt wurde, kann es bis zu 1 Stunde dauern, bis sie in dieser Tabelle verfügbar ist.
  • Nachdem eine Route aus der Roads Selection API gelöscht wurde, kann es bis zu 1 Stunde dauern, bis sie aus dieser Tabelle entfernt wird.
  • Bei festen Routen (dynamic_routing: false) werden die Orts-IDs in road_segment_ids automatisch aktualisiert, um Änderungen im Straßennetz von Google widerzuspiegeln, während die Route gleich bleibt. Bei dynamischen Routen (dynamic_routing: true) wird road_segment_ids nicht aktualisiert.