Get the distances of stops along routes. — get_stop

This function returns the linear distance of each stop along a route shape, starting from the route's beginning terminal. Unless a shape_geometry is provided, stops will be project onto all shape_ids that serve them. If a shape_geometry is provided, the function will look only for stops served by that shape.

Usage

get_stop_distances(gtfs, shape_geometry = NULL, project_crs = 4326)

Arguments

gtfs: A tidygtfs object.
shape_geometry: Optional. The SF object to project onto. Must include the field shape_id. See get_shape_geometry(). Default is NULL, where all shapes in gtfs will be used.
project_crs: Optional. A numeric EPSG identifer indicating the coordinate system to use for spatial calculations. Consider setting to a Euclidian projection, such as the appropriate UTM zone. Default is 4326 (WGS 84 ellipsoid).

Value

A dataframe containing stop_id, the shape_id it was projected onto, and distance, in units of the spatial projection (e.g., meters if using UTM).

Examples

# Set my parameters
my_shape <- "C53:04"
my_crs <- 32618
my_route <- "C53"
my_dir <- 0

# Get needed GTFS data
c53_gtfs <- filter_by_route(gtfs = wmata_gtfs, route_ids = my_route,
                            dir_id = 0)
c53_shape <- get_shape_geometry(gtfs = wmata_gtfs, shape = my_shape,
                                project_crs = my_crs)

# Run stop distances function
c53_stop_dists <- get_stop_distances(gtfs = c53_gtfs,
                                     shape_geometry = c53_shape,
                                     project_crs = my_crs)
head(c53_stop_dists)
#> # A tibble: 6 × 8
#>   stop_id stop_code stop_name       stop_desc zone_id stop_url shape_id distance
#>   <chr>   <chr>     <chr>           <chr>     <chr>   <chr>    <chr>       <dbl>
#> 1 2584    1000181   Alabama Av SE+… NA        NA      NA       C53:04       677.
#> 2 2609    1000188   Alabama Av SE+… NA        NA      NA       C53:04       880.
#> 3 2683    1000203   Alabama Av SE+… NA        NA      NA       C53:04      1155.
#> 4 2793    1000219   Alabama Av SE+… NA        NA      NA       C53:04      1605.
#> 5 2811    1000225   Alabama Av SE+… NA        NA      NA       C53:04      1807.
#> 6 2867    1000238   Alabama Av SE+… NA        NA      NA       C53:04      2037.