Match flow with vector tiles

tilezen · May 5, 2017 · e615522 · e615522
1 parent 7dfea8b
commit e615522
Showing 1 changed file with 18 additions and 6 deletions.
diff --git a/docs/use-service.md b/docs/use-service.md
@@ -14,35 +14,47 @@ Once you have your Mapzen API key you'll need include it with Terrain Tile reque
 
 ## Requesting tiles
 
-You can request tiles using Mapzen's global CDN:
+Request a single tile with this URL pattern to get started:
+
+```
+https://tile.mapzen.com/mapzen/terrain/v1/{layers}/{z}/{x}/{y}.{format}?api_key={your_mapzen_api_key}
+```
+
+The [OpenStreetMap Wiki](http://wiki.openstreetmap.org/wiki/Slippy_map_tilenames) has more information on this url scheme.
+
+Here’s a sample tile in Normal format:
+
+```
+http://tile.mapzen.com/mapzen/terrain/v1/normal/11/330/790.png?api_key=your_mapzen_api_key
+```
 
 ##### Terrarium
 
 ```
-https://tile.mapzen.com/mapzen/terrain/v1/terrarium/{z}/{x}/{y}.png?api_key=your_mapzen_api_key
+https://tile.mapzen.com/mapzen/terrain/v1/terrarium/{z}/{x}/{y}.png?api_key={your_mapzen_api_key}
 ```
 
 ##### Normal
 
 ```
-https://tile.mapzen.com/mapzen/terrain/v1/normal/{z}/{x}/{y}.png?api_key=your_mapzen_api_key
+https://tile.mapzen.com/mapzen/terrain/v1/normal/{z}/{x}/{y}.png?api_key={your_mapzen_api_key}
 ```
 
 ##### GeoTIFF
 
 ```
-https://tile.mapzen.com/mapzen/terrain/v1/geotiff/{z}/{x}/{y}.tif?api_key=your_mapzen_api_key
+https://tile.mapzen.com/mapzen/terrain/v1/geotiff/{z}/{x}/{y}.tif?api_key={your_mapzen_api_key}
 ```
 
 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=your_mapzen_api_key
+https://tile.mapzen.com/mapzen/terrain/v1/skadi/{N|S}{y}/{N|S}{y}{E|W}{x}.hgt.gz?api_key={your_mapzen_api_key}
 ```
 
-Note: Skadi files are split into 1° by 1° grids. File names refer to the latitude and longitude of the lower left corner of the tile - e.g. N37W105 has its lower left corner at 37 degrees north latitude and 105 degrees west longitude. For example:  N37W105: `https://tile.mapzen.com/mapzen/terrain/v1/skadi/N37/N37W105.hgt.gz?api_key=your_mapzen_api_key`.
+Note: Skadi files are split into 1° by 1° grids. File names refer to the latitude and longitude of the lower left corner of the tile - e.g. N37W105 has its lower left corner at 37 degrees north latitude and 105 degrees west longitude. For example:  N37W105: `https://tile.mapzen.com/mapzen/terrain/v1/skadi/N37/N37W105.hgt.gz?api_key={your_mapzen_api_key}`.
 
 #### Additional Amazon S3 Endpoints