This document introduces the Map Image API and:
- explains key concepts
- provides examples
- documents resources and query parameters
- documents response structures and data types
For the terms and conditions covering this documentation, see the HERE Documentation License.
What Is the Map Image API?
The HERE Map Image API is a REST API that allows you to request static map images for all regions in the world. The map images show conventional map views, but can also include points of interest, routes (for example, with turning points and junction views), statistics and heat maps.
In addition, the API offers a variety of supplementary services for displaying location-based data. For example, it is possible to present roadsigns.
Why Use the Map Image API?
The table below lists the high level use cases for the Map Image API.
|Basic map||Show a map image for a position based on latitude and longitude.|
|Points of interest||Show a map image and one or more points of interest for corresponding geocoordinates.|
|Regions||Show a map image containing colored circles and polygons.|
|Routes||Show a map image containing a route provided as a list of waypoints.|
|Routing||Show a map image containing a route by means of calculating it, which means only the starting and ending points are required.|
|Turn points||Show a map image with a graphical representation of a turning point.|
|Statistical graphs||Show a map image containing circle diagrams and bar charts.|
|Heat maps||Show a map image containing graphical representations of data, where values are represented as colors.|
|Tilt maps||Show a map image for a position based on latitude and longitude with tilting capabilities.|
|Road signs||Show a road sign.|
|Company logo||Show a branded public transport company logo.|