Retrieve an icon in the requested format

get

https://image.maps.hereapi.com/mia/v3/icons/{iconType}/{format}

Retrieve customizable icons based on style, country, state, and road class

Path Params

iconType

string

required

Specifies the icon type. The /info endpoint response lists the available values. For more information, see Choose the map resource type.

format

string

required

The format of the returned image. The /info endpoint response lists the available values. For more information, see Optimize image dimensions and file type.

Query Params

label

string

required

length between 1 and 13

Specifies the label for road shields. (string, UTF-8)

countryCode

string

required

Specifies the country in ISO 3166-1 Alpha-3.

style

string

If present, selects the style to use to render the image. The /info endpoint response lists the available values. For more information, see Define the map styles.
When you do not provide this parameter in a query, the default style is "explore.day".

stateCode

string

Specifies the state code in ISO 3166-2.

width

integer

Specifies the image width (if only width is given then the height is determined based on aspect ratio).

height

integer

Specifies the image height (if only height is given then the width is determined based on aspect ratio).

routeLevel

integer

1 to 6

Defaults to 1

Specifies the route by its priority. The values are from 1 to 6:
1 - international or european road
2 - national
3 - primary road
4 - secondary
5 - minor road
6 - avenue

Headers

If-None-Match

string

Specifies an optional entity tag of the resource cached in the client.
See the 304 response of the getTile operation for more details.

X-Request-ID

string

The ID given by the caller to match in the response.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200OK - Requested resource is returned

304The resource cached in the client (identified by the If-None-Match header) has not changed.

400API response that indicates an error due to a bad request.

401API response that indicates that the access token is missing or invalid.

403API response that indicates that the access token does not authorize access.

404API response that indicates that the requested resource was not found.

500API response that indicates a server malfunction or an unexpected error.

defaultAPI response in case of an error.