Com funciona

El mapa del teu viatge: desar llocs per categories, amb fotos i enllaços

A Kokai cada viatge té un mapa amb els teus llocs: els cerques pel nom o toques on són, i cadascun porta el color i la icona de la seva categoria, la seva prioritat i, sense que ho demanis, fotos i enllaços de Wikipedia, Wikidata i Wikimedia Commons amb el seu autor i la seva llicència. El mapa de base és d’OpenStreetMap i va en tons de paper, perquè l’únic color sigui el dels teus llocs. Els teus llocs es desen al dispositiu; el mapa de fons, el cercador i les fotos necessiten connexió.

Revisat el 17 de setembre de 2026 18 min de lectura

En poques paraules

Categories: Set: allotjament, menjar, visita, natura, oci i transport, cadascuna amb el seu color i la seva icona, i pràctic, amb icona i sense color.
Afegir un lloc: Cercant-lo pel nom (a partir de 3 lletres, fins a 8 resultats) o amb «Añadir tocando el mapa» («Afegir tocant el mapa»). El marcador s’arrossega per corregir-lo.
Prioritat: «Imprescindible», «Si hay tiempo» («Si hi ha temps», la d’un lloc nou) o «Quizás» («Potser»).
Fotos: Fins a 8 visibles per lloc, de Wikimedia Commons amb autor i llicència, i al mòbil la imatge de portada del seu web oficial. La que no és d’allà es descarta i no torna.
Dades del mapa: OpenStreetMap. Cercar llocs: Photon. Situar la destinació del viatge: Nominatim, com a màxim una petició per segon.
Temes: «Como el sistema» («Com el sistema»), «Claro» («Clar»), «Oscuro» («Fosc») i «Exterior» (més contrast, per llegir a ple sol). El mapa canvia amb l’app.
Sense connexió: Els teus llocs, les seves fitxes i les seves notes, sí. El mapa de fons, el cercador i les fotos, no: els mapes sense connexió estan pendents.

El mapa és paper; el color és dels teus llocs

Obre un viatge i toca Mapa a la barra: el mapa ocupa la pantalla i, al costat a l’ordinador o a sota al mòbil, hi ha la llista dels teus llocs amb el seu cercador. Si toques un lloc, s’obre la seva fitxa en aquest mateix panell.

El mapa de fons no porta colors propis. Terra, aigua, parcs i carrers es pinten en tons de paper de mapa i tinta, i els únics colors amb to que hi queden a sobre són els teus: els marcadors dels teus llocs, la línia de la ruta d’un dia i el recorregut gravat a En ruta. Així, quan una cosa té color, vol dir alguna cosa.

El color no va mai sol. Cada marcador porta la icona de la seva categoria i, en pantalles de més de 600 px d’amplada, el seu nom a sota. En un mòbil només es veu la icona, llevat de la del lloc que tens obert: amb vint noms a sobre, un mapa de 390 px no es llegeix.

Els marcadors són botons de veritat: es poden recórrer amb el teclat, fan 44 px per tocar-los amb el dit i el lector de pantalla en diu el nom i la categoria.

Les set categories

Cada lloc és d’una categoria, i la categoria decideix el seu color, la seva icona i el radi que es proposa per a l’avís de proximitat. Són fixes: per agrupar d’una altra manera («per anar amb nens», «de nit») hi ha les etiquetes. A l’app surten en castellà: Alojamiento, Comida, Visita, Naturaleza, Ocio, Transporte i Práctico.

Categoria	Icona i to	Què hi sol entrar	Radi de l’avís
Allotjament	Un llit, en blau indi	Hotels, albergs, cases d’hostes, apartaments, càmpings	150 m
Menjar	Coberts, en vermell	Restaurants, cafeteries, bars, gelateries, fleques i pastisseries	100 m
Visita	Un edifici amb columnes, en marró	Monuments, museus, galeries, miradors, temples	150 m
Natura	Una muntanya amb sol, en verd	Parcs, jardins, reserves naturals, platges i paratges	300 m
Oci	Una entrada, en magenta	Teatres, cinemes, botigues, estadis, zoos, aquàriums, parcs temàtics	100 m
Transport	Un tren, en blau	Estacions, aeroports, terminals de ferri, lloguer de cotxes o bicis, aparcaments	400 m
Pràctic	Un salvavides, sense color	La resta: una farmàcia, un caixer, un consolat	100 m

Pràctic no té color expressament. El que no encaixa en cap altra categoria hi va a parar, en gris: millor un gris honest que un color que digui el que no és. Tampoc no és una categoria el morat de la IA: marca el que la IA ha proposat i encara no has acceptat, amb la vora discontínua.

Sis colors i un gris no és un nombre a l’atzar. Els tons es van triar mesurant tots els parells alhora, també com els veu una persona amb protanopia o deuteranopia, i set és el màxim que es pot separar així. Un hotel no canvia de to quan passes al tema fosc: només s’aclareix perquè es llegeixi sobre el fons de nit.

Afegir llocs: cercar, tocar el mapa i arrossegar

Hi ha tres maneres que un lloc arribi al mapa, perquè s’hi arriba de tres maneres: saps com es diu, saps on és, o te’l proposa la IA.

Cercar pel nom: Escriu a «Buscar un lugar para añadirlo…» («Cercar un lloc per afegir-lo…»). Es cerca a partir de 3 lletres, quan deixes d’escriure, i surten fins a 8 resultats, decantats cap a la zona que mires al mapa (o cap a la destinació del viatge, si encara no l’has mogut): «catedral» en un viatge a Sevilla és la de Sevilla. Quan en tries un, surt «Guardar este lugar» («Desar aquest lloc») amb el nom i la categoria ja posats.
Tocar el mapa: Prem «Añadir tocando el mapa» i toca on és el lloc. Surt «Sitio nuevo» («Lloc nou») amb les seves coordenades: li poses nom, tries la categoria (proposa Visita) i prems «Guardar el sitio» («Desar el lloc»). Serveix per al que no té nom a cap mapa: un banc amb vistes, la porta del darrere d’un mercat.
Acceptar una proposta de la IA: Des d’un interès o des del pla amb IA. Hi entra amb la ubicació marcada com a aproximada (vegeu més avall).

Quan deses un lloc cercat, la seva categoria surt de com l’ha etiquetat OpenStreetMap: el que allà és un museu entra com a Visita; un restaurant o una pastisseria, com a Menjar. Si no et convenç, es canvia a la fitxa. Als dos formularis ja pots marcar «Avisarme cuando pase cerca, con el viaje en ruta» («Avisa’m quan passi a prop, amb el viatge en ruta»).

Per corregir on és, obre la fitxa del lloc: el seu marcador es pot arrossegar fins al punt exacte i es desa quan el deixes anar. Només s’arrossega el lloc obert, perquè moure el mapa amb el dit no desplaci marcadors sense voler.

La fitxa de cada lloc

Tot el que hi ha a la fitxa es desa sol, mig segon després que deixis d’escriure. No hi ha botó de desar: en un mòbil, amb l’altra mà ocupada, un botó de desar és una dada perduda.

Prioritat: «Imprescindible», «Si hay tiempo» o «Quizás». Un lloc nou entra com a «Si hay tiempo». Els imprescindibles ho diuen a la llista, i el pla amb IA comença per ells.
«Marcar visitado» («Marcar com a visitat») i «Cómo llegar» («Com arribar-hi»), que obre la ruta fins a aquest punt a Google Maps.
Notes, amb «Proponer» («Proposar») perquè la IA suggereixi què demanar o a quina hora anar-hi.
«Avisarme al pasar cerca» («Avisa’m en passar a prop»), amb «A qué distancia» («A quina distància», de 75 a 1.000 m): ho explica En ruta.
«En el plan» («Al pla») i «Añadir al plan» («Afegir al pla»), per posar-lo en un dia o a «Sin fecha» («Sense data»).
«Dirección, horario, precio y contacto» («Adreça, horari, preu i contacte»), les etiquetes, els documents enllaçats i, en un allotjament, «Noches aquí» («Nits aquí», Allotjament).
«Preguntar a la IA por este sitio» («Preguntar a la IA sobre aquest lloc»), que obre un interès sobre els seus voltants.

Si esborres un lloc, també desapareix dels dies del pla on era. Els documents enllaçats no s’esborren.

Filtres, llista i eines del mapa

Amb molts llocs desats, el mapa s’ordena així:

Per categoria: damunt la llista hi ha una pastilla per cada categoria que tingui algun lloc. Si en toques una, només queda aquella; si en toques una altra, se suma. Si no n’hi ha cap de triada, es veu tot.
Per etiqueta: si tries diverses etiquetes, surten els llocs que les tenen totes.
La llista diu quants llocs veus («12 de 40») i, de cadascun, si és imprescindible, si està visitat o té avís, i la seva adreça.
«Dónde estoy» («On soc») centra el mapa en la teva posició i, a partir d’aquí, la llista s’ordena per distància i mostra a quina distància és cada lloc.
«Ver todos los sitios» («Veure tots els llocs») enquadra el mapa perquè hi càpiguen tots.
Si has gravat recorreguts en ruta, «Ver el recorrido» («Veure el recorregut») i «Ocultar el recorrido» («Amagar el recorregut») els mostren o els amaguen.

Els llocs amb avís porten dibuixat al voltant el cercle del seu radi, per veure d’un cop d’ull si dos avisos es trepitgen. La vista del mapa (on mires i amb quin zoom) es recorda a cada dispositiu: el mòbil pot mirar el barri mentre el portàtil mostra tota la ciutat.

Des del pla, el botó «Mapa» d’un dia obre aquest mateix mapa només amb els llocs d’aquell dia i la línia que els uneix en ordre.

Fotos i enllaços, sense que els hagis de buscar tu

Cada lloc nou surt a buscar les seves fotos i els seus enllaços sense que ho demanis. Mentrestant, la fitxa diu «Buscando fotos y enlaces…» («Buscant fotos i enllaços…»). Es consulten fonts obertes, per ordre de confiança, i la que falla no fa caure les altres:

Si el lloc ha sortit del cercador, les seves etiquetes d’OpenStreetMap, que sovint diuen la seva entitat de Wikidata, el seu article de Wikipedia, el seu web i de vegades la seva foto.
Si no, l’article de Wikipedia que li correspon: primer per proximitat a les seves coordenades, amb un radi que depèn de la categoria, i després pel nom, una mica més lluny. Primer en l’idioma de l’app i, si no n’hi ha, en anglès.
La seva entitat de Wikidata: la foto principal, el web oficial, la categoria de Commons i els enllaços a Wikipedia i Wikivoyage.
Les fotos d’aquella categoria de Wikimedia Commons.
La imatge de portada del seu web oficial. Això només es fa a l’app del mòbil (en camí cap a les botigues): al navegador i a l’ordinador, les normes de seguretat no deixen llegir un web d’un altre domini sense passar per un servidor, i Kokai no el fa passar pel seu. L’adreça del web sí que surt a tot arreu, com a enllaç.
Si encara hi ha menys de 3 fotos, fotos de Commons fetes a prop (a 150 m, o a 1.500 m si és natura) amb un títol que s’assembli al nom del lloc.

Es descarten soles les imatges que no són fotos del lloc: logotips, mapes de situació, escuts, banderes, plànols i diagrames, els formats que no són fotografia i les de menys de 400 px d’amplada. Es mostren com a màxim 8 fotos per lloc.

Cada foto de Wikimedia porta a la vista, al visor, el seu autor i la seva llicència («Foto: autor · llicència · Wikimedia Commons») i l’enllaç a la pàgina del fitxer, que és el que demanen les seves llicències lliures. Les fotos no es copien a Kokai: es mostren enllaçades des del seu origen.

El que no és d’allà es descarta: amb la X de la tira («Descartar esta foto», «Descartar aquesta foto») o amb «No es de aquí» («No és d’aquí») al visor. El que es descarta no s’esborra, queda marcat, i per això la cerca següent no torna a portar la mateixa foto de la plaça del costat. Les descartades es veuen a part i es recuperen amb «Recuperar esta foto» («Recuperar aquesta foto»). «Buscar más» («Buscar-ne més») torna a preguntar a les fonts.

Els enllaços surten a la fitxa amb el seu tipus: el web, Wikipedia, Wikivoyage i «Fotos en Wikimedia Commons» («Fotos a Wikimedia Commons»). S’afegeixen a mà amb «Añadir un enlace: reserva, reseña, vídeo…» («Afegir un enllaç: reserva, ressenya, vídeo…») i es treuen amb «Quitar el enlace» («Treure l’enllaç»).

Si no hi ha connexió quan crees el lloc, la fitxa diu «No se han podido buscar las fotos. ¿Hay conexión?» («No s’han pogut buscar les fotos. Hi ha connexió?»), i la cerca es repeteix la pròxima vegada que obris la fitxa. Es busquen com a màxim dos llocs alhora i cada cerca s’atura als 45 segons: acceptar un pla amb trenta llocs nous no satura Wikimedia.

La destinació del viatge, situada al mapa

Quan crees un viatge escrius la seva Destinació («Destino», a l’app) tal com la diries: «Islàndia», «Tòquio, Kyoto i Osaka», «Lisboa i Sintra». Kokai la cerca al mapa i, sota el camp, diu què ha trobat. Amb això:

el mapa del viatge, el dels seus interessos i el del pla amb IA ja s’obren allà, encara que no tinguis llocs;
el cercador es decanta cap a aquella zona;
la IA sap de quin viatge li parles;
el resum del viatge porta de portada la destinació al mapa amb els teus llocs;
i el viatge surt al mapa de tots els teus viatges.

Aquí respon Nominatim, el geocodificador d’OpenStreetMap, i no Photon, el del cercador de llocs: Nominatim coneix els noms de països i ciutats en castellà i en altres llengües. La seva política d’ús no permet cercar mentre s’escriu i demana com a màxim una petició per segon, així que Kokai pregunta una sola vegada, en sortir del camp o en desar, i en fila.

Una «ciutat» amb una caixa que arriba a illes llunyanes es retalla a 40 km del seu punt; un comtat, una illa o un arxipèlag, a 200 km; una regió o un país, a 1.500 km. Si no troba res, ho diu («No lo encuentro en el mapa. Prueba con una ciudad, una isla, una región o un país.», «No ho trobo al mapa. Prova amb una ciutat, una illa, una regió o un país.»), i si no hi ha xarxa, ho torna a provar més tard. Els viatges creats abans que existís això se situen sols quan obres «Tus viajes» («Els teus viatges»).

El mapa de tots els teus viatges

A «Tus viajes», damunt la llista (agrupada en «Ahora», «Próximos», «Ideas sin fecha» i «Ya viajados»: ara, propers, idees sense data i ja viatjats), hi ha un mapa amb una maleta per cada viatge situat, al punt de la seva destinació i amb el seu nom. Tenen color els propers i el que està en curs; les idees sense data i els ja viatjats van en neutre. Si toques una maleta, s’obre el resum d’aquell viatge.

Un viatge sense destinació no surt al mapa, i la nota de sota ho diu. Aquest mapa, com el de la portada del resum, és dins d’una pàgina que es desplaça: es mou amb dos dits, o amb Ctrl i la roda del ratolí, per no atrapar el desplaçament de la pàgina.

Clar, fosc i exterior

A Ajustos, «Tema» té quatre opcions, i el mapa de base es torna a pintar amb cadascuna sense recarregar:

Tema	El que diu l’app	Per a què
Com el sistema	Clar de dia i fosc de nit, si el teu sistema canvia sol.	És l’opció per defecte.
Clar	Tinta sobre paper de mapa.	Planificar a casa o a l’oficina.
Fosc	Per mirar el mapa de nit sense enlluernar-te.	Buscar l’hotel a la sortida d’un concert.
Exterior	Més contrast, per llegir la pantalla a ple sol.	Una plaça a l’agost. L’aigua i els parcs guanyen color en lloc d’enfosquir-se, perquè el reflex del sol aplana abans la claredat que el to.

En els tres temes, els noms del mapa tenen un contrast d’almenys 4,5:1 sobre terra, parcs i aigua, i cada categoria, la ruta i el recorregut, de 3:1: els llindars de les pautes WCAG per a text i per a elements gràfics.

Per què OpenStreetMap i no Google Maps

Google Maps és un bon mapa, i el botó «Cómo llegar» de cada lloc l’obre perquè et guiï. Però el mapa de dins de Kokai, el que desa els teus llocs, és d’OpenStreetMap, per raons que notes quan el fas servir:

El que t’importa	Amb OpenStreetMap	Amb les dades de Google Maps Platform
Desar un lloc per d’aquí a sis mesos	Les seves dades tenen llicència oberta (ODbL): el nom i les coordenades que deses es poden conservar sense data de caducitat.	Les seves condicions no deixen desar el contingut d’un lloc més enllà d’excepcions concretes (l’identificador del lloc, sí).
Mapes sense connexió, quan arribin	Es poden generar i servir les tessel·les de tota una zona per portar-les al mòbil.	Les seves condicions no permeten precarregar ni desar el seu contingut per fer-lo servir després.
L’aspecte del mapa	Es pinta amb els colors de Kokai, perquè el color sigui només el dels teus llocs.	Les seves condicions limiten mostrar els seus resultats de llocs sobre un mapa que no sigui de Google, amb regles pròpies a l’Espai Econòmic Europeu.

Les peces, avui: les tessel·les (els trossos de mapa) venen d’OpenFreeMap, amb l’esquema d’OpenMapTiles, i es dibuixen amb MapLibre GL, de codi obert; el cercador de llocs és Photon, de komoot, que cerca a OpenStreetMap mentre escrius; la destinació la situa Nominatim. El que s’ha decidit per publicar és servir el mapa des del servidor de Kokai, en un sol fitxer PMTiles generat amb Planetiler, sense tercers. El cercador propi continua pendent.

L’atribució es veu sempre. La llicència d’OpenStreetMap (ODbL) obliga a dir d’on surten les dades, i per això a la cantonada del mapa hi ha l’enllaç a «OpenStreetMap», a OpenMapTiles i al proveïdor de les tessel·les. No es pot treure.

El que proposa la IA arriba amb ubicació aproximada

Un model de llenguatge sap que el Miradouro da Senhora do Monte és a Lisboa, però les seves coordenades poden caure un carrer o un barri més enllà. Per això un lloc acceptat de la IA entra marcat com a ubicació aproximada, i la seva fitxa ho avisa amb aquest missatge («La IA ha donat la ubicació i pot estar desplaçada. Arrossega el marcador al lloc exacte o confirma-la.»):

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

Arrossegar el marcador o prémer «Está bien» («Està bé») treu la marca. Mentre la té, el cercador de fotos és més prudent: busca el seu article de Wikipedia en un radi quatre vegades més gran (fins a 10 km) i no busca fotos de Commons al voltant d’aquest punt, que pot estar malament (sí al voltant del seu article, si el troba).

Quan deses un pla de la IA, un lloc nou que es diu igual que un dels teus i és a menys d’1 km es considera el mateix: no es duplica. Ho explica El pla.

Què necessita connexió

	Sense connexió	Per què
Els teus llocs, les seves fitxes, notes, prioritats i avisos	Sí	Estan desats al dispositiu.
La llista de llocs, els filtres i les distàncies	Sí	Es calculen al dispositiu.
El mapa de fons	No: surt en blanc	Les tessel·les es demanen al servidor de mapes. Els mapes sense connexió per zones estan pendents.
Cercar un lloc	No	Pregunta a Photon, que cerca a OpenStreetMap.
Situar la destinació	No	Pregunta a Nominatim; es torna a provar quan torna la xarxa.
Fotos i enllaços	No	Es busquen i es mostren des del seu origen; un lloc creat sense xarxa les busca quan n’obres la fitxa.

El que sí que tens sense xarxa durant el viatge, a més dels teus llocs: els avisos de proximitat i l’adreça de l’allotjament d’aquella nit, a En ruta.

Com comprovar-ho tu

No cal creure’s res de tot això: són els passos per veure-ho a l’app amb els teus propis ulls.

A «Tus viajes» («Els teus viatges»), prem «Nuevo viaje» («Viatge nou») i escriu a «Destino» («Destinació») «Lisboa y Sintra». Quan surts del camp, a sota es llegeix «En el mapa: …» («Al mapa: …») amb el que ha trobat. Prem «Crear el viaje» («Crear el viatge»).
Ves a «Mapa»: ja s’obre sobre Lisboa i Sintra. Escriu «Torre de Belém» a «Buscar un lugar para añadirlo…» («Cercar un lloc per afegir-lo…»), tria el resultat i prem «Guardar el sitio» («Desar el lloc»).
A la fitxa apareix «Buscando fotos y enlaces…» («Buscant fotos i enllaços…») i, al cap de poc, les fotos. Obre’n una: a sota hi ha l’autor i la llicència. Si n’hi ha alguna que no és d’allà, prem «No es de aquí» («No és d’aquí»).
Canvia la «Prioridad» («Prioritat») a «Imprescindible» i torna amb «Volver a la lista» («Tornar a la llista»): el lloc ho diu a la llista.
Prem «Añadir tocando el mapa» («Afegir tocant el mapa»), toca un punt, posa-li nom i prem «Guardar el sitio». Amb la fitxa oberta, arrossega el marcador i deixa’l anar en un altre lloc.
Toca la pastilla d’una categoria damunt la llista per filtrar. Després, a Ajustos, «Tema», tria «Exterior» i torna al mapa.

Obrir l’app

Preguntes freqüents

Per què el cercador no troba un lloc?

Cerca a partir de 3 lletres i només el que és a OpenStreetMap. Prova amb el nom tal com surt al mateix lloc (en portuguès, «Mosteiro dos Jerónimos»), mou abans el mapa cap a aquella zona, perquè els resultats s’ordenen per proximitat, o afegeix-lo amb «Añadir tocando el mapa» («Afegir tocant el mapa»). Sense connexió no es pot cercar.

Les fotos ocupen espai al meu mòbil?

No: Kokai desa d’on surt cada foto, amb el seu autor i la seva llicència, i la mostra enllaçada des de Wikimedia Commons o des del web del lloc. Per això, sense connexió, les fotos no es veuen.

Puc crear categories o canviar-los el color?

No. Són set, amb colors mesurats perquè es distingeixin entre ells també amb daltonisme. Per agrupar llocs a la teva manera, fes servir les etiquetes, que també filtren el mapa.

Què s’envia als serveis de mapes?

A Photon, el que escrius al cercador i el centre del mapa; a Nominatim, el nom de la destinació; a Wikipedia, Wikidata, Commons i OpenStreetMap, el nom i les coordenades de cada lloc per buscar-ne les fotos; al servidor de tessel·les, la zona que mires. Mai el teu compte ni les teves notes. Més informació a Les teves dades.

Fonts i referències

La documentació original del que se cita aquí, consultada en la data de revisió d’aquesta pàgina.

Drets d’autor i llicència d’OpenStreetMap OpenStreetMap Foundation
Open Database License (ODbL) v1.0 Open Data Commons
Política d’ús de Nominatim OpenStreetMap Foundation
Photon, geocodificador per a OpenStreetMap komoot
Commons: sobre les llicències Wikimedia Commons
Wikidata: introducció Wikidata
OpenFreeMap OpenFreeMap
Polítiques de Places API (emmagatzematge i visualització) Google for Developers

Continua llegint

Aquesta pàgina en Markdown, per llegir-la amb altres programes