Kumulierte Straßendaten sind Daten, 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 das Verständnis des langfristigen Verhaltens von Routen verwendet werden.
Kumulierte Straßendaten werden als Zeitreihendaten bereitgestellt, die die Fahrtzeit, die Intervalle für die Geschwindigkeitsmessung (Speed Reading Intervals, SRIs) und die Routengeometrie für jede Route enthalten. Diese Daten werden in BigQuery gespeichert und sind darüber zugänglich.
BigQuery einrichten
Bevor Sie in BigQuery auf Ihre Straßendaten zugreifen können, müssen Sie Ihr Google Cloud-Projekt einrichten und den Datenpool abonnieren.
Vorbereitung
Prüfen Sie, ob Ihr Google Cloud-Projekt und Ihr Konto die folgenden Konfigurationen haben:
- BigQuery API aktivieren Eine Anleitung finden Sie unter Öffentliches Dataset mit der Cloud Console abfragen.
- Analytics Hub API aktivieren Weitere Informationen finden Sie unter Analytics Hub API.
- Erforderliche IAM-Rollen zuweisen Prüfen Sie, ob Ihr Konto die folgenden Rollen hat, um Abonnentenaufgaben auszuführen und Datasets zu erstellen:
- Analytics Hub-Abonnent (
roles/analyticshub.subscriber) - BigQuery User (
roles/bigquery.user)
- Analytics Hub-Abonnent (
Datenpool abonnieren
Ihre Straßendaten werden über einen privaten Datenpool in BigQuery (Analytics Hub) für Sie freigegeben. Sie erhalten von einem Google-Partner einen bestimmten Link zum Abonnieren, über den Sie auf Ihre Daten zugreifen können. Dieses Dataset folgt der folgenden Namenskonvention:
historical_roads_data_PROJECT_NUMBER.
So abonnieren Sie Ihre Daten:
- Klicken Sie auf den Link zum Abonnieren, den Sie von Ihrem Google-Partner erhalten haben. Über diesen Link gelangen Sie direkt zum Datenpool in der Google Cloud Console.
- Prüfen Sie in der Google Cloud Console die Details des Datenpools.
- Klicken Sie im Dialogfeld auf die Schaltfläche Abonnieren.
- Nach Abschluss des Abonnements wird das verknüpfte Dataset im Bereich Explorer von BigQuery in der Google Cloud Console angezeigt. Sie können jetzt die im Bereich „Explorer“ angezeigten Tabellennamen verwenden, um in Ihren SQL-Abfragen auf die Daten zuzugreifen.
BigQuery-Tabellen
Kumulierte Straßendaten Ihrer ausgewählten Routen werden in einem isolierten BigQuery-Dataset eines Google-eigenen Cloud-Projekts gehostet. Sie werden über einen privaten Datenpool für Sie freigegeben, der exklusiv für Sie in BigQuery Sharing (Analytics Hub) erstellt wurde. Um auf die Daten zuzugreifen, müssen Sie den Datenpool 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.
Tabelle historical_travel_time
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 |
| display_name | NULLABLE | STRING | Anzeigename der Route |
| record_time | NULLABLE | TIMESTAMP | Der Zeitstempel, an dem die Routendaten berechnet wurden |
| duration_in_seconds | NULLABLE | GLEITKOMMAZAHL | Die verkehrsabhängige Dauer der Route |
| static_duration_in_seconds | NULLABLE | GLEITKOMMAZAHL | Die verkehrsunabhängige Dauer der Route |
| route_geometry | NULLABLE | GEOGRAPHY | Die verkehrsabhängige Polyliniengeometrie der Route |
Tabellenverhalten und Fakten
- Die Tabelle ist nach Tag partitioniert und für jede Partition ist ein Ablauf von 10 Jahren festgelegt.
- Die Tabelle wird stündlich mit den neuesten Verkehrsdaten aktualisiert, die im Batch-Verfahren geschrieben werden.
- Wenn eine neue Route in der Roads Selection API erstellt wird, kann es bis zu einer Stunde dauern, bis die Daten in dieser Tabelle verfügbar sind.
- Wenn eine Route aus der Roads Selection API gelöscht wird, werden keine neuen Daten mehr für diese Route in diese Tabelle geschrieben. Die Verlaufsdaten bleiben jedoch bis zum Ablaufdatum erhalten.
Tabelle recent_roads_data
Hinweis: Diese Tabelle ist nur verfügbar, wenn Ihr Vertrag Echtzeit Straßendaten umfasst.
Im Unterschied zu historical_travel_time enthält diese Tabelle auch SpeedReadingInterval-Daten. Hier ist das Schema in BigQuery:
| Name | Modus | Typ | Beschreibung |
|---|---|---|---|
| selected_route_id | NULLABLE | STRING | selected_route_id der Route |
| display_name | NULLABLE | STRING | Anzeigename der Route |
| record_time | NULLABLE | TIMESTAMP | Der Zeitstempel, an dem die Routendaten berechnet wurden |
| duration_in_seconds | NULLABLE | GLEITKOMMAZAHL | Die verkehrsabhängige Dauer der Route |
| static_duration_in_seconds | NULLABLE | GLEITKOMMAZAHL | Die verkehrsunabhängige Dauer der Route |
| route_geometry | NULLABLE | GEOGRAPHY | Die verkehrsabhängige Polyliniengeometrie der Route |
| speed_reading_intervals | REPEATED | RECORD | Intervalle, die die Verkehrsdichte auf der Route darstellen. Die ursprüngliche Definition finden Sie in der Routes API. |
| speed_reading_intervals.interval_coordinates | REPEATED | GEOGRAPHY | Die Geometrie für dieses Intervall |
| speed_reading_intervals.speed | NULLABLE | STRING | Die Klassifizierung der Geschwindigkeit für dieses Intervall. Mögliche Werte: NORMAL, SLOW, TRAFFIC_JAM |
Tabellenverhalten und Fakten
- 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 Verkehrsdaten aktualisiert, die im Batch-Verfahren geschrieben werden.
- Wenn eine neue Route in der Roads Selection API erstellt wird, kann es bis zu einer Stunde dauern, bis die Daten in dieser Tabelle verfügbar sind.
- Wenn eine Route aus der Roads Selection API gelöscht wird, werden keine neuen Daten mehr für diese Route in diese Tabelle geschrieben. Die Verlaufsdaten bleiben jedoch bis zum Ablaufdatum erhalten.
Tabelle routes_status
Die Tabelle enthält die Metadaten und Statusinformationen der ausgewählten Routen. Sie soll eine einfachere Möglichkeit bieten, alle Routen und ihren Status anzusehen. Sie kann mit den anderen beiden Tabellen verknüpft 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 |
| display_name | 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 Straßennutzung für die Route beobachtet wurde. Er 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_ anstelle von STATE_. Ansonsten stimmt er mit der Roads Selection API überein.
Tabellenverhalten und Fakten
- Diese Tabelle enthält nur Routen mit dem Status STATUS_RUNNING oder STATUS_INVALID.
- Die Metadaten und der Status von Routen werden stündlich aktualisiert.
- Wenn eine neue Route in der Roads Selection API erstellt wird, kann es bis zu einer Stunde dauern, bis die Route in dieser Tabelle verfügbar ist.
- Wenn eine Route aus der Roads Selection API gelöscht wird, kann es bis zu einer Stunde dauern, bis die ausgewählte Route aus dieser Tabelle entfernt wird.