Glossaire de voyages, cartes et alertes de proximité

Comment utiliser ce glossaire

• Chaque terme a sa propre adresse, pour y renvoyer ou le citer.
• Quand un terme a un chiffre dans Kokai (un rayon, une durée, une limite), le chiffre est celui du code de l’app à la date de révision.
• Les guides avec des exemples complets sont Préparer un voyage et Documents pour voyager.

Termes

Portée (d’une envie)

Sur quoi porte une question à l’IA. Dans Kokai, une envie a l’une des trois portées : « Une zone de la carte » (un centre et un rayon de 100 m à 500 km), « Un de mes lieux » ou « Un thème, sans lieu précis ». Changer de type de portée la remplace entièrement. Exemple dans Préparer un voyage.

Brouillon d’IA

Ce qu’une IA a proposé et que personne n’a encore accepté. Dans Kokai, rien de ce que l’IA propose n’entre dans le voyage tant que tu ne l’acceptes pas : les lieux proposés attendent dans leur envie et le programme avec IA reste « Proposition de l’IA · non enregistrée », gardé seulement sur cet appareil, jusqu’à ce que tu appuies sur « Enregistrer dans le programme » ou que tu l’écartes. Plus dans Préparer un voyage.

Recherche web (de l’IA)

La capacité d’un modèle de langage à consulter internet pendant qu’il répond, pour donner des horaires, des fermetures ou des prix à jour au lieu de ceux qu’il a appris. Dans Kokai, ça s’active dans les Réglages avec « Chercher sur le web en conversant » et ça sert dans la conversation d’une envie : avec Anthropic, jusqu’à 5 recherches par réponse (pas avec Haiku) ; avec OpenAI, avec son outil de recherche. Ce qu’elle trouve est payé par ta clé.

Portefeuille

Dans Kokai, les documents qui ne sont pas d’un voyage mais à toi et valent pour tous : passeport, carte d’identité, assurance annuelle, permis de conduire, vaccins. Ils sont gardés une fois, se voient depuis chaque voyage et préviennent 30 jours avant d’expirer ; un passeport, en plus, 60 jours avant un voyage s’il expire moins de 180 jours après le retour. Plus dans Documents pour voyager.

Clé d’API

Un mot de passe long que donne un fournisseur d’IA (Anthropic, OpenAI) pour utiliser ses modèles depuis une autre application et te facturer ce que tu dépenses. Kokai n’inclut pas d’IA à elle : elle utilise la tienne. La clé est gardée sur ton appareil (sur le téléphone, dans le trousseau du système), part directement vers le fournisseur et ne passe jamais par le serveur de Kokai. Il faut l’écrire sur chaque appareil. Plus dans IA.

Code IATA (d’aéroport)

Les trois lettres par lesquelles l’Association du transport aérien international identifie un aéroport : MAD, c’est Madrid-Barajas, LIS, c’est Lisbonne. C’est ce que comprennent tous les moteurs de recherche de vols, dans n’importe quelle langue. Kokai embarque 3 244 aéroports avec vols réguliers et code IATA, et c’est le code qu’elle met dans chaque lien de Vols.

Copie dans le compte

Dans Kokai, la copie de tes voyages sur le serveur pour les avoir sur tous tes appareils : voyages, lieux, programme, logements, envies, valise et les données des documents. Elle est activée par défaut, envoie environ 2 secondes après chaque changement et cherche des nouveautés toutes les minutes. Elle n’inclut jamais les fichiers des documents, le parcours ni les passeports, cartes d’identité et documents de santé. La couper dans Réglages → « Compte » l’efface du serveur. Plus dans Tes données.

Temporisation

Durée minimale entre deux alertes du même lieu, pour que passer deux fois devant ne te dérange pas deux fois. Dans Kokai, elle est de 45 minutes par lieu, et elle est enregistrée : elle survit à la fermeture de l’app. Exemple dans En route.

Séjour

Quelques nuits de suite dans un même logement. Dans Kokai, c’est un enregistrement distinct du lieu de l’hôtel : il a une arrivée et un départ (dates de la destination), des heures, un état (réservé ou option), un prix, jusqu’à quand on annule sans frais et le document de la réservation. Ainsi un même hôtel peut se répéter dans un voyage, et plusieurs options peuvent se disputer les mêmes nuits. Plus dans Logement.

Géocodeur

Un service qui convertit un texte (« Tour de Belém », « Rua Augusta 100, Lisbonne ») en coordonnées, et parfois l’inverse. Kokai en utilise deux, tous deux avec des données d’OpenStreetMap : Photon pour chercher des lieux pendant que tu écris et Nominatim pour placer la destination d’un voyage et l’adresse d’un logement qui arrive dans un PDF.

Géorepérage

Un cercle (ou une autre forme) sur la carte qui déclenche quelque chose à l’entrée ou à la sortie : une alerte, un enregistrement. Les systèmes iOS et Android ont les leurs, avec des limites (iOS en surveille 20 au maximum par app). Kokai ne les utilise pas : avec le voyage en cours, elle vérifie elle-même chaque position contre tous les lieux qui ont une alerte, sans limite de nombre. Plus dans En route.

Haversine (formule de)

Formule qui calcule la distance la plus courte entre deux points d’une sphère à partir de leur latitude et de leur longitude. Kokai l’utilise avec une Terre de 6 371 km de rayon pour les alertes, le parcours et les trajets du programme : pour des distances de quelques mètres à quelques kilomètres, son erreur reste très en dessous de celle du GPS. Plus dans En route.

Hystérésis

Utiliser un seuil pour entrer et un autre, plus grand, pour sortir, afin qu’une valeur qui oscille à la limite ne change pas d’état sans arrêt. Dans Kokai, tu entres dans un lieu dès que tu es dans son rayon et on ne te considère sorti qu’une fois éloigné de plus de 1,3 fois le rayon, erreur du GPS déduite. Avec 150 m de rayon, on sort à partir de 195 m. Plus dans En route.

Trou (de logement)

Une nuit du voyage sans rien : ni réservation, ni nuit en transit, ni options. Dans Kokai, elle est marquée « Sans logement », et l’alerte « Il manque un logement pour… » propose « Ajouter un logement », « Ajouter une option » ou « C’est une nuit en transit » ; « Chercher sur d’autres sites » ouvre les sites de réservation avec ces dates. Plus dans Chercher un logement.

Envie

Dans Kokai, une question enregistrée sur une zone, un lieu ou un thème, avec sa conversation avec l’IA et les lieux qu’elle propose. Par zone, l’IA propose 6 lieux si le rayon va jusqu’à 2 km, 8 jusqu’à 20 km et 10 au-delà, et ceux qui sont acceptés entrent sur la carte avec une position approximative. Les raccourcis de taille sont « Un quartier » (1 km), « Une ville » (8 km), « Un canton » (40 km) et « Une région » (150 km). Elle sert aussi d’objectif : on la marque comme accomplie et on l’évalue (« Très satisfait », « Satisfait », « Peu satisfait » ou « Pas du tout satisfait »). Plus dans IA.

llms.txt

Une proposition pour que les sites publient, à /llms.txt, un index en Markdown pensé pour être lu par des modèles de langage. Ce site le publie, avec /llms-full.txt (tout le texte) et chaque page en Markdown en ajoutant .md à son nom, comme /glosario.md.

Référence de réservation (PNR)

Le code court de lettres et de chiffres qui identifie une réservation. Pour les vols, on l’appelle aussi PNR (Passenger Name Record) ou record locator ; pour les hôtels et les trains, numéro de réservation ou de confirmation. C’est ce qu’on te demande à un comptoir. Kokai le reconnaît dans les PDF grâce à des étiquettes en sept langues, l’affiche en police à chasse fixe pour ne pas confondre le O et le 0, et ne l’envoie jamais à l’IA. Plus dans PDF de réservations.

Médiane

La valeur qui se trouve au milieu d’une liste ordonnée : la moitié des valeurs est en dessous et la moitié au-dessus. Contrairement à la moyenne, une valeur extrême ne l’entraîne pas. Kokai compare la proximité de chaque option de logement avec la médiane de ses distances à ce qui est prévu ces nuits-là (ou à tes incontournables), pour qu’une excursion à 23 km ne fasse pas paraître loin un hôtel du centre. Exemple dans Préparer un voyage.

Mode En route

Dans Kokai, l’état d’un voyage entre « Démarrer le voyage » et « Arrêter le voyage » : elle suit ta position, te prévient quand tu passes près des lieux qui ont une alerte et enregistre le parcours. Il ne peut y avoir qu’un seul voyage en cours. Dans le navigateur, ça marche avec l’onglet au premier plan ; sur Android, ça utilisera un service de premier plan (avec sa notification fixe, le signe que la position est en cours d’utilisation) pour continuer écran éteint quand l’app arrivera sur les boutiques. Plus dans En route.

Nuit

L’unité du logement. Une nuit porte le nom de la date du soir : un voyage du 3 au 8 octobre a cinq nuits, du 3 au 7. Dans Kokai, chaque nuit est réservée, en transit, avec des options à décider, sans rien ou avec deux réservations, et un voyage accepte jusqu’à 120 nuits. Plus dans Logement.

Nominatim

Le géocodeur de la Fondation OpenStreetMap. Sa politique d’usage demande au maximum une requête par seconde et ne convient pas à la recherche au fil de la frappe. Kokai l’utilise pour placer la destination d’un voyage (« Lisboa y Sintra », partie par partie) et l’adresse d’un logement qui arrive dans un PDF et n’est pas sur ta carte, en laissant 1,1 seconde entre les requêtes.

ODbL

Open Database License, la licence des données d’OpenStreetMap. Elle permet de les utiliser, y compris dans des produits commerciaux, à deux conditions principales : citer la source (« contributeurs d’OpenStreetMap », avec le symbole de copyright devant) et partager sous la même licence les bases de données qui en dérivent. C’est pour ça que la carte de Kokai affiche toujours l’attribution d’OpenStreetMap et d’OpenMapTiles.

Option (candidate)

Dans Kokai, un logement gardé pour quelques nuits sans l’avoir encore réservé : « Une option, pas encore réservée ». Plusieurs options peuvent couvrir les mêmes nuits et se comparent par prix par nuit et par la médiane des distances. « Choisir celle-ci » la fait passer en réservée, et lire le PDF de la réservation de ce même hôtel aussi. Plus dans Préparer un voyage.

OpenStreetMap

Une carte du monde faite par des bénévoles et publiée en données ouvertes sous licence ODbL : rues, bâtiments, commerces, chemins. C’est la base de la carte, du moteur de recherche et d’une partie des photos de Kokai, qui n’utilise pas Google Maps. Plus dans Carte.

Photon

Un géocodeur libre de komoot, avec des données d’OpenStreetMap, pensé pour chercher au fil de la frappe. Kokai lui envoie ce que tu écris dans le champ de recherche de la carte et le centre de la carte, pour classer d’abord ce qui est près. Aujourd’hui, elle utilise son serveur public.

PMTiles

Un format qui garde toutes les tuiles d’une carte dans un seul fichier. Qui le lit ne demande que les morceaux dont il a besoin, avec des requêtes HTTP par plage, donc un serveur web normal suffit, sans serveur de cartes. Kokai l’a prêt pour servir sa propre carte (et, à l’avenir, des cartes hors connexion par zones) ; aujourd’hui la carte de fond vient d’OpenFreeMap.

Précision du GPS

La marge d’erreur, en mètres, que le système donne avec chaque position : il ne dit pas où tu es, mais un cercle dans lequel tu es probablement. Entre des immeubles hauts, elle peut dépasser 50 m. Kokai ne prévient que si la précision est égale ou meilleure que 50 m ou que 1,5 fois le rayon du lieu (le plus grand des deux), et n’enregistre pas dans le parcours les points dont l’erreur dépasse 80 m. Plus dans En route.

Rayon d’alerte

La distance à un lieu à partir de laquelle Kokai te prévient. Par défaut, elle dépend de la catégorie : 100 m pour manger, loisirs et pratique ; 150 m pour logement et visite ; 300 m pour nature ; 400 m pour transport. Elle se change dans la fiche du lieu de 75 à 1 000 m, par pas de 25. Plus dans En route.

Parcours

La ligne de ce que tu as marché ou parcouru, enregistrée avec le GPS. Dans Kokai, elle n’est enregistrée qu’avec le voyage en cours : elle demande une position quand tu te déplaces d’environ 15 m, écarte les points dont l’erreur dépasse 80 m ou qui sont à moins de 12 m du précédent, et garde de chaque point la longitude, la latitude, l’heure et l’erreur. Elle reste sur l’appareil : elle ne va ni dans la copie de ton compte, ni à l’IA, ni dans le fichier exporté. Plus dans En route.

Hors connexion

Ce qu’une app fait sans données ni wifi. Dans Kokai, marchent hors connexion les voyages, le programme, les documents avec leurs fichiers, la valise, la lecture des PDF, les rappels, les alertes d’En route et le parcours, parce que tout ça vit sur l’appareil. Ont besoin du réseau la carte de fond, la recherche de lieux, les photos, l’IA et la copie dans le compte, qui se met à jour au retour du réseau. Plus dans En route.

Chevauchement (de réservations)

Deux réservations de logement pour la même nuit. Parfois c’est exprès (deux chambres) et souvent c’est une erreur qui coûte une nuit payée. Kokai marque cette nuit « Deux réservations » et prévient : « Tu as deux réservations pour… Si ce n’est pas exprès, annules-en une. » Plus dans Logement.

Tuiles

Les morceaux carrés dans lesquels une carte numérique est découpée pour ne charger que la zone et le zoom qu’on voit. Elles peuvent être des images ou vectorielles (des données que l’appareil dessine). Kokai utilise des tuiles vectorielles au schéma d’OpenMapTiles et les peint avec ses propres couleurs, ainsi la carte change avec le thème clair, sombre ou extérieur. Le service de cartes voit quelle zone tu demandes, pas qui tu es.

Transit (nuit en)

Une nuit passée à voyager : dans un train de nuit, un avion ou un bateau. Dans Kokai, elle s’ajoute avec « C’est une nuit en transit » et compte comme nuit couverte, pour ne pas apparaître comme un trou. Plus dans Logement.

Position approximative

Dans Kokai, la marque d’un lieu dont les coordonnées viennent de l’IA et que personne n’a vérifiées : un modèle de langage peut placer un lieu loin de là où il est vraiment. La fiche le dit (« La position a été donnée par l’IA et peut être décalée ») jusqu’à ce que tu fasses glisser le marqueur à l’endroit exact ou que tu appuies sur « C’est bon ».

Wikidata

La base de données libre de la Fondation Wikimedia : chaque chose du monde a un identifiant (un Q et un numéro) avec des données structurées et des liens. Kokai l’utilise pour trouver la photo principale d’un lieu, son site officiel, sa catégorie sur Wikimedia Commons et ses articles sur Wikipédia et Wikivoyage, et affiche chaque photo avec son auteur et sa licence. Plus dans Carte.

Fuseau horaire de la destination

Le fuseau horaire du lieu où tu voyages, avec son nom de la base de données de l’IANA (Europe/Lisbon, Asia/Tokyo). Dans Kokai, chaque voyage a le sien : les heures du programme et des réservations se lisent à l’heure de là-bas et « aujourd’hui », c’est le jour qu’il est là-bas. Les dates du voyage sont gardées comme dates locales (2026-10-03), pas comme des instants, pour qu’un changement d’heure ne décale aucune journée. Exemple dans Préparer un voyage.

Sources et références

La documentation d’origine de ce qui est cité ici, consultée à la date de révision de cette page.

1. Copyright and License OpenStreetMap Foundation
2. Open Data Commons Open Database License (ODbL) Open Knowledge Foundation
3. Nominatim Usage Policy OpenStreetMap Foundation
4. Photon komoot
5. PMTiles Protomaps
6. Wikidata: Introduction Fondation Wikimedia
7. Time Zone Database IANA
8. The /llms.txt file llmstxt.org
9. Geolocation API MDN Web Docs

À lire ensuite

• Planificar un viajeUn viaje de cinco noches a Lisboa y Sintra preparado de principio a fin: sitios, alojamiento, plan con tiempos, documentos, maleta, avisos y el modo En ruta.
• Documents pour voyagerListe des documents pour voyager : identité, validité du passeport, visas et ETIAS, assurance et CEAM, billets, voiture et santé, avec leurs sources officielles.
• Ruta y En rutaLa sección Ruta de Kokai: el camino que sale de tu plan con sus kilómetros y su desnivel, y el modo En ruta, que te avisa al acercarte a un sitio guardado.
• LogementComment Kokai organise le logement par nuits : réservations, options à décider, trous et doubles réservations, alertes d’annulation et l’adresse de l’hôtel sans réseau.
• GuidesGuides pratiques : préparer un voyage pas à pas, quels documents emporter hors connexion, lire des réservations en PDF et chercher un logement avec les dates.