Geopolitical Views

The HERE Vector Tile API provides the pviews endpoint that you can use to retrieve the available geopolitical views of the map. To request the list of geopolitical views available for a map, use the pviews endpoint.

When you make a pviews request, the response is similar to the example below.

{
    "base": [
      "cn",
      "ar"
    ]
}

You can store the list of geopolitical views in your client application. You must refresh this value every 24 hours.

Please, check the Boundaries description of the layers to get detailed information about it.

You can use these views 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 renderer specifies a particular value of kind:xx where xx is one of the available geopolitical views, and the view has data available, the boundaries of the selected country view will be shown; otherwise the default boundaries view are 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 geopolitical view of country A, the response shows the area as belonging to A. Similarly, if you request the tile with the geopolitical 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 data for that tile contains the following for boundaries:

"properties": {
    "$layer": "boundaries",
    "$zoom": 5,
    "$id": 0,
    "kind": "country",
    "kind_detail": 2,
    "sort_rank": 262,
    "min_zoom": 1,
    "kind:ar": "unrecognized_country"
}
(...)
"properties": {
        "$layer": "boundaries",
        "$zoom": 5,
        "$id": 0,
        "kind": "disputed",
        "kind_detail": 2,
        "sort_rank": 261,
        "min_zoom": 1,
        "kind:ar": "unrecognized_disputed"
    }

Which means, that these boundaries are disputed by the geopolitical view kind:ar for Argentina. By default, if the renderer does not take this into account, it shows the default view (international view) with a dashed border showing the South Patagonian Ice Field between Chile and Argentina.

If you would use the Argentinian view, kind:ar, of the same tile, it would show a solid border representing Argentina's view on the ice field.