Skip to contents

Tag coordinates with the country that contains them

Source: R/geometry.R
locate_country.Rd

Point-in-polygon lookup: given longitude / latitude vectors (or an sf POINT object), return the iso3c of the country each point falls in – the bridge for getting point data (events, stations, observations) onto the country spine so it can be joined, aggregated and mapped like everything else.

Usage

locate_country(
  lon = NULL,
  lat = NULL,
  points = NULL,
  scale = "small",
  add = "country"
)

Arguments

lon, lat

Numeric vectors of longitude / latitude (recycled together; ignored if points is supplied).

points

Optional sf POINT object to use instead of lon/lat.

scale

Natural Earth resolution for the lookup geometry.

add

Extra attributes to return alongside iso3c (any convert_country() destination, e.g. "country", "continent").

Value

A tibble with one row per point: iso3c plus any add columns (NA for points that fall in no country, e.g. open ocean).

Examples

if (FALSE) { # \dontrun{
locate_country(lon = c(2.35, -74.0), lat = c(48.85, 40.7))  # Paris, NYC
} # }