osrm (version 3.0.0)

osrmTrip: Get the Travel Geometry Between Multiple Unordered Points

Description

Build and send an OSRM API query to get the shortest travel geometry between multiple points. This function interfaces the trip OSRM service.

Usage

osrmTrip(loc, overview = "simplified")

Arguments

loc

a SpatialPointsDataFrame of the waypoints, or a data.frame with points as rows and 3 columns: identifier, longitudes and latitudes (WGS84 decimal degrees).

overview

"full", "simplified". Add geometry either full (detailed) or simplified according to highest zoom level it could be display on.

Value

A list of connected components. Each component contains:

trip

A SpatialLinesDataFrame (loc's CRS if there is one, WGS84 else) containing a line for each step of the trip.

summary

A list with 2 components: duration (in minutes) and distance (in kilometers).

Details

As stated in the OSRM API, if input coordinates can not be joined by a single trip (e.g. the coordinates are on several disconnecte islands) multiple trips for each connected component are returned.

See Also

osrmRoute

Examples

## Not run: 
# # Load data
# data("com")
# 
# # Get a trip with a id lat lon data.frame
# trips <- osrmTrip(loc = com[1101:1150, c(1,3,4)])
# 
# # Display the trip
# sp::plot(trips[[1]]$trip , col = 1:5)
# points(com[1101:1150, 3:4], pch = 20, col = "red", cex = 0.5)
# 
# # Map
# if(require("cartography")){
#   osm <- getTiles(spdf = trips[[1]]$trip, crop = TRUE, type = "osmgrayscale")
#   tilesLayer(osm)
#   plot(trips[[1]]$trip, col = 1:5, add = TRUE)
#   points(com[1101:1150, 3:4], pch = 20, col = "red", cex = 0.5)
# }
# 
# # Get a trip with a SpatialPointsDataFrame
# trips <- osrmTrip(loc = src)
# 
# # Map
# if(require("cartography")){
#   osm <- getTiles(spdf = trips[[1]]$trip, crop = TRUE, type = "osmgrayscale")
#   tilesLayer(osm)
#   plot(src, pch = 20, col = "red", cex = 2, add = TRUE)
#   plot(trips[[1]]$trip, col = 1:5, add = TRUE, lwd=2)
# }
# ## End(Not run)