Map Versions
- request the latest maps using the
newestvariable - request different map versions for specific regions of the world using a
hashvalue
To retrieve all available map versions, make a request using the info resource. The response lists the map versions as map elements, grouped by the region attribute. The response identifies the most recent map version in each region with the id attribute set to newest. The following excerpt shows an example of a map version list:
<maps>
<map region="all" id="newest" />
<map region="all" newest="true" id="8.30.53.109" hash="be9b70fa2c" />
</maps>To use the latest version of a map, use the following GET request:
https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/11/1202/843/256/png8
?apiKey={YOUR_API_KEY} To retrieve a specific map version, use the value in the hash attribute from the response to the request to the info resource, such as be9b70fa2c in the example above. In this case, the GET request would be as follows:
https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/be9b70fa2c/normal.day/11/1202/843/256/png8
?apiKey{YOUR_API_KEY} The hash value identifying a particular map version may change as a result of software updates, even if the map IDs remain the same. To get a valid response for a request, always make an info request first, and substitute a current map hash value in your subsequent request to the Map Tile (maptile) resource.
A request to the Traffic base URL should always use newest for the map version, because traffic information is provided only for the latest map. For example:
https://2.traffic.maps.ls.hereapi.com/maptile/2.1/traffictile/newest/normal.traffic.day/11/1202/843/256/png8
?apiKey={YOUR_API_KEY}Maintaining Map Consistency
Using the newest property does not guarantee consistency. If there is an update in the map versions between a set of requests to the HERE Map Tile v2, you may receive responses with different map versions. This may cause an inconsistent map experience.
To guarantee a fully consistent map, use the same hash value in all tile requests. To ensure that the hash value is always up to date, make your requests to the info resource every two hours, at least, and verifying if the hash value has changed since the last request.
Each map version, represented by the hash value, is supported for a minimum of 24 hours to ensure a consistent map experience. If the map or software is incorrect, its life span may be less than 24 hours to reduce the chances of a bad user experience.
