A page for every WOEID.

A page for every country (and their airports).

A page for every placetype.

A map for every WOEID.


Search nearby (and nearby-er still).


A blog post.

A podcast.

The Short Version

WoePlanet is WhereOnEarth (AKA WOE) (also AKA GeoPlanet) data, based on Yahoo's GeoPlanet Data download, with some, but not all, of the original hierarchy linkages reinstated, with some, but not all, centroid and polygon coordinates added in from other data sources and formatted as GeoJSON, one file per WOEID and organised by GeoPlanet place type.

The Long(er) Version

Forking GeoPlanet one place at a time ...

WoePlanet is an active but still experimental endeavour to create a community driven project to maintain, update and make public in a usable form the Creative Commons licensed GeoPlanet data set.

Right at the very start there was a set of closely coupled software and data called GeoPlanet, developed by UK based GDC (Graphical Data Capture).

The heart of GeoPlanet was a hierarchically linked set of geographic place definitions; so for any place you could determine all the language and colloquial name variants, the parent(s), the children and adjacent or neighbouring places.

Each entry in GeoPlanet was assigned a unique 32-bit identifier, known as a Whereonearth ID, or WOEID.

GDC was subsequently acquired by Whereonearth in 1998 with the software component rebranded as InternetLocality and the data retaining the GeoPlanet name.

In 2005, Whereonearth was itself acquired by Yahoo!, initially to form part of the internal search marketing program, internally named as Panama. Four years later, as part of the Yahoo! Developer Network, a set of APIs based on InternetLocality were publicly released as GeoPlanet and Placemaker. To avoid confusion over the use of the GeoPlanet name, the data set was internally rebranded as WhereHaĆ¼s (pun fully intentional) and GeoPlanet was used solely to refer to the API. Coincident to this, a version of the data set was released publicly under a CC-BY license as GeoPlanet Data.

GeoPlanet Data contained some of the hierarchical richness of the internal data, including parent and adjacent relationships, but omitted child, sibling, "belongsto" and ancestor relationships. All geospatial data, such as centroids, polygons and bounding boxes were also removed due to licensing restrictions from third party, proprietary data sources.

The GeoPlanet Data set continued to be maintained and updated until June 2012 when Yahoo! removed access to the downloads with a message saying We are currently making the data non-downloadable while we determine a better way to surface the data as a part of the service.

You can probably guess what happened, or rather what didn't happen ...

This hiatus remained until mid 2015 when Yahoo! finaly announced that the YDN GeoPlanet and Placemaker APIs would be shutting down, although equivalent functionality would be available via the YQL API and the BOSS Geo APIs. The GeoPlanet API finally shut down late in 2016 and YQL was shutdown in early 2019. The BOSS Geo APIs are currently still available behind the BOSS paywall.

The publicly released GeoPlanet Data dumps remain available via the Internet Archive and several projects were released to make use of the data, such as GPLplanet by ex-Yahoo! Geo Director of Product, Tyler Bell and woedb by ex-Flickr Lead Engineer Aaron Straup Cope, who went on to be one of the founding team members behind Who's on First.

Sadly woedb went offline in 2018 and WoePlanet is a rebooted and (hopefully) improved version of the woedb code base and data sets.