Cómo funciona

El mapa de tu viaje: guardar sitios por categorías, con fotos y enlaces

En Kokai cada viaje tiene un mapa con tus sitios: los buscas por nombre o tocas donde están, y cada uno lleva el color y el icono de su categoría, su prioridad y, sin que lo pidas, fotos y enlaces de Wikipedia, Wikidata y Wikimedia Commons con su autor y su licencia. El mapa base es de OpenStreetMap y va en tonos de papel, para que el único color sea el de tus sitios. Tus sitios se guardan en el dispositivo; el mapa de fondo, el buscador y las fotos necesitan conexión.

Revisado el 17 de septiembre de 2026 17 min de lectura

En pocas palabras

Categorías: Siete: alojamiento, comida, visita, naturaleza, ocio y transporte, cada una con su color y su icono, y práctico, con icono y sin color.
Añadir un sitio: Buscándolo por nombre (a partir de 3 letras, hasta 8 resultados) o con «Añadir tocando el mapa». El marcador se arrastra para corregirlo.
Prioridad: Imprescindible, Si hay tiempo (la de un sitio nuevo) o Quizás.
Fotos: Hasta 8 visibles por sitio, de Wikimedia Commons con autor y licencia, y en el móvil la imagen de portada de su web oficial. La que no es de ahí se descarta y no vuelve.
Datos del mapa: OpenStreetMap. Buscar lugares: Photon. Situar el destino del viaje: Nominatim, una petición por segundo como mucho.
Temas: Como el sistema, Claro, Oscuro y Exterior (más contraste, para leer a pleno sol). El mapa cambia con la app.
Sin conexión: Tus sitios, sus fichas y sus notas, sí. El mapa de fondo, el buscador y las fotos, no: los mapas sin conexión están pendientes.

El mapa es papel; el color es de tus sitios

Abre un viaje y toca Mapa en la barra: el mapa ocupa la pantalla y, al lado en el ordenador o debajo en el móvil, está la lista de tus sitios con su buscador. Tocar un sitio abre su ficha en ese mismo panel.

El mapa de fondo no trae colores propios. Tierra, agua, parques y calles se pintan en tonos de papel de mapa y tinta, y los únicos colores con tono que quedan encima son los tuyos: los marcadores de tus sitios, la línea de la ruta de un día y el recorrido grabado en En ruta. Así, cuando algo tiene color, significa algo.

El color nunca va solo. Cada marcador lleva el icono de su categoría y, en pantallas de más de 600 px de ancho, su nombre debajo. En un móvil solo se ve el icono, salvo el del sitio que tienes abierto: con veinte nombres encima, un mapa de 390 px no se lee.

Los marcadores son botones de verdad: se pueden recorrer con el teclado, miden 44 px para tocarlos con el dedo y el lector de pantalla dice su nombre y su categoría.

Las siete categorías

Cada sitio es de una categoría, y la categoría decide su color, su icono y el radio que se propone para el aviso al pasar cerca. Son fijas: para agrupar de otra manera («para ir con niños», «de noche») están las etiquetas.

Categoría	Icono y tono	Qué suele entrar	Radio del aviso
Alojamiento	Una cama, en azul índigo	Hoteles, albergues, casas de huéspedes, apartamentos, campings	150 m
Comida	Cubiertos, en rojo	Restaurantes, cafeterías, bares, heladerías, panaderías y pastelerías	100 m
Visita	Un edificio con columnas, en marrón	Monumentos, museos, galerías, miradores, templos	150 m
Naturaleza	Una montaña con sol, en verde	Parques, jardines, reservas naturales, playas y parajes	300 m
Ocio	Una entrada, en magenta	Teatros, cines, tiendas, estadios, zoos, acuarios, parques temáticos	100 m
Transporte	Un tren, en azul	Estaciones, aeropuertos, terminales de ferri, alquiler de coches o bicis, aparcamientos	400 m
Práctico	Un salvavidas, sin color	Lo demás: una farmacia, un cajero, un consulado	100 m

Práctico no tiene color a propósito. Lo que no encaja en ninguna otra categoría va ahí, en gris: mejor un gris honrado que un color que diga algo que no es. Tampoco es una categoría el morado de la IA: marca lo que la IA ha propuesto y todavía no has aceptado, con el borde discontinuo.

Seis colores y un gris no es un número al azar. Los tonos se eligieron midiendo todos los pares a la vez, también como los ve una persona con protanopía o deuteranopía, y siete es lo más que se consigue separar así. Un hotel no cambia de tono al pasar a oscuro: solo se aclara para que se lea sobre el fondo de noche.

Añadir sitios: buscar, tocar el mapa y arrastrar

Hay tres maneras de que un sitio llegue al mapa, porque se llega a ellos de tres maneras: sabes cómo se llama, sabes dónde está, o te lo propone la IA.

Buscar por nombre: Escribe en «Buscar un lugar para añadirlo…». Se busca a partir de 3 letras, cuando dejas de escribir, y salen hasta 8 resultados, inclinados hacia la zona que miras en el mapa (o hacia el destino del viaje, si aún no lo has movido): «catedral» en un viaje a Sevilla es la de Sevilla. Al elegir uno, sale «Guardar este lugar» con el nombre y la categoría ya puestos.
Tocar el mapa: Pulsa «Añadir tocando el mapa» y toca donde está el sitio. Sale «Sitio nuevo» con sus coordenadas: le pones nombre, eliges la categoría (propone Visita) y pulsas «Guardar el sitio». Sirve para lo que no tiene nombre en ningún mapa: un banco con vistas, la puerta trasera de un mercado.
Aceptar una propuesta de la IA: Desde un interés o desde el plan con IA. Entra con la ubicación marcada como aproximada (ver más abajo).

Al guardar un sitio buscado, su categoría sale de cómo lo tiene etiquetado OpenStreetMap: lo que allí es un museo entra como Visita; un restaurante o una pastelería, como Comida. Si no te convence, se cambia en la ficha. En los dos formularios puedes marcar ya «Avisarme cuando pase cerca, con el viaje en ruta».

Para corregir dónde está, abre la ficha del sitio: su marcador se puede arrastrar hasta el punto exacto y se guarda al soltarlo. Solo se arrastra el sitio abierto, para que mover el mapa con el dedo no desplace marcadores sin querer.

La ficha de cada sitio

Todo lo de la ficha se guarda solo, medio segundo después de dejar de escribir. No hay botón de guardar: en un móvil, con la otra mano ocupada, un botón de guardar es un dato perdido.

Prioridad: «Imprescindible», «Si hay tiempo» o «Quizás». Un sitio nuevo entra como «Si hay tiempo». Los imprescindibles lo dicen en la lista, y el plan con IA empieza por ellos.
«Marcar visitado» y «Cómo llegar», que abre la ruta hasta ese punto en Google Maps.
Notas, con «Proponer» para que la IA sugiera qué pedir o a qué hora ir.
«Avisarme al pasar cerca», con «A qué distancia» (de 75 a 1.000 m): lo cuenta En ruta.
«En el plan» y «Añadir al plan», para ponerlo en un día o en «Sin fecha».
«Dirección, horario, precio y contacto», las etiquetas, los documentos enlazados y, en un alojamiento, «Noches aquí» (Alojamiento).
«Preguntar a la IA por este sitio», que abre un interés sobre sus alrededores.

Borrar un sitio lo quita también de los días del plan donde estaba. Los documentos enlazados no se borran.

Filtros, lista y herramientas del mapa

Con muchos sitios guardados, el mapa se ordena así:

Por categoría: sobre la lista hay una pastilla por cada categoría que tenga algún sitio. Tocar una deja solo esa; tocar otra la suma. Sin ninguna elegida se ve todo.
Por etiqueta: al elegir varias etiquetas, salen los sitios que las tienen todas.
La lista dice cuántos sitios ves («12 de 40») y, de cada uno, si es imprescindible, si está visitado o tiene aviso, y su dirección.
«Dónde estoy» centra el mapa en tu posición y, a partir de ahí, la lista se ordena por distancia y enseña a cuánto está cada sitio.
«Ver todos los sitios» encuadra el mapa para que quepan todos.
Si has grabado recorridos en ruta, «Ver el recorrido» y «Ocultar el recorrido» los enseñan o los esconden.

Los sitios con aviso llevan dibujado alrededor el círculo de su radio, para ver de un vistazo si dos avisos se pisan. La vista del mapa (dónde miras y con cuánto zoom) se recuerda en cada dispositivo: el móvil puede estar mirando el barrio mientras el portátil enseña la ciudad entera.

Desde el plan, el botón «Mapa» de un día abre este mismo mapa con solo los sitios de ese día y la línea que los une en orden.

Fotos y enlaces, sin buscarlos tú

Cada sitio nuevo sale a buscar sus fotos y sus enlaces sin que lo pidas. Mientras tanto, la ficha dice «Buscando fotos y enlaces…». Se consultan fuentes abiertas, por orden de confianza, y la que falla no tumba a las demás:

Si el sitio salió del buscador, sus etiquetas de OpenStreetMap, que a menudo dicen su entidad de Wikidata, su artículo de Wikipedia, su web y a veces su foto.
Si no, el artículo de Wikipedia que le corresponde: primero por cercanía a sus coordenadas, con un radio que depende de la categoría, y después por nombre, algo más lejos. Primero en el idioma de la app y, si no hay, en inglés.
Su entidad de Wikidata: la foto principal, la web oficial, la categoría de Commons y los enlaces a Wikipedia y Wikivoyage.
Las fotos de esa categoría de Wikimedia Commons.
La imagen de portada de su web oficial. Esto solo se hace en la app del móvil (en camino a las tiendas): en el navegador y en el ordenador, las normas de seguridad no dejan leer una web de otro dominio sin pasar por un servidor, y Kokai no la pasa por el suyo. La dirección de la web sí sale en todas partes, como enlace.
Si todavía hay menos de 3 fotos, fotos de Commons tomadas cerca (a 150 m, o a 1.500 m si es naturaleza) cuyo título se parezca al nombre del sitio.

Se descartan solas las imágenes que no son fotos del sitio: logotipos, mapas de situación, escudos, banderas, planos y diagramas, los formatos que no son fotografía y las de menos de 400 px de ancho. Se enseñan como mucho 8 fotos por sitio.

Cada foto de Wikimedia lleva a la vista, en el visor, su autor y su licencia («Foto: autor · licencia · Wikimedia Commons») y el enlace a la página del fichero, que es lo que piden sus licencias libres. Las fotos no se copian en Kokai: se enseñan enlazadas desde su origen.

Lo que no es de ahí se descarta: con la X de la tira («Descartar esta foto») o con «No es de aquí» en el visor. Lo descartado no se borra, se queda marcado, y por eso la siguiente búsqueda no vuelve a traer la misma foto de la plaza de al lado. Las descartadas se ven aparte y se recuperan con «Recuperar esta foto». «Buscar más» vuelve a preguntar a las fuentes.

Los enlaces salen en la ficha con su tipo: la web, Wikipedia, Wikivoyage y «Fotos en Wikimedia Commons». Se añaden a mano con «Añadir un enlace: reserva, reseña, vídeo…» y se quitan con «Quitar el enlace».

Si no hay conexión al crear el sitio, la ficha dice «No se han podido buscar las fotos. ¿Hay conexión?», y la búsqueda se repite la próxima vez que abras su ficha. Se buscan como mucho dos sitios a la vez y cada búsqueda se corta a los 45 segundos: aceptar un plan con treinta sitios nuevos no satura a Wikimedia.

El destino del viaje, situado en el mapa

Al crear un viaje escribes su Destino tal como lo dirías: «Islandia», «Tokio, Kioto y Osaka», «Lisboa y Sintra». Kokai lo busca en el mapa y, debajo del campo, dice lo que ha encontrado. Con eso:

el mapa del viaje, el de sus intereses y el del plan con IA abren ya ahí, aunque todavía no tengas sitios;
el buscador se inclina hacia esa zona;
la IA sabe de qué viaje le hablas;
el resumen del viaje lleva de portada el destino en el mapa con tus sitios;
y el viaje sale en el mapa de todos tus viajes.

Quien contesta aquí es Nominatim, el geocodificador de OpenStreetMap, y no Photon, el del buscador de sitios: Nominatim conoce los nombres de países y ciudades en español. Su política de uso no permite buscar mientras se escribe y pide como mucho una petición por segundo, así que Kokai pregunta una sola vez, al salir del campo o al guardar, y en fila.

Una «ciudad» cuya caja llega a islas lejanas se recorta a 40 km de su punto; un condado, una isla o un archipiélago, a 200 km; una región o un país, a 1.500 km. Si no encuentra nada, lo dice («No lo encuentro en el mapa. Prueba con una ciudad, una isla, una región o un país.»), y si no hay red, lo vuelve a intentar más tarde. Los viajes creados antes de que existiera esto se sitúan solos al abrir «Tus viajes».

El mapa de todos tus viajes

En «Tus viajes», encima de la lista (agrupada en Ahora, Próximos, Ideas sin fecha y Ya viajados), hay un mapa con una maleta por cada viaje situado, en el punto de su destino y con su nombre. Tienen color los próximos y el que está en curso; las ideas sin fecha y los ya viajados van en neutro. Tocar una maleta abre el resumen de ese viaje.

Un viaje sin destino no sale en el mapa, y la nota de debajo lo dice. Este mapa, como el de la portada del resumen, está dentro de una página que se desplaza: se mueve con dos dedos, o con Ctrl y la rueda del ratón, para no atrapar el desplazamiento de la página.

Claro, oscuro y exterior

En Ajustes, «Tema» tiene cuatro opciones, y el mapa base se vuelve a pintar con cada una sin recargar:

Tema	Lo que dice la app	Para qué
Como el sistema	Claro de día y oscuro de noche, si tu sistema cambia solo.	Es la opción por defecto.
Claro	Tinta sobre papel de mapa.	Planificar en casa o en la oficina.
Oscuro	Para mirar el mapa de noche sin deslumbrarte.	Buscar el hotel a la salida de un concierto.
Exterior	Más contraste, para leer la pantalla a pleno sol.	Una plaza en agosto. El agua y los parques ganan color en vez de oscurecerse, porque el reflejo del sol aplana antes la claridad que el tono.

En los tres temas, los nombres del mapa tienen un contraste de al menos 4,5:1 sobre tierra, parques y agua, y cada categoría, la ruta y el recorrido, de 3:1: los umbrales de las pautas WCAG para texto y para piezas gráficas.

Por qué OpenStreetMap y no Google Maps

Google Maps es un buen mapa, y el botón «Cómo llegar» de cada sitio lo abre para que te guíe. Pero el mapa dentro de Kokai, el que guarda tus sitios, es de OpenStreetMap, por razones que notas al usarlo:

Lo que te importa	Con OpenStreetMap	Con los datos de Google Maps Platform
Guardar un sitio para dentro de seis meses	Sus datos tienen licencia abierta (ODbL): el nombre y las coordenadas que guardas se pueden conservar sin fecha de caducidad.	Sus condiciones no dejan guardar el contenido de un lugar más allá de excepciones concretas (el identificador del lugar sí).
Mapas sin conexión, cuando lleguen	Se pueden generar y servir las teselas de una zona entera para llevarlas en el móvil.	Sus condiciones no permiten precargar ni guardar su contenido para usarlo después.
El aspecto del mapa	Se pinta con los colores de Kokai, para que el color sea solo el de tus sitios.	Sus condiciones limitan enseñar sus resultados de lugares sobre un mapa que no sea de Google, con reglas propias en el Espacio Económico Europeo.

Las piezas, hoy: las teselas (los trozos de mapa) vienen de OpenFreeMap, con el esquema de OpenMapTiles y se dibujan con MapLibre GL, de código abierto; el buscador de sitios es Photon, de komoot, que busca en OpenStreetMap mientras escribes; el destino lo sitúa Nominatim. Lo decidido para publicar es servir el mapa desde el propio servidor de Kokai, en un solo fichero PMTiles generado con Planetiler, sin terceros. El buscador propio sigue pendiente.

La atribución se ve siempre. La licencia de OpenStreetMap (ODbL) exige decir de dónde salen los datos, y por eso en la esquina del mapa está el enlace a «OpenStreetMap», a OpenMapTiles y al proveedor de las teselas. No se puede quitar.

Lo que propone la IA llega con ubicación aproximada

Un modelo de lenguaje sabe que el Mirador da Senhora do Monte está en Lisboa, pero sus coordenadas pueden caer una calle o un barrio más allá. Por eso un sitio aceptado de la IA entra marcado como ubicación aproximada, y su ficha lo avisa:

La ubicación la dio la IA y puede estar desplazada. Arrastra el marcador al sitio exacto o confírmala.

Arrastrar el marcador o pulsar «Está bien» quita la marca. Mientras la tiene, el buscador de fotos es más prudente: busca su artículo de Wikipedia en un radio cuatro veces mayor (hasta 10 km) y no busca fotos de Commons alrededor de ese punto, que puede estar mal (sí alrededor de su artículo, si lo encuentra).

Al guardar un plan de la IA, un sitio nuevo que se llama igual que uno tuyo y está a menos de 1 km se considera el mismo: no se duplica. Lo cuenta El plan.

Qué necesita conexión

	Sin conexión	Por qué
Tus sitios, sus fichas, notas, prioridades y avisos	Sí	Están guardados en el dispositivo.
La lista de sitios, los filtros y las distancias	Sí	Se calculan en el dispositivo.
El mapa de fondo	No: sale en blanco	Las teselas se piden al servidor de mapas. Los mapas sin conexión por zonas están pendientes.
Buscar un lugar	No	Pregunta a Photon, que busca en OpenStreetMap.
Situar el destino	No	Pregunta a Nominatim; se reintenta al volver la red.
Fotos y enlaces	No	Se buscan y se enseñan desde su origen; un sitio creado sin red las busca al abrir su ficha.

Lo que sí tienes sin red durante el viaje, además de tus sitios: los avisos al pasar cerca y la dirección del alojamiento de esa noche, en En ruta.

Cómo comprobarlo tú

Nada de esto hay que creérselo: son los pasos para verlo en la app con tus propios ojos.

En «Tus viajes», pulsa «Nuevo viaje» y escribe en «Destino» «Lisboa y Sintra». Al salir del campo, debajo se lee «En el mapa: …» con lo que ha encontrado. Pulsa «Crear el viaje».
Ve a «Mapa»: abre ya sobre Lisboa y Sintra. Escribe «Torre de Belém» en «Buscar un lugar para añadirlo…», elige el resultado y pulsa «Guardar el sitio».
En la ficha aparece «Buscando fotos y enlaces…» y, al poco, las fotos. Abre una: debajo están el autor y la licencia. Si alguna no es de ahí, pulsa «No es de aquí».
Cambia la «Prioridad» a «Imprescindible» y vuelve con «Volver a la lista»: el sitio lo dice en la lista.
Pulsa «Añadir tocando el mapa», toca un punto, ponle nombre y pulsa «Guardar el sitio». Con su ficha abierta, arrastra el marcador y suéltalo en otro sitio.
Toca la pastilla de una categoría sobre la lista para filtrar. Después, en Ajustes, «Tema», elige «Exterior» y vuelve al mapa.

Abrir la app

Preguntas frecuentes

¿Por qué el buscador no encuentra un sitio?

Busca a partir de 3 letras y solo lo que está en OpenStreetMap. Prueba con el nombre como aparece en el propio lugar (en portugués, «Mosteiro dos Jerónimos»), mueve antes el mapa a esa zona, porque los resultados se ordenan por cercanía, o añádelo con «Añadir tocando el mapa». Sin conexión no se puede buscar.

¿Las fotos ocupan espacio en mi móvil?

No: Kokai guarda de dónde sale cada foto, con su autor y su licencia, y la enseña enlazada desde Wikimedia Commons o desde la web del sitio. Por eso, sin conexión, las fotos no se ven.

¿Puedo crear categorías o cambiarles el color?

No. Son siete, con colores medidos para que se distingan entre sí también con daltonismo. Para agrupar sitios a tu manera usa las etiquetas, que también filtran el mapa.

¿Qué se envía a los servicios de mapas?

A Photon, lo que escribes en el buscador y el centro del mapa; a Nominatim, el nombre del destino; a Wikipedia, Wikidata, Commons y OpenStreetMap, el nombre y las coordenadas de cada sitio para buscar sus fotos; al servidor de teselas, la zona que miras. Nunca tu cuenta ni tus notas. Más en Tus datos.

Fuentes y referencias

La documentación original de lo que se cita aquí, consultada en la fecha de revisión de esta página.

Copyright y licencia de OpenStreetMap OpenStreetMap Foundation
Open Database License (ODbL) v1.0 Open Data Commons
Nominatim Usage Policy OpenStreetMap Foundation
Photon, geocodificador para OpenStreetMap komoot
Commons:Licensing Wikimedia Commons
Wikidata: introducción Wikidata
OpenFreeMap OpenFreeMap
Places API policies (almacenamiento y visualización) Google for Developers

Sigue leyendo

Esta página en Markdown, para leerla con otros programas