Recherche et itinéraires
Le géocodeur et le panneau d'itinéraire reposent sur vos propres primitives shadcn et appellent l'API de géocodage et l'API d'itinéraires. Chaque appel qu'ils font compte pour une requête, facturée comme les autres. well-search et legal-land-search sont le géocodeur avec d'autres libellés, dans Composants de superposition.
npx shadcn@latest registry add @unmap=https://registry.unmap.dev/r/{name}.json
npx shadcn@latest add @unmap/geocodernpx shadcn-vue@latest add https://registry.unmap.dev/r/vue/geocoder.jsonLa ligne React enregistre le registre une fois par projet, ce qui permet ensuite de nommer les éléments @unmap/<item>; shadcn-vue n'a pas de registry add et prend directement l'URL de l'élément. Les fichiers arrivent dans components/ui/ à côté des vôtres; rien n'est remplacé sans confirmation.
Parcourir tous les éléments sur registry.unmap.dev| Élément | Rôle |
|---|---|
geocoder | Une boîte de recherche avec autocomplétion différée qui déplace la carte vers le lieu choisi. Les coordonnées saisies passent par le géocodage inverse ; bbox, proximity et votre propre mise en page des résultats sont facultatifs. |
routing-panel | Des champs départ/arrivée qui résolvent les deux adresses, demandent un itinéraire, le tracent sur la carte et en listent les indications virage par virage. |
route-steps | Les indications virage par virage d'un itinéraire, en liste. Survoler une indication met son tronçon en évidence; cliquer la cadre sur la carte. |
Options du géocodeur
Le géocodeur fait un géocodage inverse des coordonnées qu'on y saisit et liste les adresses les
plus proches du point. Il lit lat, lng par défaut : 51.05, -114.07 désigne Calgary. Un premier
nombre négatif suivi d'un second positif signifie lng, lat : -114.07, 51.05 désigne donc aussi
Calgary, car partout au Canada la latitude est positive et la longitude négative. La virgule
décimale française fonctionne quand une espace ou un ; sépare les deux nombres, comme dans
51,05 -114,07, alors qu'un 51,05 seul reste une recherche de texte. Le signe moins Unicode
compte comme -. Les degrés, minutes et secondes restent une recherche de texte. Un point hors du
Canada le dit, en français ou en anglais selon lang. Chaque recherche inverse est une requête,
comme une recherche. reverseGeocode={false} cherche plutôt les coordonnées comme du texte.
well-search et legal-land-search partent sans géocodage inverse, car des coordonnées saisies
dans une boîte UWI ou LSD ne demandent pas une adresse ; passez reverseGeocode (Vue :
:reverse-geocode="true") pour le réactiver.
bbox([ouest, sud, est, nord]) garde les résultats dans un rectangle. Le géocodeur filtre dans le navigateur, car l'autocomplétion n'a pas de rectangle côté serveur : il demande plus de suggestions quelimitet écarte celles qui sont dehors, si bien qu'un rectangle peut en afficher moins quelimit. Une coordonnée saisie est recherchée où qu'elle soit, et le rectangle ne la filtre pas.proximityfavorise les résultats près d'un point sans en exclure aucun :[lng, lat], ou"map"pour le centre de la carte au moment de chaque recherche. Elle est transmise à la passerelle sous le nomfocus.renderResult(Vue : l'emplacementresult) dessine chaque option.emptyText(Vue :empty-text) remplace ce qu'affiche la liste quand une recherche ne trouve rien.errorText(Vue :error-text) est une fonction qui reçoit l'erreur et renvoie ce qu'affiche la liste quand une recherche échoue, ligne hors du Canada comprise ; une erreur de la passerelle portestatusetcode.well-searchetlegal-land-searchacceptent les deux. La ligne « Recherche... » suitlang.
"use client";
import { Geocoder } from "@/components/ui/geocoder";
import { Map } from "@/components/ui/map";
export function PlaceSearch() {
const apiKey = process.env.NEXT_PUBLIC_UNMAP_KEY!;
return (
<div className="h-[560px]">
<Map apiKey={apiKey} center={[-114.07, 51.05]} zoom={10}>
<div className="absolute top-3 left-3 z-10 w-72">
<Geocoder
apiKey={apiKey}
bbox={[-115.2, 50.8, -113.8, 51.4]}
proximity="map"
renderResult={(result) => (
<span className="flex flex-col">
<span>{result.name}</span>
<span className="text-xs text-muted-foreground">{result.address?.region}</span>
</span>
)}
/>
</div>
</Map>
</div>
);
}<script setup lang="ts">
import { UnmapMap } from "@/components/ui/map";
import { UnmapGeocoder } from "@/components/ui/geocoder";
const apiKey = import.meta.env.VITE_UNMAP_KEY;
</script>
<template>
<UnmapMap :api-key="apiKey" :center="[-114.07, 51.05]" :zoom="10">
<div class="absolute top-3 left-3 z-10 w-72">
<UnmapGeocoder :api-key="apiKey" :bbox="[-115.2, 50.8, -113.8, 51.4]" proximity="map">
<template #result="{ result }">
<span class="flex flex-col">
<span>{{ result.name }}</span>
<span class="text-xs text-muted-foreground">{{ result.address?.region }}</span>
</span>
</template>
</UnmapGeocoder>
</div>
</UnmapMap>
</template>Contrôle de recherche MapLibre
Pour une carte sans shadcn, ou une application MapLibre simple, @unmap/maps/geocoder place la
même recherche dans @maplibre/maplibre-gl-geocoder,
le contrôle de recherche de MapLibre. Le module affiche le champ, la liste de suggestions, le
déplacement de la carte et le marqueur; unmap répond à ses recherches.
npm i @unmap/maps @maplibre/maplibre-gl-geocoderimport { createMap } from "@unmap/maps";
import { createGeocoder } from "@unmap/maps/geocoder";
import "maplibre-gl/dist/maplibre-gl.css";
import "@maplibre/maplibre-gl-geocoder/dist/maplibre-gl-geocoder.css";
const map = createMap({ key: "um_pk_live_...", container: "#map" });
map.addControl(createGeocoder({ key: "um_pk_live_..." }), "top-left");createGeocoder affiche les résultats pendant la saisie, les classe vers le centre de la carte et
remplit le champ avec la ligne complète du résultat choisi. Toutes les autres options sont celles du
module (placeholder, zoom, marker, types, bbox, filter, render, ...) et lui sont
transmises. Les résultats arrivent comme des entités Carmen de style Mapbox (place_name,
place_type, text, address, center, context), si bien que le code écrit pour le géocodeur
Mapbox les lit sans changement; le résultat unmap complet se trouve dans properties.unmap.
mode: "search" utilise la recherche plein texte au lieu de l'autocomplétion, pour un contrôle qui
ne cherche qu'à la touche Entrée. Pour configurer le module vous-même, passez
unmapGeocoderApi({ key }) comme geocoderApi, avec render: renderResult et
popupRender: renderPopup du même point d'entrée : les fonctions d'affichage du module insèrent le
texte des résultats dans le HTML sans l'échapper, et les noms de lieux sont des données ouvertes
modifiables par tous. Chaque recherche compte pour une requête.
Panneau d'itinéraire
routing-panel résout une adresse de départ et une adresse d'arrivée avec le géocodeur, demande un
itinéraire à l'API d'itinéraires et le trace avec route-line, qui
s'installe avec lui. Une soumission fait deux recherches et un itinéraire, soit trois requêtes.
mode vaut auto (par défaut), car, bicycle, pedestrian ou truck, et onRoute (Vue :
@route) reçoit chaque itinéraire tracé : la ligne, sa distance en mètres, sa durée en secondes et
ses steps. Sous le résultat, il liste ces indications virage par virage avec route-steps, dans
la lang du panneau (en ou fr); showSteps={false} (Vue : :show-steps="false") les retire et
cesse de les demander. Le panneau s'affiche comme un simple formulaire : l'exemple le place donc dans
votre Card.
Profil d'altitude passe cette ligne à elevation-profile.
"use client";
import { Card, CardContent } from "@/components/ui/card";
import { Map } from "@/components/ui/map";
import { RoutingPanel } from "@/components/ui/routing-panel";
export function Directions() {
const apiKey = process.env.NEXT_PUBLIC_UNMAP_KEY!;
return (
<div className="h-[560px]">
<Map apiKey={apiKey} center={[-114.07, 51.05]} zoom={11}>
<Card className="absolute top-3 left-3 z-10 w-80">
<CardContent>
<RoutingPanel
apiKey={apiKey}
mode="bicycle"
onRoute={(route) => console.log(route.distanceMeters, route.durationSeconds)}
/>
</CardContent>
</Card>
</Map>
</div>
);
}<script setup lang="ts">
import type { LngLat } from "@unmap/routing";
import { Card, CardContent } from "@/components/ui/card";
import { UnmapMap } from "@/components/ui/map";
import { UnmapRoutingPanel } from "@/components/ui/routing-panel";
const apiKey = import.meta.env.VITE_UNMAP_KEY!;
function onRoute(route: { coordinates: LngLat[]; distanceMeters: number; durationSeconds: number }) {
console.log(route.distanceMeters, route.durationSeconds);
}
</script>
<template>
<div class="h-[560px]">
<UnmapMap :api-key="apiKey" :center="[-114.07, 51.05]" :zoom="11">
<Card class="absolute top-3 left-3 z-10 w-80">
<CardContent>
<UnmapRoutingPanel :api-key="apiKey" mode="bicycle" @route="onRoute" />
</CardContent>
</Card>
</UnmapMap>
</div>
</template>Indications d'itinéraire
route-steps liste les indications virage par virage
d'un itinéraire : une icône par manœuvre, l'instruction rédigée par l'API et la distance jusqu'à
l'indication suivante. Demandez l'itinéraire avec steps: true, puis passez à la liste ses steps
et les geometry.coordinates de l'itinéraire, dans lesquelles chaque geometryRange pointe.
Survoler une indication ou lui donner le focus trace son tronçon par-dessus l'itinéraire, plus
épais; la cliquer ou appuyer sur Entrée cadre ce tronçon sur la carte, et onSelect (Vue :
@select) reçoit l'indication et son indice. lang règle le libellé de la liste et le format des
distances; les instructions sont dans la langue dans laquelle l'itinéraire a été demandé. Il n'y a
pas de voix. routing-panel l'inclut déjà.
"use client";
import { useEffect, useState } from "react";
import { Router, type RouteResult } from "@unmap/routing";
import { Map } from "@/components/ui/map";
import { RouteLine } from "@/components/ui/route-line";
import { RouteSteps } from "@/components/ui/route-steps";
const apiKey = process.env.NEXT_PUBLIC_UNMAP_KEY!;
export function Directions() {
const [route, setRoute] = useState<RouteResult | null>(null);
useEffect(() => {
new Router({ key: apiKey })
.route([-114.0719, 51.0447], [-113.9871, 51.0899], { steps: true, lang: "fr" })
.then(setRoute);
}, []);
return (
<div className="flex h-[560px]">
<Map apiKey={apiKey} center={[-114.03, 51.07]} zoom={12} className="flex-1">
{route ? (
<>
<RouteLine id="route" coordinates={route.geometry.coordinates} />
<aside className="absolute top-3 left-3 z-10 max-h-[520px] w-80 overflow-y-auto bg-background">
<RouteSteps steps={route.steps ?? []} coordinates={route.geometry.coordinates} lang="fr" />
</aside>
</>
) : null}
</Map>
</div>
);
}<script setup lang="ts">
import { onMounted, shallowRef } from "vue";
import { Router, type RouteResult } from "@unmap/routing";
import { UnmapMap } from "@/components/ui/map";
import { UnmapRouteLine } from "@/components/ui/route-line";
import { UnmapRouteSteps } from "@/components/ui/route-steps";
const apiKey = import.meta.env.VITE_UNMAP_KEY!;
const route = shallowRef<RouteResult | null>(null);
onMounted(async () => {
route.value = await new Router({ key: apiKey }).route([-114.0719, 51.0447], [-113.9871, 51.0899], {
steps: true,
lang: "fr",
});
});
</script>
<template>
<div class="flex h-[560px]">
<UnmapMap :api-key="apiKey" :center="[-114.03, 51.07]" :zoom="12" class="flex-1">
<template v-if="route">
<UnmapRouteLine id="route" :coordinates="route.geometry.coordinates" />
<aside class="absolute top-3 left-3 z-10 max-h-[520px] w-80 overflow-y-auto bg-background">
<UnmapRouteSteps :steps="route.steps ?? []" :coordinates="route.geometry.coordinates" lang="fr" />
</aside>
</template>
</UnmapMap>
</div>
</template>