Gesammelte Straßendaten

Mit „Gesammelte Straßendaten“ sind Daten gemeint, die Sie im Laufe der Zeit für Ihre ausgewählten Routen erstellen 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 zum Verständnis des langfristigen Verhaltens von Routen verwendet werden.

Die gesammelten 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

Prüfen Sie, ob Ihr Google Cloud-Projekt und Ihr Konto die folgenden Konfigurationen haben:

  1. BigQuery API aktivieren Eine Anleitung finden Sie unter Öffentliches Dataset mit der Google Cloud Console abfragen.
  2. Analytics Hub API aktivieren 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 bestimmten Abonnieren-Link, über den Sie auf Ihre Daten zugreifen können. Für dieses Dataset gilt die folgende Namenskonvention:

historical_roads_data_PROJECT_NUMBER.

So abonnieren Sie Ihre Daten:

  1. Klicken Sie auf den Abo-Link, 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 in der Google Cloud Console im BigQuery-Bereich Explorer angezeigt. Sie können jetzt die im Bereich „Explorer“ angezeigten Tabellennamen verwenden, um in Ihren SQL-Abfragen auf die Daten zuzugreifen.

BigQuery-Tabellen

Die gesammelten Straßendaten Ihrer ausgewählten Routen werden in einem isolierten BigQuery-Dataset eines Google-eigenen Cloud-Projekts gehostet. Es wird über einen privaten Datenaustausch mit Ihnen geteilt, der exklusiv für Sie in BigQuery Sharing (Analytics Hub) erstellt wurde. Um auf die Daten zuzugreifen, 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 werden. Nachfolgend finden Sie die Details zu den einzelnen Tabellen.

historical_travel_time Tabelle

Das Schema für die BigQuery-Tabelle historical_travel_time sieht so aus:

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 für die Berechnung der Routendaten
duration_in_seconds NULLABLE GLEITKOMMAZAHL Die verkehrsabhängige Dauer der Route
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ßenabschnitte entlang der Route, dargestellt als Orts-IDs

Tabellenverhalten und Fakten

  • 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 Verkehrsdaten 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 wird, werden keine neuen Daten mehr in diese Tabelle für die Route geschrieben. Verlaufsdaten bleiben jedoch bis zum Ablauf erhalten.
  • Die Straßenabschnitte entlang der Route folgen der topologischen Reihenfolge und sind immer verbunden.

recent_roads_data Tabelle

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

Im Gegensatz zu historical_travel_time enthält diese Tabelle auch offsetbasierte Intervalle für schnelles Lesen (speed_reading_offsets) und koordinatenbasierte Intervalle für schnelles Lesen (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 für die Berechnung der Routendaten
duration_in_seconds NULLABLE GLEITKOMMAZAHL Die verkehrsabhängige Dauer der Route
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 Intervalle für das schnelle Lesen. werden möglicherweise ab dem 9. November 2026 nicht mehr ausgefüllt. Verwenden Sie stattdessen speed_reading_offsets. Weitere Informationen finden Sie unter Intervalle für das Schnelllesen.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Legacy. Die Daten werden möglicherweise ab dem 9. November 2026 nicht mehr erfasst. Verwenden Sie stattdessen speed_reading_offsets. Die Geometrie für dieses Intervall
speed_reading_intervals.speed NULLABLE STRING Legacy. Die Daten werden möglicherweise ab dem 9. November 2026 nicht mehr erfasst. 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ßenabschnitte entlang der Route, dargestellt als Orts-IDs
speed_reading_offsets REPEATED RECORD Offsetbasierte Geschwindigkeitsmessintervalle, die die Verkehrsdichte auf der Route darstellen. Jedes Intervall wird durch den Distanz-Offset vom Start der Route abgegrenzt. Weitere Informationen finden Sie unter Intervalle für das Schnelllesen.
speed_reading_offsets.start_offset NULLABLE INTEGER Der Distanz-Offset vom Routenstart in Metern für den Beginn des Intervalls (einschließlich)
speed_reading_offsets.end_offset NULLABLE INTEGER Der Distanz-Offset 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, die an die Farben der Verkehrsebene in Google Maps angeglichen ist. Mögliche Werte: NORMAL (grün), SLOW (gelb), TRAFFIC_JAM (rot), TRAFFIC_JAM_HEAVY (dunkelrot, verfügbar ab 8. Oktober 2026)

Tabellenverhalten und Fakten

  • Die Tabelle ist nach Tag partitioniert und für jede Partition ist eine Ablaufzeit von 60 Tagen festgelegt.
  • Die Tabelle wird stündlich mit den neuesten Verkehrsdaten 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 wird, werden keine neuen Daten mehr in diese Tabelle für die Route geschrieben. Verlaufsdaten bleiben jedoch bis zum Ablauf erhalten.
  • Die Straßenabschnitte entlang der Route folgen der 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 erfasst 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.

routes_status Tabelle

Die Tabelle enthält die Metadaten und Statusinformationen der ausgewählten Routen. So können Sie alle Routen und den Status einfacher ansehen. Sie kann mit den beiden anderen Tabellen zusammengeführt werden, um Daten zu filtern. 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 bei der erneuten Validierung zum ersten Mal eine geringe Nutzung der Straße auf der Route beobachtet wurde. Sie ist mit VALIDATION_ERROR_LOW_ROAD_USAGE verknüpft.
route_attributes NULLABLE STRING Benutzerdefinierte Attribute für die ausgewählte Route

*Der Routenstatus in dieser Tabelle beginnt mit STATUS_ statt mit STATE_. Ansonsten entspricht sie der Roads Selection API.

Tabellenverhalten und Fakten

  • Diese Tabelle enthält nur Routen im Status STATUS_RUNNING oder STATUS_INVALID.
  • Die Metadaten und der Status von Routen werden stündlich aktualisiert.
  • Nachdem eine neue Route in der Roads Selection API erstellt wurde, kann es bis zu einer Stunde dauern, bis sie in dieser Tabelle angezeigt wird.
  • Nachdem eine Route aus der Roads Selection API gelöscht wurde, kann es bis zu einer Stunde dauern, bis die ausgewählte Route aus dieser Tabelle entfernt wird.