Map Tile API Developer's Guide

Frequently asked questions

Frequently Asked Questions about the Map Tile API.

How do I request the right info?

You always need to query the info resource of the same Base URL you are using.

Example: If you are using map tiles from the Base Map Tile Resources pool, you should query the info page of that same URL. In other words, if you are creating requests as follows:
https://1.base.maps.cit.api.here.com
  /maptile/2.1/maptile/newest/normal.day/13/4400/2686/256/png8
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
You need to query the info page as follows:
https://1.base.maps.cit.api.here.com
  /maptile/2.1/info
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

Please check Requesting the Right Map Version for more details.

If you use different map tile resources, you need to query all URLs separately as they contain different information.

How do I request the right copyright information?

You always need to query the copyright resource of the same Base URL you are using.

Example: If you are using map tiles from the Base Map Tile Resources pool, you should query the copyright page of that same URL. In other words, if you are creating requests as follows:
https://1.base.maps.cit.api.here.com/maptile/2.1/maptile/newest/normal.day/13/4400/2686/256/png8
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
You need to query the copyright page as follows:
https://1.base.maps.cit.api.here.com/maptile/2.1/copyright/newest
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

If you use different map tile resources, you need to query all URLs separately as they may contain different copyright information.

How do I calculate the distance to the ground depending on the zoom level?

When using a Mercator Projection on a tile based system, it is better to talk about how many meters a pixel represents rather than to calculate the scale of the map at a certain zoom level.

Please remember that due to the limitations of Mercator Projection the ordinate y becomes infinite at the poles and the map must be truncated at some latitude less than ninety degrees. This needs to be done symmetrically. Our map is truncated at 80ºN and 66ºS with the result that European countries are moved towards the center of the map.

For example, at zoom level 0 where the whole world consists of a single tile 256 pixels wide, we can calculate meters by pixel (m/px) using an Earth radius of 6372.7982km as 156,412. That would yield an approximated scale of 1:500 Mill. (taking the scale as an approximate size comparison referring to distances on the equator), as the map scale will depend on the monitor we have used a monitor with a 0.3 mm / pixel.

Here is a table with approximated values for the zoom level correspondence to scale.
zoom level scale (m/pixel)
0 156,412
1 78,271.52
2 39,135.76
3 19,567.88
4 9,783.94
5 4,891.97
6 2,445.98
7 1,222.99
8 305.75
9 305.75
10 152.87
11 76.44
12 38.22
13 19.11
14 9.55
15 4.78
16 2.39
17 1.19
18 0.60
19 0.30
20 0.15

Nevertheless, you can use a formula to calculate the meters per pixel for 256 pixel tiles. The distance represented by one pixel (S) is given by:


S=C*cos(y)/2^(z+8)

where:

C is the equatorial circumference of the Earth

z is the zoom level

y is the latitude of where you are interested in the scale in degrees

Since the Earth is actually ellipsoidal, there will be a slight error in this calculation (0.3% maximum)

How do I know if a particular resource is available?

You can always use the info page resource to query if a particular tile type or scheme is available in the map tile resource URL you choose.

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.