Map Image API Developer's Guide

Data Types

Type Description
Latitude A floating point number representing latitude. Supported formats:
  • Prefix: only one of the following or none at all +, -, N, S
  • Value: one or two digits followed by up to ten decimals
Valid range: [-90,+90] Examples:
  • 13
  • 13.003
  • +13.3298
  • -13.3298
  • S13.88798798
  • N90
Longitude A floating point number representing latitude. Supported formats:
  • Prefix: only one of the following or none at all +, -, E, W
  • Value: one or two digits followed by up to ten decimals
Valid range: [-180,+180] Examples:
  • 13
  • 13.003
  • +13.3298
  • -13.3298
  • E13.88798798
  • W180
Geo Coordinate Latitude and Longitude pair.
Geo Coordinate List List of comma separated Geo Coordinates:

lat0,lon0,lat1,lon1,lat2,lon2,...

Color Color code. Following formats are supported:

Hexadecimal notation for the combination of alpha (alpha compositing), red, green and blue. The value is specified as 4 pairs of two-digit hexadecimal numbers (00...FF) as AARRGGBB, where A=alpha, R=red, G=green and B=blue. Example: 880000FF

Hexadecimal notation for the combination of red, green and blue. The value is specified as 3 pairs of two-digit hexadecimal numbers (00...FF) as RRGGBB, where R=red, G=green and B=blue. With alpha it will be interpreted as FFRRGGBB.

Example: 0000FF (interpreted as FF0000FF in AARRGGBB) Shorthand hexadecimal notation for the combination of red, green and blue, where both hexadecimal digits of each color are the same. The value is specified as 3 one-digit hexadecimal numbers (0...F) as RGB, where R=red, G=green and B=blue. With alpha it will be interpreted as FFRRGGBB.

Example: 00F (interpreted as FF0000FF in AARRGGBB)

Color name as string. The following 17 standard colors are supported: aqua, black, blue, fuchsia, gray, grey, green, lime, maroon, navy, olive, purple, red, silver, teal, white, and yellow.

Example: blue (interpreted as FF0000FF in AARRGGBB)

Color List List of Colors where the list items are separated by comma:

AARRGGBB,AARRGGBB,AARRGGBB,...

Flag Flag Parameters in a request do not require a value. If a value is given it is ignored unless it is one of the following:
  • 1
  • true
  • on
  • yes

In these cases the value will be true, with any other value will be false.

Fields Parameter value consists of two or more fields separated by semicolon ';'. See theparameter specific description for more details about supported fields.
Distance Integer representing distance and optional unit postfix. Default unit is meters.
  • d(decimeters, 1d = 0.1 meters)
  • h (hectometers, 1h = 100 meters)
  • k (kilometers, 1k = 1000 meters)
  • m (myriad meters, 1m = 10000 meters)
  • l (lakh meters, 1l = 100000 meters)
  • mi (miles, 1mi = 1609.344 meters)
  • ft (feet, 1ft = 0.3048 meters)

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.