Coordinates

Working with Coordinates

getPosition

Extracts lng-lat coordinates from various input formats into a standard GeoJSON Position array [longitude, latitude].

Supported input formats:

• Raw coordinate arrays: [lng, lat]
• GeoJSON Point geometries
• GeoJSON Point Features (including Places)

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

3
// From coordinate array
4
const pos1 = getPosition([4.9, 52.3]);
5
// Returns: [4.9, 52.3]
6

7
// From Point geometry
8
const pos2 = getPosition({
9
  type: 'Point',
10
  coordinates: [4.9, 52.3]
11
});
12
// Returns: [4.9, 52.3]
13

14
// From a Place Feature
15
const place = await geocode({ key: 'your-api-key', query: 'Amsterdam' });
16
const pos3 = getPosition(place);
17
// Returns: [longitude, latitude]
18

19
// From a Place with entry point preference
20
const pos4 = getPosition(place, { useEntryPoint: 'main-when-available' });
21
// Returns entry point coordinates if available, otherwise geometry coordinates

Entry point options:

When working with Places that have entry points (building entrances), you can specify which position to extract:

• useEntryPoint: 'main-when-available' – Use the main entry point coordinates if available, otherwise fall back to the geometry coordinates

Returns: Position | null – The coordinates as [longitude, latitude], or null if input is invalid.