Map Tile API Developer's Guide

Geopolitical Views

The Map Tile API provides a pview parameter that you can use to render the map with boundaries based on international or local country views. Typically, the international view is used, unless the map is being used within a particular country for which a local view is available. If the pview parameter is specified and the view is supported, the boundaries of the selected country view are shown; otherwise the default boundaries view is shown.

A typical use case is that a particular area of the world is considered as disputed by two or more countries. Therefore, each country shows that area as part of itself. If you request a particular tile with the political view of country A, the response shows the area as belonging to A. Similarly, if you request the file with the political view of country B, the response shows the area as belonging to B.

For example, a user wants to see a certain location in South Patagonia. The first request shows the default view (international view) with a dashed border showing the South Patagonian Ice Field between Chile and Argentina.
https://2.base.maps.cit.api.here.com
  /maptile/2.1/maptile/newest/normal.day/5/9/21/256/png8
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}

The response renders the following tile:
Figure 1. South Patagonian Ice Field

Requesting the same tile using the Argentinian view on the area shows a solid border representing Argentina's view on the ice field.
https://2.base.maps.cit.api.here.com
  /maptile/2.1/maptile/newest/normal.day/5/9/21/256/png8
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}
  &pview=ARG

The response renders the following tile:
Figure 2. South Patagonian Ice Field