oc_bbox: List of bounding boxes for OpenCage queries

Description Usage Arguments Value Examples

View source: R/oc_bbox.R

Description

Create a list of bounding boxes for OpenCage queries.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
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)
}

ropensci/opencage documentation built on Jan. 20, 2021, 3:38 a.m.