get_geo_box function

Get geographic entities based on a bounding box

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

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.
• \dots: further arguments to pass to httr's GET.

Returns

a data.frame of 5 columns:

• itemthe Wikidata identifier of each object associated with entity.
• namethe name of the item, if available, in the requested language. If it is not available, NA will be returned instead.
• latitudethe latitude of item
• longitudethe longitude of item
• entitythe entity the item is associated with (necessary for multi-entity queries).

Examples

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

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

See Also

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