get_geo_entity function

Retrieve geographic information from Wikidata

get_geo_entity retrieves the item ID, latitude and longitude of any object with geographic data associated with another

object with geographic data (example: all the locations around/near/associated with a city).

get_geo_entity(entity, language = "en", radius = NULL, limit = 100, ...)

Arguments

• entity: a Wikidata item (Q...) or series of items, to check for associated geo-tagged items.

• language: the two-letter language code to use for the name of the item. "en" by default, because we're imperialist anglocentric westerners.

• radius: optionally, a radius (in kilometers) around entity

  to restrict the search to.

• limit: the maximum number of results to return.

• \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

# All entities
sf_locations <- get_geo_entity("Q62")

# Entities with French, rather than English, names
sf_locations <- get_geo_entity("Q62", language = "fr")

# Entities within 1km
sf_close_locations <- get_geo_entity("Q62", radius = 1)

# Multiple entities
multi_entity <- get_geo_entity(entity = c("Q62", "Q64"))

See Also

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