get_geo_box: Get geographic entities based on a bounding box

In Ironholds/WikidataR: API Client Library for 'Wikidata'

Description

get_geo_box retrieves all geographic entities in Wikidata that fall between a bounding box between two existing items with geographic attributes (usually cities).

Usage

get_geo_box(first_city_code, first_corner, second_city_code, second_corner,
  language = "en", ...)

Arguments

first_city_code	a Wikidata item, or series of items, to use for one corner of the bounding box.
first_corner	the direction of first_city_code relative to city (eg "NorthWest", "SouthEast").
second_city_code	a Wikidata item, or series of items, to use for one corner of the bounding box.
second_corner	the direction of second_city_code relative to city (eg "NorthWest", "SouthEast").
language	the two-letter language code to use for the name of the item. "en" by default.
...	further arguments to pass to httr's GET.

Value

a data.frame of 5 columns:

• item the Wikidata identifier of each object associated with entity.

• name the name of the item, if available, in the requested language. If it is not available, NA will be returned instead.

• latitude the latitude of item

• longitude the longitude of item

• entity the entity the item is associated with (necessary for multi-entity queries).

See Also

get_geo_entity for using an unrestricted search or simple radius, rather than a bounding box.

Examples

# Simple bounding box
bruges_box <- WikidataR:::get_geo_box("Q12988", "NorthEast", "Q184287", "SouthWest")

# Custom language
bruges_box_fr <- WikidataR:::get_geo_box("Q12988", "NorthEast", "Q184287", "SouthWest",
                                        language = "fr")

Ironholds/WikidataR documentation built on May 7, 2019, 6:38 a.m.