oc_bbox: List of bounding boxes for OpenCage queries

In opencage: Geocode with the OpenCage API

Description

Create a list of bounding boxes for OpenCage queries.

Usage

oc_bbox(...)

## S3 method for class 'numeric'
oc_bbox(xmin, ymin, xmax, ymax, ...)

## S3 method for class 'data.frame'
oc_bbox(data, xmin, ymin, xmax, ymax, ...)

## S3 method for class 'bbox'
oc_bbox(bbox, ...)

Arguments

...	Ignored.
xmin	Minimum longitude (also known as min_lon, southwest_lng, west, or left).
ymin	Minimum latitude (also known as min_lat, southwest_lat, south, or bottom).
xmax	Maximum longitude (also known as max_lon, northeast_lng, east, or right).
ymax	Maximum latitude (also known as max_lat, northeast_lat, north, or top).
data	A data.frame containing at least 4 columns with xmin, ymin, xmax, and ymax values, respectively.
bbox	A bbox object, see sf::st_bbox.

Value

A list of bounding boxes, each of class bbox.

Examples

oc_bbox(-5.63160, 51.280430, 0.278970, 51.683979)

xdf <-
  data.frame(
    place = c("Hamburg", "Hamburg"),
    northeast_lat = c(54.0276817, 42.7397729),
    northeast_lng = c(10.3252805, -78.812825),
    southwest_lat = c(53.3951118, 42.7091669),
    southwest_lng = c(8.1053284, -78.860521)
  )
oc_bbox(
  xdf,
  southwest_lng,
  southwest_lat,
  northeast_lng,
  northeast_lat
)

# create bbox list column with dplyr
library(dplyr)
xdf %>%
  mutate(
    bbox =
      oc_bbox(
        southwest_lng,
        southwest_lat,
        northeast_lng,
        northeast_lat
      )
  )

# create bbox list from a simple features bbox
if (requireNamespace("sf", quietly = TRUE)) {
  library(sf)
  bbox <- st_bbox(c(xmin = 16.1, xmax = 16.6, ymax = 48.6, ymin = 47.9),
    crs = 4326
  )
  oc_bbox(bbox)
}

opencage documentation built on Feb. 20, 2021, 1:06 a.m.