From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg woeid
Provides a reference to a WOEID legacy identifier (WOEID is deprecated). Edit this description in the wiki page. Edit this description in the data item.
Group: annotations
URL pattern$1
Used on these elements
may be used on nodesmay be used on waysmay be used on areas (and multipolygon relations)may be used on relations
Status: undefined

WOEID (Where On Earth ID) was a global identifier maintained by Yahoo but it has been deprecated.

This key is used to reference the Yahoo GeoPlanet database for a given feature (eg a place) using that features WOEID (Where On Earth ID). The aim of GeoPlanet database is to provide a permanent ID for each place on earth, as well as provide a hierarchy between all the known places.

From the GeoPlanet documentation:

Yahoo! GeoPlanet helps bridge the gap between the real and virtual worlds by providing an open, permanent, and intelligent infrastructure for geo-referencing data on the Internet.

In practical terms, Yahoo! GeoPlanet is a resource for managing all geo-permanent named places on Earth. It provides the geographic developer community with the vocabulary and grammar to describe the world's geography in an unequivocal, permanent, and language-neutral manner. Developers can geo-enable their applications by using GeoPlanet to traverse the global spatial hierarchy, identify the geography relevant to their users and their businesses, and in turn, unambiguously geotag, geotarget, and geolocate data across the Web.


The WOEID for a place can be found through the GeoPlanet API (key required) or by parsing the data file available (under CC-by-3.0 licence) to download from their site.

Example usage (node 283522771):


External links