The HERE Map Image API is a web service API that offers easy and fast access to static map images for all regions of the world. You can also display points of interest and enhance maps with routes, turning points and junction views, or additional information such as statistics or heat maps.
\nIn addition, the API offers a variety of supplementary services for displaying location based data. For example, it is possible to present roadsigns.
\nThis example set works with version 1.6.36.1 or higher
\nAdditional information can be found on developer.here.com
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"3967924","collectionId":"427dab45-f5f9-57ac-a668-30269b1ad101","publishedId":"RW1Yq1Gb","public":true,"customColor":null,"publishDate":"2018-04-25T12:19:08.000Z"},"item":[{"name":"Changing from the Metric System","id":"7bc5ba42-d05a-169a-c0b7-8c1de7c50e65","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"c","type":"text","value":"42.3572,-71.0596"},{"key":"z","type":"text","value":"12"},{"key":"sb","type":"text","value":"m"},{"key":"nodot","type":"text","value":"true"},{"key":"app_id","type":"text","value":"{{YOUR_APP_ID}}"},{"key":"app_code","type":"text","value":"{{YOUR_APP_CODE}}"}]},"url":"https://image.maps.cit.api.here.com/mia/1.6/mapview?c=42.3572,-71.0596&z=12&sb=m&nodot=true&app_id={{YOUR_APP_ID}}&app_code={{YOUR_APP_CODE}}","description":"*Request an image of a map including a scale bar in miles or yards *
\nThe green dot highlighting the central location has been removed by adding the nodot parameter. A scale bar in miles can be included in the image by adding sb=m to the request URL.
c latlng\n - Central coordinate from the map. e.g. 52.515,13.377
z number\n - Zoom Level of the map
sb enum\n - Adds a scalebar to the map and defines the units to use
Valid values are : k, m, km, mk
nodot text\n - Removes the central location dot from the map image
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
*Request an image of a map including a scale bar *
\nThe green dot highlighting the central location can be removed by adding the nodot parameter to the request URL. A scale bar in kilometers can be included in the image by adding sb=k to the request URL.
c latlng\n - Central coordinate from the map. e.g. 52.515,13.377
z number\n - Zoom Level of the map
sb enum\n - Adds a scalebar to the map and defines the units to use
Valid values are : k, m, km, mk
nodot text\n - Removes the central location dot from the map image
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map including additional texts
\nThe text and themes for individual labels are defined by adding the tx0...txN parameters to the request URL. Consult the Map Image API Reference for further information.
tx0 text\n - First custom text to be displayed over the map
tx1 text\n - Second custom text to be displayed over the map
z number\n - Zoom Level of the map
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map including markers styled with a common theme
\nThe marker size has been altered by adding the poitxs parameter, the text color has been altered by adding the poitxc parameter, and the marker background color has been altered by adding the poifc parameter to the request URL.
poi text\n - Adds a point-of-interest marker to the map at the speciified location
poitxs text\n - Default text size for POI markers.
poitxc text\n - Default text color for POI markers.
poifc text\n - Default fill color for POI markers
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map including a polyline
\nIt supports also different map schemes, image sizes; image formats as \nwell as zooming out from automatically calculated zoom level.
\nr0 text\n - List of coordinates describing the first route
r1 text\n - List of coordinates describing the second route
m0 text\n - First route marker on the map
m1 text\n - Second route marker on the map
lc0 text\n - Color of the first route line displayed on the map
sc0 text\n - Shadow color of the first route line displayed on the map
lw0 number\n - Width of the first route line displayed on the map
lc1 text\n - Color of the second route line displayed on the map
sc1 text\n - Shadow color of the second route line displayed on the map
lw1 number\n - Width of the second route line displayed on the map
w number\n - Image width in pixels, maximum 2048.
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a topographical map
\nThe query parameter t selects the map scheme to use for the map image. Setting t=2 selects the terrain map view. Consult the Map Image API Reference for a full list of available schemes.
c latlng\n - Central coordinate from the map. e.g. 52.515,13.377
t enum\n - Alters the type of map returned
Valid values are : 0 - normal.day, 1 - satellite.day, 2 - terrain.day, 3 - hybrid.day, 4 - normal.day.transit, 5 - normal.day.grey, 6 - normal.day.mobile, 7 - normal.night.mobile, 8 - terrain.day.mobile, 9 - hybrid.day.mobile, 10 - normal.day.transit.mobile, 11 - normal.day.grey.mobile, 12 - carnav.day.grey, 13 - pedestrian.day, 14 - pedestrian.night
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map highlighting points of interest
\nMarkers can be added to the map by adding the pois parameter to the request URL in the form of a comma separated list of latitude-longitude pairs .
poi text\n - Adds a point-of-interest marker to the map at the speciified location
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map at a specified location and zoom level
\nTo specify the latitude and longitude of the center of the map add the c parameter to the request URL. To specify the zoom level, add the z parameter to the request URL. Otherwise a default location and zoom level will be used instead.
c latlng\n - Central coordinate from the map. e.g. 52.515,13.377
z number\n - Zoom Level of the map
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map with a defined height and width
\nWhen requesting a map image you do not need to specify an image size or the supported image formats for the target devices, the service uses the user-agent HTTP header sent by the client to identify the device and ensures that the map image fits optimally to the display of the requesting mobile device.If your request specifies height, width and image format, the service does not resize the map image using w and h parameters to the request url.
c latlng\n - Central coordinate from the map. e.g. 52.515,13.377
z number\n - Zoom Level of the map
w number\n - Image width in pixels, maximum 2048.
h number\n - Image height in pixels, maximum 2048.
f enum\n - Image format 0=PNG 1=JPEG (default) 2=GIF 3=BMP 4=PNG8
Valid values are : 0 - PNG, 1 - JPEG, 2 - GIF, 3 - BMP, 4 - PNG8, 5 - SVG
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map including markers each with a custom style
\nThemes for individual markers are defined by adding the poix0...poixN parameters to the request URL. Consult the Map Image API Reference for further information.
poix0 text\n - Extended POI characteristics for the first marker
poix1 text\n - Extended POI characteristics for the second marker
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map displaying an address
\nAn address information box can be included in the returned image if the i parameter is added to the request URL.
co text\n - Country name for address based search
z number\n - Zoom Level of the map
i number\n - Flag for showing address or position information box inside the map image
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
ci text\n - City name for address based search
s text\n - Street name for address based search
n number\n - House number on the street for address-based search
w number\n - Image width in pixels, maximum 2048.
Request the image of a map showing uncertainty of position
\nThe c parameter is to specify the latitude and longitude of the location. The resulting image shows a map centered on the location marked with a green dot. The u parameter adds an uncertainty circle around the location of the green dot.
c latlng\n - Central coordinate from the map. e.g. 52.515,13.377
z number\n - Zoom Level of the map
u number\n - Adds an uncertainty circle around the specified location
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map including labels in a foreign language
\nThe ml parameter can be added to the request URL to change the map language. Consult the Map Image API Reference for a full list of available languages.
c latlng\n - Central coordinate from the map. e.g. 52.515,13.377
ml enum\n - Alters the language of the labels displayed on the map
Valid values are : ara - Arabic, chi - Chinese, cht - Chinese (Trad), dut - Dutch, eng - English, fre - French, ger - German, gle - Gaelic, gre - Greek, heb - Hebrew, hin - Hindi, ind - Indonesian, ita - Italian, per - Persian, pol - Polish, por - Portuguese, rus - Russian, sin - Sinhalese, spa - Spanish, tha - Thai, tur - Turkish, ukr - Ukranian, urd - Urdu, vie - Vietnamese, wel - Welsh
z number\n - Zoom Level of the map
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map based around a given area
\nTo specify a bounding box, add the bbox parameter to the request URL. On desktop browsers, redirection to here.com will occur automatically unless the nord parameter is also added to URL.
bbox text\n - Bounding box of the map specifying the top-right and bottom left corners. e.g. 52.515,13.377,52.134,13.978
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
Request an image of a map including an embedded overview map
\nA small Picture-in-Picture can be added to the image by including the pip parameter and specifying the zoom level in the request URL.
c latlng\n - Central coordinate from the map. e.g. 52.515,13.377
z number\n - Zoom Level of the map
pip text\n - Adds a picture-in-picture mini-map to the image
app_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.
*Request the default image of a map *
\nThe image in the response displays a map of Berlin.
\napp_id text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_id with every request.
app_code text\n - A 20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an app_code with every request.