Skip to content

Commit

Permalink
Merge pull request #111 from tilezen/kkowalsky/api-updates
Browse files Browse the repository at this point in the history
update api key info
  • Loading branch information
nvkelso authored Nov 1, 2016
2 parents e00a3a1 + 73958bd commit 3c42ea0
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 17 deletions.
7 changes: 1 addition & 6 deletions docs/api-keys-and-rate-limits.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,7 @@

## Obtain an API key

To use Mapzen Terrain Tiles, you should first obtain a free developer API key. Sign in at https://mapzen.com/developers to create and manage your API keys.

1. Go to https://mapzen.com/developers.
2. Sign in with your GitHub account. If you have not done this before, you need to agree to the terms first.
3. Create a new key for Mapzen, and optionally, give it a name so you can remember the purpose of the project.
4. Copy the key into your code.
To use the Mapzen Terrain Tile service, you should [first obtain a free developer API key](https://mapzen.com/documentation/overview/).

## Rate limits

Expand Down
16 changes: 5 additions & 11 deletions docs/use-service.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,35 +4,29 @@ The Mapzen terrain tiles provide basemap elevation coverage of the world in a ra

## Get an API key

To use the Mapzen Terrain Tiles service, you must first get a developer API key. Sign in at https://mapzen.com/developers to create and manage your API keys.

1. Go to https://mapzen.com/developers.
2. Sign in with your GitHub account. If you have not done this before, you need to agree to the terms first.
3. Create a new key for Mapzen Search, and optionally, give it a name so you can remember the purpose of the project.
4. Copy the key into the terrain URL where `mapzen-xxxxxxx` represents your key.

To start integrating terrain tiles to your project you need a [developer API key](https://mapzen.com/documentation/overview/).

## Requesting tiles

You can request tiles using Mapzen's global CDN:

##### Terrarium

`https://tile.mapzen.com/mapzen/terrain/v1/terrarium/{z}/{x}/{y}.png?api_key=mapzen-xxxxxxx`
`https://tile.mapzen.com/mapzen/terrain/v1/terrarium/{z}/{x}/{y}.png`

##### Normal

`https://tile.mapzen.com/mapzen/terrain/v1/normal/{z}/{x}/{y}.png?api_key=mapzen-xxxxxxx`
`https://tile.mapzen.com/mapzen/terrain/v1/normal/{z}/{x}/{y}.png`

##### GeoTIFF

`https://tile.mapzen.com/mapzen/terrain/v1/geotiff/{z}/{x}/{y}.tif?api_key=mapzen-xxxxxxx`
`https://tile.mapzen.com/mapzen/terrain/v1/geotiff/{z}/{x}/{y}.tif`

Note: GeoTIFF format tiles are 512x512 sized so request the parent tile’s coordinate. For instance, if you’re looking for a zoom 14 tile then request the parent tile at zoom 13.

##### Skadi

`https://tile.mapzen.com/mapzen/terrain/v1/skadi/{N|S}{y}/{N|S}{y}{E|W}{x}.hgt.gz?api_key=mapzen-xxxxxxx`
`https://tile.mapzen.com/mapzen/terrain/v1/skadi/{N|S}{y}/{N|S}{y}{E|W}{x}.hgt.gz`

#### Additional Amazon S3 Endpoints

Expand Down

0 comments on commit 3c42ea0

Please sign in to comment.