Mappls Still Map Image API¶

The Still Map Image API creates a map based on URL parameters sent through a standard HTTP request and returns the map as an image which you can display on your application. The API lets you embed Mappls Maps image according to geo-position, pixel size and zoom level of the map on your application without requiring any dynamic page loading. The image can be a retina image and markers can be added to the image to indicate position of any object.

API URL¶

The API URL should be of the following construct: https://apis.mappls.com/advancedmaps/v1//still_image?
Output format will be an 8-bit PNG image of varying sizes.
The method used is POST.

Request Parameters¶

Returns PNG data to draw map tile at position specified with coordinates (centre of the image), image size, scale factor and zoom level. The request parameters that specify the image.

Mandatory Parameters:¶

licence_key: The REST API licence key allocated to you.
center: A WGS-84 position coordinate that specifies the centre of the image requested.

Optional Parameters:¶

zoom: The zoom level for which the image is requested. Ranges from 4 to 18 with 18 being the highest zoomed in level.
size: The size of the image requested in pixels as x.
ssf:scale factor indicating retina or non-retina tiles. 0→non-retina tiles. 1→retina tiles.
markers: Optional markers that you may want to add to the map tile.
markers_icon: The URL of the Custom Marker.

Response Parameters¶

The following output parameters will be supported in the Travelled Route API response

An 8-bit png image.

Performance¶

The Performance is dependent on WAN/LAN/WLAN speed & also on the URL you are going to provide in the markers_icon

Transaction Information¶

One Request (which returns one image) using the API link will be considered as one transaction.

Use Cases¶

To show a quick location point without having to additionally add a Map Control.
To show multiple locations on map without the need to add a Map Control.