Places by category in words

Name a kind of place in one of five languages and find it inside the Paris outline

import { bboxFromGeoJSON, TomTomConfig } from '@tomtom-org/maps-sdk/core';
import { GeometriesModule, PlacesModule, TomTomMap } from '@tomtom-org/maps-sdk/map';
import { createLatestRequest, discoverPlaces, geocodeOne, geometryData } from '@tomtom-org/maps-sdk/services';
import './style.css';
import type { CategorySearch } from './categoryWords';
import { API_KEY } from './config';
import { initPanel, readSearch, showStatus } from './panel';

// (Set your own API key when working in your own environment)
TomTomConfig.instance.put({ apiKey: API_KEY });

(async () => {
    const areaToSearch = await geocodeOne('paris');

    const map = new TomTomMap({
        mapLibre: {
            container: 'sdk-map',
            fitBoundsOptions: { padding: 50 },
            bounds: bboxFromGeoJSON(areaToSearch),
        },
    });

    const areaGeometry = await geometryData({ geometries: [areaToSearch] });
    const geometryModule = await GeometriesModule.create(map, { fill: { style: 'inverted' } });
    geometryModule.show(areaGeometry);

    const placesModule = await PlacesModule.create(map);
    const latestSearch = createLatestRequest();

    const searchCategory = async ({ poiCategoryQuery, language }: CategorySearch) => {
        showStatus('Searching…');
        try {
            const search = await latestSearch.run((signal) =>
                discoverPlaces({
                    filters: { poiCategoryQuery },
                    language,
                    geometries: [areaGeometry],
                    limit: 100,
                    signal,
                }),
            );
            if (!search.current) return;

            placesModule.show(search.value);
            showStatus(`${search.value.features.length} places in Paris`);
        } catch (error) {
            placesModule.clear();
            showStatus(error instanceof Error ? error.message : String(error));
        }
    };

    initPanel(searchCategory);
    await searchCategory(readSearch());
})();

Open Sandbox

A word in the chosen language becomes pins for that kind of place inside Paris, and a word no category matches clears them and says why.

filters.poiCategoryQuery on discoverPlaces resolves the word in the call’s language to POI category codes, so no category lookup comes before the search.
The same call takes the polygon geometryData returns under geometries, and GeometriesModule with fill: { style: 'inverted' } shades everything outside it.
createLatestRequest retires the previous search, so a quick language switch never paints the older word.