
Collect GTFS-RT data from a Protocol Buffers feed at regular intervals
Source:R/rt_collect_protobuf.R
rt_collect_protobuf.RdCollect GTFS-RT data from a Protocol Buffers feed at regular intervals
Usage
rt_collect_protobuf(
gtfs_rt_url,
destination_file,
fields_collect = c("id", "vehicle.trip.trip_id", "vehicle.position.latitude",
"vehicle.position.longitude", "vehicle.position.speed", "vehicle.timestamp",
"vehicle.current_status", "vehicle.current_stop_sequence", "vehicle.stop_id"),
scrape_interval = 60,
log_file = NA,
headers = NULL
)Arguments
- gtfs_rt_url
String. URL of the Protocol Buffers GTFS-RT feed.
- destination_file
String. File to save the downloaded GTFS-RT data. Content is appended in each iteration.
- fields_collect
Character vector. Fields to extract from each entity in the feed.
- scrape_interval
Integer (Default 60). Interval in seconds between each download. Negative to run only once.
- log_file
String (Optional). Path to a log file to save download logs.
- headers
Named list or character vector (Optional). Custom HTTP headers for credentials when accessing the GTFS-RT feed URL.
Details
Downloads GTFS-RT data from the specified URL at regular intervals and saves them to the destination file.
This function will run indefinitely until manually stopped (CTRL + C).
Examples
# Create file
destination_file <- withr::local_tempfile(fileext = ".csv")
# Collect data
GTFShift::rt_collect_protobuf(
gtfs_rt_url = "https://go.tmlmobilidade.pt/hub/api/v1/0XJC9/vehicles/positions/gtfs.pb",
destination_file = destination_file,
scrape_interval = -1 # Negative to run only once
)
#> [2026-11-05 13:48:53] Starting GTFS-RT data collection from https://go.tmlmobilidade.pt/hub/api/v1/0XJC9/vehicles/positions/gtfs.pb
#> [20261105_134853] Iteration 1 completed
#> [1] "/tmp/RtmpYA0vRV/file1e4b677b01d4.csv"
# Read data
if (file.exists(destination_file)) {
collection <- read.csv(destination_file)
names(collection)
head(
collection |>
dplyr::select(
"vehicle.trip.trip_id", "vehicle.position.latitude",
"vehicle.position.longitude"
)
)
}
#> vehicle.trip.trip_id vehicle.position.latitude
#> 1 [1NN3V][HF16N]M37-1-012-A-U-13h40-ELeclercNorte 38.7213
#> 2 [1NN3V][HF16N]M37-1-012-A-U-13h40-ELeclercNorte 38.7251
#> 3 [1NN3V][HF16N]M27-1-026-A-U-13h30-CascaisEstacaoA 38.6959
#> 4 [1NN3V][HF16N]M42-2-006-A-U-13h40-EscolaSecCarcav 38.7104
#> 5 [1NN3V][HF16N]M30-1-023-A-U-13h40-ParedeTerminalC 38.6928
#> 6 [1NN3V][HF16N]M33-2-016-A-U-13h45-ELeclercSDoming 38.7133
#> vehicle.position.longitude
#> 1 -9.3443
#> 2 -9.3426
#> 3 -9.4390
#> 4 -9.3295
#> 5 -9.3545
#> 6 -9.3370