Dane drogowe w czasie rzeczywistym

Dane o drogach w czasie rzeczywistym dostarczają aktualnych informacji o warunkach drogowych i zdarzeniach na wybranych trasach, co umożliwia dynamiczne monitorowanie i szybkie reagowanie. Te dane różnią się od danych zbieranych okresowo, które są dostępne w BigQuery, i są odpowiednie w sytuacjach, gdy potrzebne są aktualne informacje.

Dane te są przesyłane w sposób ciągły i obejmują czas trwania podróży, który wskazuje czas podróży na trasie, oraz interwały odczytu prędkości, które pokazują natężenie ruchu na trasie.

Aby uzyskać dostęp do danych o drogach w czasie rzeczywistym, Twoja umowa musi obejmować pakiet Real-Time Operations.

Tworzenie subskrypcji Pub/Sub dotyczącej interwałów odczytu czasu podróży i prędkości

Otrzymasz dedykowane tematy Google Cloud Pub/Sub, w których możesz subskrybować dane w czasie rzeczywistym dla wszystkich utworzonych tras.

Poniższy przykładowy kod pokazuje format tematu z użyciem kodowania binarnego:

projects/maps-platform-roads-management/topics/rmi-roadsinformation-PROJECT_NUMBER

Udostępniamy też inny temat z kodowaniem JSON (z przyrostkiem -json). Aby otrzymywać wiadomości z danymi w czasie rzeczywistym, musisz zasubskrybować udostępniony temat Pub/Sub. Aby dowiedzieć się, jak subskrybować i wykorzystywać wiadomości z tematu Cloud Pub/Sub, zapoznaj się z artykułem na temat subskrybowania tematu.

Schemat czasu trwania podróży i interwałów odczytu prędkości

Każda wiadomość z danymi w czasie rzeczywistym zawiera takie dane jak:

  • Szczegóły drogi, takie jak duration_in_seconds, static_duration_in_seconds, speed_reading_offsets (interwały odczytu prędkości na podstawie przesunięcia), retrieval_timestamp i has_road_closure.
  • Identyfikatory tras, takie jak selected_route_id i display_name.

Każda wiadomość jest publikowana zgodnie z tym formatem Protobuf.

syntax = "proto3";

// Contains the road information like travel duration and speed reading
// intervals for a selected route.
message RoadsInformation {
  // Legacy message. May stop being populated on or after November 9, 2026.
  // Use top-level duration_in_seconds and static_duration_in_seconds instead.
  message TravelDuration {
    // The duration of travel through the route based on current road
    // conditions.
    float duration_in_seconds = 1;
    // The duration of travel through the route without taking road
    // conditions into consideration.
    float static_duration_in_seconds = 2;
  }
  message Timestamp {
    // Represents seconds of UTC time since Unix epoch
    // 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
    // 9999-12-31T23:59:59Z inclusive.
    int64 seconds = 1;

    // Non-negative fractions of a second at nanosecond resolution. Negative
    // second values with fractions must still have non-negative nanos values
    // that count forward in time. Must be from 0 to 999,999,999
    // inclusive.
    int32 nanos = 2;
  }
  // Legacy message representing the latitude and longitude of a coordinate
  // within a coordinate-based speed reading interval.
  message LatLng {
    float latitude = 1;
    float longitude = 2;
  }
  // Legacy coordinate-based speed reading interval message. May stop being
  // populated on or after November 9, 2026. Use SpeedReadingOffset instead.
  message SpeedReadingInterval {
    // The coordinates on the polyline for the speed reading interval.
    repeated LatLng interval_coordinates = 1;

    // Describes the categorized current speed of road conditions.
    // Possible values are:
    // - "NORMAL": Road is flowing smoothly, no slowdown is detected.
    // - "SLOW": Slowdown detected, but no congestion formed.
    // - "TRAFFIC_JAM": Traffic jam detected. In this legacy field, heavy
    //   traffic jams (dark red) are also reported as "TRAFFIC_JAM";
    //   "TRAFFIC_JAM_HEAVY" is never used.
    string speed = 2;
  }
  // Offset-based speed reading interval along the route.
  message SpeedReadingOffset {
    // The distance offset from the start of the route in meters for the start
    // of the interval (inclusive).
    int32 start_offset = 1;

    // The distance offset from the start of the route in meters for the end of
    // the interval (exclusive; equals the start_offset of the subsequent
    // interval).
    int32 end_offset = 2;

    // Describes the categorized current speed of traffic, aligned with the
    // colors in the Google Maps traffic layer. Possible values are:
    // - "NORMAL" (green): Traffic is flowing smoothly, no slowdown is detected.
    // - "SLOW" (yellow): Slowdown detected, but no traffic jam formed.
    // - "TRAFFIC_JAM" (red): Traffic jam detected.
    // - "TRAFFIC_JAM_HEAVY" (dark red): Heavy traffic jam detected (available
    //   as of October 8, 2026).
    string speed = 3;
  }
  // Id for selected_route.
  string selected_route_id = 1;
  // User provided name for the route.
  string display_name = 2;
  // Legacy coordinate-based speed reading intervals. May stop being populated
  // on or after November 9, 2026. Use speed_reading_offsets instead.
  repeated SpeedReadingInterval speed_reading_intervals = 3;
  // Legacy travel time information. May stop being populated on or after
  // November 9, 2026. Use duration_in_seconds and static_duration_in_seconds
  // instead.
  TravelDuration travel_duration = 4;
  // Legacy timestamp when the road data was collected. May stop being populated
  // on or after November 9, 2026. Use retrieval_timestamp instead.
  Timestamp retrieval_time = 5;
  // Contains a geojson polyline representing the optimal route determined
  // based on user's input waypoints.
  string route_geometry = 6;
  // Road segment place IDs along the route. They follow topological order
  // and are always connected.
  repeated string road_segment_ids = 7;
  // Offset-based speed reading intervals representing traffic density across
  // the route; each interval is demarcated by the distance offset from the
  // start of the route. Omitted when has_road_closure is true.
  repeated SpeedReadingOffset speed_reading_offsets = 8;
  // The duration of travel through the route based on current traffic
  // conditions. Omitted when has_road_closure is true.
  float duration_in_seconds = 9;
  // The duration of travel through the route without taking traffic
  // conditions into consideration.
  float static_duration_in_seconds = 10;
  // The time the traffic data was collected, as an RFC 3339 UTC timestamp
  // string (for example, "2026-10-08T15:04:05+00:00").
  string retrieval_timestamp = 11;
  // Whether there is a full road closure on the route. When true,
  // duration_in_seconds and speed_reading_offsets are omitted because the
  // route is impassable. Omitted when road closure information is undetermined.
  bool has_road_closure = 12;
}

Interwały odczytu prędkości na podstawie przesunięcia i migracja pól

Od 8 października 2026 r. interwały odczytu prędkości są podawane w polu speed_reading_offsets opartym na przesunięciu, gdzie każdy interwał jest wyznaczany przez start_offset (włącznie) i end_offset (wyłącznie) w metrach od początku trasy i obejmuje czwartą kategorię prędkości TRAFFIC_JAM_HEAVY. Szczegółowe informacje o kategoriach szybkości i formatach interwałów znajdziesz w artykule Interwały odczytu szybkości.

W tabeli poniżej znajdziesz mapowanie każdego starszego pola Pub/Sub (które może przestać być wypełniane 9 listopada 2026 r. lub później) na jego zamiennik:

Pole starszego typu Pole zastępcze Uwagi
speed_reading_intervals speed_reading_offsets Używa przesunięć w metrach (start_offset, end_offset) zamiast współrzędnych linii łamanej i dodaje kategorię prędkości TRAFFIC_JAM_HEAVY.
travel_duration.duration_in_seconds duration_in_seconds Spłaszczone do pola float najwyższego poziomu.
travel_duration.static_duration_in_seconds static_duration_in_seconds Spłaszczone do pola float najwyższego poziomu.
retrieval_time retrieval_timestamp Sformatowany jako ciąg znaków RFC 3339, który subskrypcje BigQuery automatycznie konwertują na TIMESTAMP.

Przesyłanie strumieniowe danych o trasach do BigQuery za pomocą Pub/Sub

Możesz skonfigurować subskrypcję Pub/Sub, aby przesyłać strumieniowo dane o drogach bezpośrednio do tabeli BigQuery. Umożliwia to niezawodny magazyn danych i zaawansowaną analitykę podanych informacji o trasie. Przed skonfigurowaniem tego typu subskrypcji musisz utworzyć odpowiedni zbiór danych i tabelę w projekcie BigQuery, aby zapisywać dane.

Szczegółowe instrukcje tworzenia subskrypcji Pub/Sub, która zapisuje dane w BigQuery, znajdziesz w artykule na temat strumieniowego przesyłania danych do BigQuery. Utwórz subskrypcję BigQuery w temacie zakodowanym w formacie JSON. Podczas konfigurowania subskrypcji wybierz Użyj schematu tabeli i włącz Usuń nieznane pola, aby potok pozyskiwania działał płynnie po dodaniu nowych pól. Aby przechowywać nowe pola, takie jak speed_reading_offsets, dodaj do tabeli odpowiednie kolumny.

Schemat tabeli BigQuery

Wiadomości opublikowane w temacie Pub/Sub, które mogą być również zapisywane w tabeli BigQuery, są zgodne z tym schematem. Aby zapewnić zgodność, użyj tego schematu podczas tworzenia docelowej tabeli BigQuery.

[
  {
    "mode": "NULLABLE",
    "name": "selected_route_id",
    "type": "STRING",
    "description": "Id for selected_route."
  },
  {
    "mode": "NULLABLE",
    "name": "display_name",
    "type": "STRING",
    "description": "User provided name for the route."
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "speed",
        "type": "STRING",
        "description": "Describes the categorized current speed of traffic. Possible values are: \"NORMAL\": Traffic is flowing smoothly, no slowdown is detected. \"SLOW\": Slowdown detected, but no traffic jam formed. \"TRAFFIC_JAM\": Traffic jam detected (groups red and dark red segments; does not include \"TRAFFIC_JAM_HEAVY\")."
      },
      {
        "fields": [
          {
            "mode": "NULLABLE",
            "name": "latitude",
            "type": "NUMERIC"
          },
          {
            "mode": "NULLABLE",
            "name": "longitude",
            "type": "NUMERIC"
          }
        ],
        "mode": "REPEATED",
        "name": "interval_coordinates",
        "type": "RECORD",
        "description": "The geometry for this interval"
      }
    ],
    "mode": "REPEATED",
    "name": "speed_reading_intervals",
    "type": "RECORD",
    "description": "Legacy coordinate-based speed reading intervals. May stop being populated on or after November 9, 2026. Use speed_reading_offsets instead."
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "duration_in_seconds",
        "type": "FLOAT",
        "description": "The duration of travel through the route based on\ncurrent traffic conditions."
      },
      {
        "mode": "NULLABLE",
        "name": "static_duration_in_seconds",
        "type": "FLOAT",
        "description": "The duration of travel through the route without\ntaking traffic conditions into consideration."
      }
    ],
    "mode": "NULLABLE",
    "name": "travel_duration",
    "type": "RECORD",
    "description": "Legacy travel time information. May stop being populated on or after November 9, 2026. Use top-level duration_in_seconds and static_duration_in_seconds instead."
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "seconds",
        "type": "INTEGER",
        "description": "Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z inclusive."
      },
      {
        "mode": "NULLABLE",
        "name": "nanos",
        "type": "INTEGER",
        "description": "Non-negative fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be from 0 to 999,999,999 inclusive."
      }
    ],
    "mode": "NULLABLE",
    "name": "retrieval_time",
    "type": "RECORD",
    "description": "Legacy timestamp when the traffic data was collected. May stop being populated on or after November 9, 2026. Use retrieval_timestamp instead."
  },
  {
    "mode": "NULLABLE",
    "name": "route_geometry",
    "type": "STRING",
    "description": "Contains a geojson polyline representing the optimal route determined based on user's input waypoints"
  },
  {
    "mode": "REPEATED",
    "name": "road_segment_ids",
    "type": "STRING",
    "description": "Road segment place IDs along the route. They follow topological order and are always connected"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "start_offset",
        "type": "INTEGER",
        "description": "The distance offset from the start of the route in meters for the start of the interval (inclusive)."
      },
      {
        "mode": "NULLABLE",
        "name": "end_offset",
        "type": "INTEGER",
        "description": "The distance offset from the start of the route in meters for the end of the interval (exclusive; equals the start_offset of the subsequent interval)."
      },
      {
        "mode": "NULLABLE",
        "name": "speed",
        "type": "STRING",
        "description": "Describes the categorized current speed of traffic, aligned with the colors in the Google Maps traffic layer. Possible values are: \"NORMAL\" (green): Traffic is flowing smoothly, no slowdown is detected. \"SLOW\" (yellow): Slowdown detected, but no traffic jam formed. \"TRAFFIC_JAM\" (red): Traffic jam detected. \"TRAFFIC_JAM_HEAVY\" (dark red): Heavy traffic jam detected (available as of October 8, 2026)."
      }
    ],
    "mode": "REPEATED",
    "name": "speed_reading_offsets",
    "type": "RECORD",
    "description": "Offset-based speed reading intervals representing traffic density across the route; each interval is demarcated by the distance offset from the start of the route. Omitted when has_road_closure is true."
  },
  {
    "mode": "NULLABLE",
    "name": "duration_in_seconds",
    "type": "FLOAT",
    "description": "The duration of travel through the route based on current traffic conditions. Omitted when has_road_closure is true."
  },
  {
    "mode": "NULLABLE",
    "name": "static_duration_in_seconds",
    "type": "FLOAT",
    "description": "The duration of travel through the route without taking traffic conditions into consideration."
  },
  {
    "mode": "NULLABLE",
    "name": "retrieval_timestamp",
    "type": "TIMESTAMP",
    "description": "The time the traffic data was collected."
  },
  {
    "mode": "NULLABLE",
    "name": "has_road_closure",
    "type": "BOOLEAN",
    "description": "Whether there is a full road closure on the route. When true, duration_in_seconds and speed_reading_offsets are omitted because the route is impassable. A NULL value indicates that road closure information is undetermined."
  }
]