Rechercher un lieu

Le géocodage direct transforme du texte en coordonnée. search classe par pertinence parmi les adresses et les lieux canadiens, donc « Calgary Tower » trouve la tour et non chaque ligne qui mentionne Calgary.

import { Unmap } from "@unmap/sdk";

const unmap = new Unmap({ key: "um_live_..." });

const results = await unmap.geocoder.search("Calgary Tower", { limit: 3 });

Chaque appel se résout en un tableau, même pour zéro ou une correspondance. Chaque résultat porte id, name, layer, lng, lat, une carte names quand le lieu a des noms dans plus d'une langue, et une address structurée quand elle existe. Les résultats de recherche ajoutent un score.

Pour garder les résultats dans une boîte, passez bbox sous la forme [minLng, minLat, maxLng, maxLat]. C'est un filtre dur, pas un biais : une ligne dont le point tombe hors de la boîte est écartée.

const results = await unmap.geocoder.search("Tower", {
  bbox: [-114.12, 51.02, -114.02, 51.07],
  limit: 5,
});

L'API de géocodage documente chaque paramètre et la forme du résultat. @unmap/geocoding est le même client, sans dépendance à une carte.