Places quickstart

The TomTom Places Services provide comprehensive location-based functionality including search, geocoding, and reverse geocoding capabilities.

Basic setup

1
import { TomTomConfig } from '@tomtom-org/maps-sdk/core';
2
import { search, geocode, reverseGeocode } from '@tomtom-org/maps-sdk/services';
3

4
TomTomConfig.instance.put({
5
    apiKey: 'YOUR_API_KEY'
6
});

Quick examples

Search for places

1
const results = await search({
2
    query: 'coffee shops',
3
    position: [4.9041, 52.3676] // Amsterdam
4
});
5

6
console.log(results.features[0].poi.name);

Geocode an address

1
const result = await geocode({
2
    query: 'Dam Square, Amsterdam'
3
});
4

5
const coordinates = result.features[0].geometry.coordinates; // [lng, lat]

Reverse geocode coordinates

1
const result = await reverseGeocode({
2
    position: [4.9041, 52.3676]
3
});
4

5
console.log(result.features[0].properties.address.freeformAddress);

Next steps

• Search Services - Autocomplete, fuzzy, and geometry search
• Geocoding - Address to coordinates
• Reverse Geocoding - Coordinates to address

Related guides and examples

Related guides

• Places Search - Advanced search capabilities including autocomplete and fuzzy search
• Geocoding - Comprehensive address to coordinates conversion
• Reverse Geocoding - Coordinates to address with detailed options
• Geometry Data - Retrieve boundary data for places
• EV Charging Stations - Real-time charging station availability

Related examples

• Geocode - Basic geocoding implementation
• Reverse Geocode - Basic reverse geocoding
• Autocomplete Fuzzy Search - Search-as-you-type functionality
• Geometry Search Playground - Search within boundaries

Map integration

• Map Places - Display search results on interactive maps
• Map Geometries - Visualize place boundaries from geometry data
• Default map - Foundation for places-powered applications