Overview

First Street Map Tiles provide map layers to overlay on various mapping platforms

The First Street Raster Map Tile API helps visualize the climate risk. Leverage the tiles on your own maps to create visualizations of various risk types. Tile layers are placed over the top of your map at a specific zoom level. With enough tiles you can provide your users with multiple zoom levels of climate risk.

Each raster map tile is 256x256 PNG image that is based off of the web mercator projection.

Retreiving a tile

Tiles can be retrieved by providing a Zoom (Z), X and Y coordinate. The X and Y value is based on the Mercator Projection. Remember to provide your API Key.

Retrieve a Map Tile

GET https://api.firststreet.org/v2/maps/tile/{peril}/{...product}/{z}/{x}/{y}.png

Get a tile

Path Parameters

Name	Type	Description
peril*	String	The climate risk peril
...product*	String	The product requested. Note that the product differs from each service
z*	String	The requested Map Zoom
x*	String	The X coordinate
y*	String	The Y coordinate

When using the map tile service publically, ensure that your API key is not leaked to the client. Proxy all requests through your own servers to prevent this.

Map Legends Representation

Each climate peril contains a query that provides mapLegend data against its product.

The represents field provides the min and max representation for the given color in provided unit. For example, if a color #FFF was provided and min range is 1 while max range is 4, #FFF should be used to represent 1-4 unit type.

Example

See this Fiddle for an example implementation using Google Maps. Change FSF_API_KEY where needed. Update the URL to the specific Tiles API you wish to test. Please note that these requests count towards your overall API usage.