From Wikipedia, the free encyclopedia
Jump to navigation Jump to search

A WOEID (Where On Earth IDentifier) is a unique 32-bit reference identifier, originally defined by GeoPlanet and now assigned by Yahoo!, that identifies any feature on Earth.[1][2] In 2009, Yahoo! released GeoPlanet's WOEID data to the public,[3] with the last release on 1 June 2012, after which Yahoo! decided to cease making the data downloadable until they "determine a better way to surface the data as a part of the service".[4]

WOEIDs are used by a number of other projects, including Flickr,[5] OpenStreetMap,[6] and Twitter.[7]


E.g. Berlin does not know about Germany, which itself doesn't know about Europe and so forth. GeoPlanet records, or places as they are called by Yahoo!, always (except one) have a reference to its parent place and therefore offer relations between places like the following:[8]

  • Parent (direct surrounding place)
  • Child (direct sub-places)
  • Siblings (places sharing the same parent and place type)
  • Ancestors (set of all parents)

If you take e.g. our company's district you will get the following family tree:

  • Deutschland (WOEID 23424829)
    • Bundesland Berlin (WOEID 2345496)
      • Stadtkreis Berlin (WOEID 1259838)
        • Berlin (WOEID 638242)
          • Ortsteil Pankow (WOEID 26821868)
          • Ortsteil Prenzlauer Berg (WOEID 26821872)
          • Ortsteil Wedding (WOEID 26821851)
        • Suan Luang (WOEID 12756344)
          • ...

See also[edit]


  1. ^ "Yahoo! WOEID Lookup". Zourbuth Project.
  2. ^ "WOEID Lookup". Find your WOEID.
  3. ^ "Free geo data solutions compared: GeoNames.org vs. Yahoo! GeoPlanet". Cosmo Code. 24 January 2010.
  4. ^ "Yahoo! GeoPlanet™ Data". Yahoo!. Archived from the original on 25 June 2014. Retrieved 25 June 2014.
  5. ^ "Flickr Services: Flickr API: flickr.places.getInfo". www.flickr.com. Retrieved 2016-05-01.
  6. ^ "Key:woeid - OpenStreetMap Wiki". wiki.openstreetmap.org. Retrieved 2016-05-01.
  7. ^ "Twitter Developer Documentation". developer.twitter.com. Retrieved 2019-01-08.
  8. ^ https://www.cosmocode.de/en/blog/schoenborn/2010-01/24-free-geo-data-solutions-compared-geonames.org-vs.-yahoo-geoplanet?