Geopolitical views

Borders, names and addresses are disputed in many places, and what is correct depends on who is looking. A geopolitical view sets whose perspective the SDK shows in the borders and names the map draws, and in the country a search or reverse geocoding result reports. One setting controls both, so the map and your results never contradict each other.

Pick a territory and a view below. The borders redraw, and the address of the pinned place updates.

Supported views

geopoliticalViews, exported from the Core bundle, lists every view as the GeopoliticalView type:

Examples of what the views change:

• IN, PK, CN - The borders of Kashmir, Aksai Chin and Arunachal Pradesh, and the country of their addresses.
• MA, DZ - Western Sahara, as part of Morocco or as a territory of its own.
• KR - The East Sea and Dokdo.
• US - The Gulf of America.
• AE - The Arabian Gulf.
• VN, PH, MY - The Paracel and Spratly Islands.

Not every TomTom API supports every view:

If an API doesn’t support a view, the SDK leaves the view out of its requests to it, so the call still succeeds in that API’s default view.

Setting the view

Set the view once in the global configuration, and it applies to the map and to every search, place details, geocoding and reverse geocoding call:

1
import { TomTomConfig } from '@tomtom-org/maps-sdk/core';
2

3
TomTomConfig.instance.put({ apiKey: 'YOUR_API_KEY', geopoliticalView: 'IN' });

A map’s constructor or a single call can override it:

1
import { TomTomMap } from '@tomtom-org/maps-sdk/map';
2
import { reverseGeocode } from '@tomtom-org/maps-sdk/services';
3

4
const map = new TomTomMap({ mapLibre: { container: 'map' }, geopoliticalView: 'PK' });
5

6
const address = await reverseGeocode({ position: [74.31, 35.92], geopoliticalView: 'Unified' });

When no view is set

If you don’t set a view, each TomTom API applies the default view for the country the request comes from, as local law there requires. Requests from India always get the IN view, whatever view you set.

Switching the view on a map

setGeopoliticalView changes the view of a map that is already showing:

1
map.setGeopoliticalView('IN');
2

3
// Back to the default view for the viewer's country
4
map.setGeopoliticalView(undefined);

• The visible tiles reload in place. The camera, the style and every module stay as they are.
• The view persists across style changes, like the map language.
• It applies to the TomTom Orbis vector tiles.
• It changes the map only. To use the same view in services, also put it in the global configuration:

1
TomTomConfig.instance.put({ geopoliticalView: 'IN' });
2
map.setGeopoliticalView('IN');

Related guides and examples

• Global configuration
• TomTomMap
• Reverse geocoding
• Geopolitical views playground