Match flow with vector tiles

Author: nvkelso

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