Map Image API Developer's Guide

Bounding Box

User Story

The user wants to obtain a map view centered on a bounding box.

Request

This example shows the result of centering the map on a bounding box that covers most of Europe, Asia and Africa. The parameter bbox defines the bounding box as a comma-separated sequence of geocoordinates. The sequence follows the pattern lat1, lon1, lat2, lon2, lat3, lon3, ...
https://image.maps.cit.api.here.com/mia/1.6/mapview
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&bbox=13.235732,14.761452,70.239879,78.123132

Response

The response to the request delivers the following map image:

Figure 1. Request centered using bounding box

The response returns the following additional headers, which define the exact view-port (as bounding box) of the image returned and the actual zoom value used:

Viewport-Top-Right: Lat: 73.39648432607181, Lon: 86.44599303135891
Viewport-Bottom-Left: Lat: 3.2386920439421534, Lon: 6.37630662020905
Viewport-Zoom: 3.75