GISSB (version 1.1)

coords_to_node: Connect coordinates to the nearest nodes in the road network

Description

The function coords_to_node can be used to find the nearest nodes in the Norwegian road network (in meters) for chosen coordinates.

Usage

coords_to_node(
  coords,
  nodes_object = nodes,
  edges_object = edges,
  direction = "from",
  ID_col = "ID",
  crs_out = 25833,
  knn = 1,
  membership = FALSE
)

Value

An object (data.frame) with the following columns; from_nodeID/to_nodeID, membership_from_node/membership_to_node, coords_google_from_node/coords_google_to_node, knn_from_node/knn_to_node, and ID.

Arguments

coords

An sf object with the coordinates that should be connected to the road network.

nodes_object

An sf object with the nodes of the road network. This can be created with the function vegnett_to_R().

edges_object

A data frame with the edges of the road network. This can be created with the function vegnett_to_R().

direction

Character vector with from if the points should be from nodes or to if the points should be to nodes.

ID_col

Character vector with the name of the ID column. Default value is set to “ID”.

crs_out

Numeric vector for the chosen coordinate reference system (CRS).

knn

Numeric vector with the chosen number of nodes that should be returned for each of the coordinates. If knn = 1 only the nearest nodes to the chosen coordinates will be returned. If knn = 2 the two nearest nodes will be returned etc.

membership

Logical. If TRUE the search for nodes is limited to nodes that belong to a road network that is connected either to the from or to nodes (only possible for either from or to). E.g. if you only want to search for from nodes that belong to the same road network as the to nodes, membership is set to FALSE in the search for to nodes and membership = TRUE for the from nodes (in that order).

Details

Before the function can be used, the nodes of the road network must be converted to an sf object that is called nodes (or another name supplied to the nodes_object argument). This can be done with the function vegnett_to_R().

Examples

coords <- address_to_coords(zip_code = "0185", address = "Schweigaards gate 10")
coords_to_node(coords = coords,
               direction = "from",
               nodes_object = nodes_sampledata,
               edges_object = edges_sampledata)