Coordinates

VERSION 1.0.0-rc.3 PUBLIC PREVIEW

The SDK takes a location in several shapes (HasLngLat): a [longitude, latitude] array, a GeoJSON Point or a Point feature such as a place. getPosition turns any of them into a plain [longitude, latitude].

getPosition

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

4
getPosition([4.9, 52.3]);                             // [4.9, 52.3]
5
getPosition({ type: 'Point', coordinates: [4.9, 52.3] }); // [4.9, 52.3]
6

7
const place = await geocodeOne('Amsterdam Centraal');
8
getPosition(place);                                   // the place's geometry coordinates
9

10
// The main entrance, when the place has one; its geometry otherwise
11
getPosition(place, { useEntryPoint: 'main-when-available' });

useEntryPoint - 'ignore' (the default) returns the feature’s geometry. 'main-when-available' returns the position of the place’s main entry point if it has one.
Returns Position | null: null for an input that holds no position.