Updating docs for Terrain v2

[iandees]

• [x] Add new section for Footprints downloads / map preview under Data Sources page
• [x] Parity with vector tile docs
  • Add HTTP Status Codes: https://github.com/tilezen/vector-datasource/blob/master/docs/http-status-codes.md
    • [ ] Update Mapzen docs generator config to list this new file
  • Add in explanation about z, x, y coords from: https://github.com/tilezen/vector-datasource/blob/master/docs/use-service.md#specify-z-x-and-y-tile-coordinates to fix https://github.com/tilezen/joerd/issues/109.
• [x] Update attribution.md
• [x] Please also make reference to new sources in this "what-is-sourced-at-what-zooms" table
• [x] We also need to update this date note: https://github.com/tilezen/joerd/blob/master/docs/data-sources.md#data-updates
• [x] {256,512,260,516} 512 and buffered sizes are also now supported for normal and terrarium formats when access from Mapzen's hosted service (but not direct from S3 bucket). https://github.com/tilezen/joerd/blob/master/docs/formats.md#types-of-terrain-tiles
• [ ] Update general Mapzen docs about Terrain Tiles and what software is used (no longer Joerd, though we use Joerd to track the work, there's an issue tracking splitting that up): https://mapzen.com/documentation/overview/rate-limits/#mapzen-terrain-tiles

[iandees]

I started off with listing the new sources based on the stuff listed as completed in https://github.com/tilezen/joerd/projects/1.

[iandees]

@nvkelso want me to track down license and attribution info and add to the attribution doc, too?

[nvkelso]

want me to track down license and attribution info and add to the attribution doc, too?

@iandees Yes, please.

[nvkelso]

• [x] Please also make reference to new sources in this "what-is-sourced-at-what-zooms" table:

• https://github.com/tilezen/joerd/blob/master/docs/data-sources.md#what-is-sourced-at-what-zooms

Doesn't need to be full list, but at least point people over to the full sources list.

(This area is also where a live slippy map could be embedded.) deferred

[nvkelso]

• [x] We also need to update this date note:

• https://github.com/tilezen/joerd/blob/master/docs/data-sources.md#data-updates

Terrain tiles were built during 2016Q2 and 2016Q3 based on available sources at that time. Regular updates are not planned.

[nvkelso]

• [x] {256,512,260,516} 512 and buffered sizes are also now supported for normal and terrarium formats when access from Mapzen's hosted service (but not direct from S3 bucket).

• https://github.com/tilezen/joerd/blob/master/docs/formats.md#types-of-terrain-tiles

[nvkelso]

It's not allowing me to comment on this old block that needs updating, so here we go:

Generally speaking, GMTED is used at low-zooms, and ETOPO1 is used to show ocean bathymetry at all zooms (even bathymetry oversampled at zoom 15), and SRTM is relied on in mid- and high-zooms on land. In the United States, data from USGS supplements the SRTM land data to provide greater detail at 10 meters and in some areas at up to 3 meters.

• [x] We should generalize the United States statement to include other countries with direction to list above / table below.

[nvkelso]

@iandees as we're adding a new page here for the HTTP status codes we'll also need to update the Mapzen docs generator to know about the new entry.

[iandees]

I think this is ready for another 👀 , @nvkelso.

[nvkelso]

• [x] The table in https://github.com/tilezen/joerd/pull/151/commits/1bc0fd22a8ae059cf88f513bd8f8758e1b9abe41#diff-43f7d73496677f0287fb2b5a2db12325L127 should also be updated for the following sources and referencing https://github.com/mojodna/marblecutter/issues/28#issuecomment-317122788.

• NRCAN (30m to 90m)

• data.gov.at (austria, 10m)

• Kartverket (10m)

• Australia (10m)

• LINZ (8m)

• INEGI (mx_lidar, 5m)

• ArcticDEM (pgdc_5m, 5m)

• data.gov.uk (uk_lidar, 2m)

Not clear to me if we should use country names or exact source names. I've proposed country names below.

zoom	meters at equator	arc seconds	nominal arc degrees minutes seconds	source	nominal ground units
11	76.4	2.5	3 arc seconds	Canada	90m
12	38.2	1.2	1 arc seconds	SRTM, Canada	30m
13	19.1	0.6	2/3 arc seconds
14	9.6	0.3	1/3 arc seconds	3DEP, Austria, Australia, New Zealand, Norway	10m
15	4.8	0.2	1/5 arc seconds	Mexico, Arctic
16	2.4	0.1	1/9 arc seconds	3DEP, United Kingdom	3m

[nvkelso]

My changes for 512px documentation added a conflict in the docs/use-service.md file. Sorry!

[nvkelso]

Oh, we still need to update in the attribution.md:

Required attribution:

Required attribution when using Mapzen's hosted service:

And I think vector tiles has something like this to cover things that don't require attribution but we should thank anyhow (like ArcticDEM):

Optional attribution when using Mapzen's hosted service:

[nvkelso]

In data-sources.md:

SRTM globally except high latitudes, 30 meters in land areas

We need to indicate this is 30 meters but 90 meter nominal quality. to also explain why the map below says so much of the world is 90 meters when it's the 30 meter SRTM data.

[iandees]

we still need to update in the attribution.md

What should be updated? Is this supposed to include all the attribution statements from the CC-BY sources? What is different about this listing than the "when using Mapzen hosted service" other than including Mapzen?

[iandees]

We need to indicate this is 30 meters but 90 meter nominal quality

Fixed in b6d1081.

[nvkelso]

Regarding https://github.com/tilezen/joerd/pull/151#issuecomment-344055569, the reference docs are:

• https://github.com/tilezen/vector-datasource/blob/master/docs/attribution.md

***Required attribution:***

> © OpenStreetMap contributors, Who's On First

***Required attribution for Mapzen's hosted service:***

> Mapzen, © OpenStreetMap contributors, Who's On First

***Optional full attribution including all data projects:***

> Mapzen, © OpenStreetMap contributors, Who's On First, Natural Earth, and openstreetmapdata.com

[nvkelso]

Added * to 90m legend item in footprints preview image in 992c877f70ba04756321cb027493f3cca8573b3c. Ties in with Ian's earlier edit in https://github.com/tilezen/joerd/commit/b6d1081504fb1e0999caa34d800927c88f2e0fbf.