Static Maps

Static maps are standalone images which may be displayed on web, mobile and other visual displays without the need of a special mapping library. An Aeris Maps static map image allows for a combination of base maps, weather and other overlays to generate a single image. This static map looks like an embedded map though without any panning or zooming support.  Static maps can be requested by passing a center point and zoom level or using a bounding box.

Map via Center Point

The most common method for generating a map is to center the map on a single location at a specific zoom level:

https://maps.aerisapi.com/[client_id]_[client_key]/[layers]/[width]x[height]/[place],[z]/[offset].[format]

Examples:
https://maps.aerisapi.com/[client_id]_[client_key]/radar/300x300/44.96,-93.27,7/current.png
https://maps.aerisapi.com/[client_id]_[client_key]/flat,radar,admin/300x300/55415,7/current.png
https://maps.aerisapi.com/[client_id]_[client_key]/sat,radar:75/300x300/minneapolis,mn,7/current.jpg

Individual Static Map Variables

The following variables are required for each static map request.

Parameters Definitions
accessid (string) Unique access id for your API account.
layers (string) One or more overlays to add to the map.
Multiple overlays may be comma separated and will be added to the map. The layer will be combined in order, from left to right. Refer to the Layer Usage details and the Layer Types for a list of supported codes.
width (integer) The width of the map image in pixels.
height (integer) The height of the map image in pixels.
place (string) The location to center the map on. This maybe a latitude,longitude combination, us zip code, Canadian postal code, "City,State" combination or any Supported Places format supported by the Aeris API.
z (integer) The zoom level of the map. Must be between the minzoom and maxzoom supported by the base map and overlays. Values between 2 and 19 are normally supported. If no provided, a default value of 6 is utilized.
offset (integer|string) The time offset for the image. Refer to the Time Offsets details for more information.
format (string) The format of the image to return. See Image Quality.

Map via Bounding Box

You can also request static maps by defining a bounding box of the region you want display. In this case, the map's center coordinate and zoom level will determined automatically so that your requested region appears within the map's bounds. Note that some scaling of the image may occur to produce a map with the exact dimensions requested.

https://maps.aerisapi.com/[client_id]_[client_key]/[layers]/[width]x[height]/[south],[west],[north],[east]/[offset].[format]

Examples:
https://maps.aerisapi.com/[client_id]_[client_key]/radar/320x320/30.1010,-85.9578,33.0948,-82.4421/current.png
https://maps.aerisapi.com/[client_id]_[client_key]/flat,radar,admin/320x320/30.1010,-85.9578,33.0948,-82.4421/current.png
https://maps.aerisapi.com/[client_id]_[client_key]/sat,radar:75/320x320/30.1010,-85.9578,33.0948,-82.4421/current.jpg

Individual Static Map Variables

The following variables are required for each static map request.

Parameters Definitions
accessid (string) Unique access id for your API account.
layers (string) One or more overlays to add to the map.
Multiple overlays may be comma separated and will be added to the map. The layer will be combined in order, from left to right. Refer to the Layer Usage details and the Layer Types for a list of supported codes.
width (integer) The width of the map image in pixels.
height (integer) The height of the map image in pixels.
south (integer) The southern most (bottom) latitude coordinate of the bounding box, in degrees.
west (integer) The western most (left) longitude coordinate of the bounding box, in degrees.
north (integer) The northern most (top) latitude coordinate of the bounding box, in degrees.
east (integer) The eastern most (right) longitude coordinate of the bounding box, in degrees.
offset (integer|string) The time offset for the image. Refer to the Time Offsets details for more information.
format (string) The format of the image to return. See Image Quality.