data-services/common-data/README.md

Data library 
====

## Datasets available in the library


### Physical datasets
#### World rivers
**Description**: Most of the world rivers.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_50m_rivers_lake_centerlines

**Sync table**: `true`

#### Ocean
**Description**: Oceanic region.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_50m_ocean

**Sync table**: `true`

#### Land
**Description**: Land region.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_50m_land

**Sync table**: `true`

#### Glaciers
**Description**: Glaciers and recently de-glaciated areas.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_glaciated_areas

**Sync table**: `false`

#### Reefs
**Description**: Coral reefs and atolls.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_10m_reefs

**Sync table**: `true`

#### Coastlines
**Description**: Lines around the world coasts.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_110m_coastline

**Sync table**: `true`

#### Lakes
**Description**: Natural and artificial lakes.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_50m_lakes

**Sync table**: `true`

#### Boundaries of the US National Parks 
**Description**: National Parks Boundaries.

**Source**: [Data.gov](https://catalog.data.gov/dataset/national-park-boundariesf0a4c)

**License**:

**Table name**: nps_boundary

**Sync table**: `false`

#### SF Elevation Contours
**Description**: Elevation contours with a five-foot interval for SF mainland and Treasure Island/Yerba Island.

**Source**: [DataSF](https://data.sfgov.org)

**License**:

**Table name**: phys_contours_sf

**Sync table**: `false`

#### US realtime earthquakes
**Description**: Earthquakes in the last day, updated every hour.

**Source**: [U.S. Geological Survey](http://www.usgs.gov/)

**License**:

**Table name**: all_day

**Sync table**: `true`

#### Storm events 2014
**Description**: Storm event locations in the U.S. 2014.

**Source**: [NOAA's NCDC](http://www.ncdc.noaa.gov/stormevents/)

**License**:

**Table name**: stormevents_locations_2014

**Sync table**: `true`

#### Realtime US streamflow stations
**Description**: Locations of +4,000 stream gaging stations and streamflow information.

**Source**:  [National Atlas](http://nationalatlas.gov/)

**License**:

**Table name**: realstx

**Sync table**: `true`

***

### Cultural datasets

#### Urban areas
**Description**: Areas of human habitation.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_50m_urban_areas

**Sync table**: `true`

#### Populated places
**Description**: Most populated places.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_10m_populated_places_simple

**Sync table**: `true`

#### International seaports
**Description**: Seaports in the world.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_10m_ports

**Sync table**: `true`

#### World airports
**Description**: Major airports in the world.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_10m_airports

**Sync table**: `true`

#### New York: Areas of interest
**Description**: Areas of interest labels as depicted in New York: A City of Neighborhoods.

**Source**: [NYC Open Data](https://nycopendata.socrata.com/)

**License**:

**Table name**: areas_of_interest_newyork

**Sync table**: `false`

#### Melbourne Streets
**Description**: Lines and names for the streets in the city of Melbourne.

**Source**: [City of Melbourne](https://data.melbourne.vic.gov.au)

**License**:

**Table name**: street_name_labels_melbourne

**Sync table**: `false`

#### Bicycle routes: New York
**Description**: Bicycle routes around New York state.

**Source**: [NYSDOT](https://www.dot.ny.gov/display/programs/bicycle)

**License**:

**Table name**: bikeroutes_ny

**Sync table**: `false`

#### SF Zoning Districts
**Description**: Geometries for the zoning districts in San Francisco.

**Source**: [DataSF](https://data.sfgov.org)

**License**:

**Table name**: zoning_districts_sf

**Sync table**: `false`

#### GDELT Hourly
**Description**: GDELT media mentions, updated hourly.

**Source**: [GDELT API](http://data.gdeltproject.org/cartodb/GDELTGKG-CARTODB-HOURLY.geojson.zip)

**License**:

**Table name**: gdeltgkg_cartodb_hourly

**Sync table**: `true`

#### Valencia
**Description**: Geometries for the building footprints of Valencia.

**Source**: [Valencia Datos Abiertos](http://www.valencia.es/ayuntamiento/datosabiertos.nsf/fCategoriaVistaAcc_busqueda?ReadForm&lang=1&nivel=2&seccion=1&Vista=vCategoriasAccTodas&Categoria=Sin_categoria&idapoyo=22ADF97C1FD223B5C1257C55003BD01F)

**License**:

**Table name**: manzanas_pob

**Sync table**: `false`

#### Valencia
**Description**: Geometries for the building footprints of Valencia.

**Source**: [Valencia Datos Abiertos](http://www.valencia.es/ayuntamiento/datosabiertos.nsf/fCategoriaVistaAcc_busqueda?ReadForm&lang=1&nivel=2&seccion=1&Vista=vCategoriasAccTodas&Categoria=Sin_categoria&idapoyo=22ADF97C1FD223B5C1257C55003BD01F)

**License**:

**Table name**: manzanas_pob

**Sync table**: `false`

#### USA airports
**Description**: All the airports in the United States.

**Source**: [National Atlas](http://http://nationalatlas.gov/)

**License**:

**Table name**: usa_airports

**Sync table**: `false`

#### Timezones
**Description**: Includes 24+ timezones with local offsets.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_10m_time_zones

**Sync table**: `true`

#### Local storm reports
**Description**: Local storm reports last 24 hours, updated every hour.

**Source**: [IEM Data](https://mesonet.agron.iastate.edu/)

**License**:

**Table name**: lsr_24hour

**Sync table**: `true`

#### Weather warnings & advisories
**Description**: Real-time U.S. weather warnings & advisories, updated every hour.

**Source**: [IEM Data](https://mesonet.agron.iastate.edu/)

**License**:

**Table name**: current_ww

**Sync table**: `true`

#### NYC Subways
**Description**: All the NYC Subways.

**Source**: 

**License**:

**Table name**: nyc_subway_entrance

**Sync table**: `false`

#### NYC Community Districts
**Description**: Boundaries of the community districts in NYC.

**Source**: [NYC Open Data](https://data.cityofnewyork.us/)

**License**:

**Table name**: ny_community_districts

**Sync table**: `false`

#### Major streets in Chicago
**Description**: Geometries for the major streets in Chicago.

**Source**: [Chicago Open Data](https://data.cityofchicago.org/)

**License**:

**Table name**: chicago_major_streets

**Sync table**: `false`

#### NYC School Districts
**Description**: Boundaries of school districts in New York City.

**Source**: [NYC Open Data](https://data.cityofnewyork.us/)

**License**:

**Table name**: nyc_school_districts

**Sync table**: `false`

#### T3chFest at Twitter
**Description**: Twitter sample data about how the world tweeted about T3chFest.

**Source**: 

**License**:

**Table name**: twitter_t3chfest_reduced

**Sync table**: `false`

#### San Francisco Neighborhoods
**Description**: Planning neighborhoods in San Francisco.

**Source**: [DataSF](https://data.sfgov.org)

**License**:

**Table name**: sf_planning_neighborhoods

**Sync table**: `false`

#### San Francisco Streets
**Description**: Lines for all the streets in San Francisco.

**Source**: [DataSF](https://data.sfgov.org)

**License**:

**Table name**: sf_stclines

**Sync table**: `false`

#### Melbourne building footprints
**Description**: Building footprints in the city of Melbourne.

**Source**: [City of Melbourne](https://data.melbourne.vic.gov.au)

**License**:

**Table name**: buildingfootprints_melbourne

**Sync table**: `false`

#### Valencia Streets
**Description**: The streets of Valencia, Spain.

**Source**: [Valencia Datos Abiertos](http://www.valencia.es/ayuntamiento/datosabiertos.nsf/fCategoriaVistaAcc_busqueda?ReadForm&lang=1&nivel=2&seccion=1&Vista=vCategoriasAccTodas&Categoria=Sin_categoria&idapoyo=22ADF97C1FD223B5C1257C55003BD01F)

**License**:

**Table name**: ejes_calle

**Sync table**: `false`

#### Barrios de Madrid
**Description**: Geometries for the Madrid city neighborhoods.

**Source**: [Madrid Datos Abiertos](http://datos.madrid.es/)

**License**:

**Table name**: barrios

**Sync table**: `false`

#### Railroads
**Description**: Railroads in the world.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_10m_railroads

**Sync table**: `false` (File is truncated in GitHub. Sync disabled to avoid errors)

#### Roads
**Description**: Roads in the world.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_10m_roads

**Sync table**: `true`

***

### Administrative regions 
#### Spanish comarcas
**Description**: Geometries, identifiers and names for these Spanish regions.

**Source**: [MAGRAMA](http://www.magrama.gob.es/es/)

**License**:

**Table name**: comarcas

**Sync table**: `false` 


#### Spanish provinces
**Description**: Geometries for all the spanish provinces.

**Source**: [MAGRAMA](http://www.magrama.gob.es/es/)

**License**:

**Table name**: spanish_adm2_provinces

**Sync table**: `false`

#### Berlin districts regions
**Description**: Geometries for the regions of the districts (bezirksregionen) in Berlin.

**Source**: [Berlin Open Data](http://daten.berlin.de/)

**License**:

**Table name**: lor_bezirksregionen_berlin

**Sync table**: `false`

#### Berlin districts
**Description**: Polygon geometries for all the districts in Berlin.

**Source**: [Berlin Open Data](http://daten.berlin.de/)

**License**:

**Table name**: berlin_ortsteile

**Sync table**: `false`

#### UK administrative regions
**Description**: Contains geometries for UK districts, counties, boroughs...

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: uk_administrative_regions

**Sync table**: `false`

#### Autonomous communities of Spain
**Description**: Geometries for autonomous communities and cities in Spain.

**Source**: [MAGRAMA](http://www.magrama.gob.es/es/)

**License**:

**Table name**: spain_adm1_ccaa

**Sync table**: `false`

#### Continents
**Description**: Geometries for continents.

**Source**: 

**License**:

**Table name**: continents

**Sync table**: `false` 

#### Melbourne zipcodes
**Description**: Boundaries for Melbourne zipcode areas.

**Source**: [City of Melbourne](https://data.melbourne.vic.gov.au)

**License**:

**Table name**: post_code_areas_melbourne

**Sync table**: `false` 

#### England regions
**Description**: Regions of England.

**Source**: [NRS](http://www.nrs.co.uk/)

**License**:

**Table name**: england_regions_2011

**Sync table**: `false` 


#### US Congressional Districts
**Description**: US congressional districts, 2015

**Source**: [UCLA Dept. of Political Science](http://cdmaps.polisci.ucla.edu/)

**License**:

**Table name**: congressional_districts_2015

**Sync table**: `false` 

#### Null Island
**Description**: Null Island geometry.

**Source**: [Nixta's Null Island](https://github.com/nixta/null-island)

**License**:

**Table name**: null_island_geo_proc

**Sync table**: `false` 

#### Regions of Metropolitan France
**Description**: Geometries for the 22 regions in the Metropolitan France.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: france_admin1_metro

**Sync table**: `false` 

#### World borders
**Description**: World countries borders.

**Source**: 

**License**:

**Table name**: world_borders

**Sync table**: `false` 

#### New York counties
**Description**: All the New York counties.

**Source**: 

**License**:

**Table name**: counties_ny

**Sync table**: `false` 

#### USA states
**Description**: All the states of the United States of America.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ne_50m_admin_1_states

**Sync table**: `false` (Custom dataset from NE 50m_admin1)

#### USA counties
**Description**: All USA counties and their information.

**Source**: [US Census](https://www.census.gov)

**License**:

**Table name**: cb_2013_us_county_500k

**Sync table**: `false` 

#### African countries
**Description**: All countries within the african continent.

**Source**: [Disruptive Geo](http://www.disruptivegeo.com/)

**License**:

**Table name**: africa_adm0

**Sync table**: `false` 

#### Asian countries
**Description**: All countries in Asia.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: asia_adm0

**Sync table**: `false` 

#### South American countries
**Description**: All countries in South America.

**Source**: [Disruptive Geo](http://www.disruptivegeo.com/)

**License**:

**Table name**: samerica_adm0

**Sync table**: `false` 

#### North American countries
**Description**: All countries in North America.

**Source**: [Disruptive Geo](http://www.disruptivegeo.com/)

**License**:

**Table name**: north_america_adm0

**Sync table**: `false` 

#### Oceania countries
**Description**: All countries in Oceania.

**Source**: [Disruptive Geo](http://www.disruptivegeo.com/)

**License**:

**Table name**: oceania_adm0

**Sync table**: `false` 

#### European countries
**Description**: European countries geometries.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: european_countries

**Sync table**: `false` 

#### Departments of France
**Description**: Geometries for the 96 departments of France.

**Source**: [GeoNetwork](http://salbgeonetwork.grid.unep.ch/geonetwork/srv/en/main.home)

**License**:

**Table name**: france_adm2_departments

**Sync table**: `false` 

#### States and territories of Australia
**Description**: Lands administrative divisions of Australia.

**Source**: [GeoNetwork](http://salbgeonetwork.grid.unep.ch/geonetwork/srv/en/main.home)

**License**:

**Table name**: australia_adm1

**Sync table**: `false` 

#### Ireland counties
**Description**: Geometries for traditional and administrative counties in Ireland.

**Source**: [Natural Earth Data](http://naturalearthdata.com)

**License**:

**Table name**: ireland_counties

**Sync table**: `false` 

#### Madrid districts
**Description**: District geometries for Madrid city.

**Source**: [Ayuntamiento de Madrid](http://datos.madrid.es/)

**License**:

**Table name**: distritos

**Sync table**: `false` 

***

### Building footprints
#### Bronx
**Description**: MapPLUTO building footprints of the Bronx district in New York.

**Source**: [NYC Planning](http://www.nyc.gov/html/dcp/home.html)

**License**:

**Table name**: bxmappluto

**Sync table**: `false`