whereonearth-state

Created: 2012-08-21 14:15
Updated: 2017-04-20 16:55

README.md

whereonearth-state

The short version

Where On Earth (WOE) data for countries smushed up with Natural Earth (NE) 1:10m data for "admin1" (states, provinces, regions and so on) areas. That's fancy talk for "polygons".

The longer version

It's still a bit of a moving target, specifically formatting and normalizing ket names in the properties hash. For example, all the NE property keys are prefixed with ne:.

Currently only about half the total number of WOE records have NE geometries associated with them. Some of that is simply because the WOE ID for a name (and ISO code) for a region in NE was not able to be derived using the Flickr geocoder.

The list of regions that still need to be geocoded is located in meta/states-needs-woeid.csv.

The long version

Forking GeoPlanet one place type a time.

This is an active but still experimental project to create a community-driven project to maintain and update the Creative Commons licensed GeoPlanet dataset.

Rather than create a single repository with every record the plan is to create smaller datasets organized by placetype in the hopes that they will be more manageable to download and to update by users interested in particular place types.

Each location (state) is stored as a separate GeoJSON file. GeoJSON was chosen because it has wide support in variety of GIS tools, most programming languages (and specifically JavaScript), can be edited using any old text editor (or Github's own "edit this page" functionality) and allows for any number of custom key/value pairs using the GeoJSON properties dictionary.

The naming convention for records is the state's Where On Earth (WOE) ID followed by a ".json" extension. Records are stored in nested directories that correspond to their WOE ID. The top level directory would be the first three digits of a WOE ID, the second level directory would be the following three digits (four through six) and so on until their are no more digits in the WOE ID.

This repository includes countries from GeoPlanet (versions 7.3 through 7.6) as compiled by woedb. Where possible records have already been updated to include corresponding concordances, for example Wikipedia or Geonames IDs.

Each record contains a bounding box or a complex polygon defining the contour of the country. Polygons are sourced from the August 2012 release of the Natural Earth 1:10m admin-1 boundaries.

A word about Github

In the long-run Github may not be the best venue for managing all of these records. But it's not an entirely crazy idea either so we're going to try it for a while because it's easy and safe.

To do

  • Finish mapping (geocoding) the Natural Earth shape files to WOE IDs and merging them with the WOE records.

  • Merge and update records from the GeoPlanet 7.10 release.

Other WOE repositories

See also

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more