Places quickstart

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

Basic setup

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

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

Quick examples

Search for places

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

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

Geocode an address

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

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

Reverse geocode coordinates

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

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