# Interessos: el mapa del teu viatge, amb els teus llocs per categories, fotos i enllaços

> A Kokai el mapa del viatge i els teus interessos són la mateixa secció, «Intereses» («Interessos»): el mapa ocupa la pantalla i al costat hi ha una sola llista amb els teus llocs, les zones que has marcat i els temes que vols resoldre, perquè les tres coses són el mateix: alguna cosa que vols fer o veure. Els 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ó.

- Adreça: https://kokai.app/ca/mapa/
- Revisat el: 2026-09-18
- Idioma: ca-ES

## 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.
- **Una sola llista:** Els teus llocs (un punt al mapa), les teves zones i els teus temes, junts i marcables igual: un lloc es visita, una zona o un tema es compleix. El que ja està fet es recull al final, a «{n} hechos» («{n} fets»).
- **Afegir un lloc:** Cercant-lo pel nom (a partir de 3 lletres, fins a 8 resultats), amb «Añadir tocando el mapa» («Afegir tocant el mapa»), acceptant una proposta de la IA o important un full de càlcul. El marcador s’arrossega per corregir-lo.
- **Importar un full:** Hi deixes anar un .xlsx o un .csv i vincules cada columna amb un camp del lloc. Fins a 200 files. Sense IA: es llegeix i es reparteix al teu dispositiu. Tot entra com a propostes.
- **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 **Intereses** («Interessos») a la barra: el mapa ocupa la pantalla i, al costat a l’ordinador o a sota al mòbil, hi ha la llista 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](https://kokai.app/ca/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.

## Un lloc i un interès són el mateix

Al panell no hi ha dues llistes. Hi ha junts **els teus llocs** (un punt al mapa, amb la seva fitxa), **les teves zones** (un tros de mapa amb un radi, de 100 m a 500 km, per preguntar a la IA què hi ha) i **els teus temes** (una idea sense lloc concret: «sopar sense reservar»). Les tres coses són el mateix: alguna cosa que vols fer, veure o saber en aquest viatge.

Per això es marquen igual, amb la casella de l’esquerra: un lloc es marca **visitat** i una zona o un tema, **complert** (i llavors es poden valorar). El que ja està fet no desapareix: es recull al final de la llista, a «{n} hechos» («{n} fets»), i es desplega quan vols.

El cercador de dalt cerca en les dues direccions alhora: primer entre el que és teu (pel nom, l’adreça o les notes) i, a sota, a «Lugares para añadir» («Llocs per afegir»), el que troba al mapa per desar-lo. Amb «Nuevo interés» («Nou interès») crees una zona o un tema; amb «Añadir tocando el mapa», un lloc.

> Un interès lligat a un lloc no surt a part a la llista: és la conversa d’aquell lloc i s’obre des de la seva fitxa, amb «Preguntar a la IA por este sitio» («Preguntar a la IA per aquest lloc»). Si ja té propostes sense decidir, el botó ho diu.

## 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](https://kokai.app/ca/en-ruta/#radios). 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 quatre maneres que un lloc arribi al mapa, perquè s’hi arriba de quatre maneres: saps com es diu, saps on és, te’l proposa la [IA](https://kokai.app/ca/ia/) o el tenies apuntat en un altre lloc.

- **Cercar pel nom:** Escriu a «Buscar en tus intereses o un lugar nuevo…» («Cercar als teus interessos o un lloc nou…»): primer cerca entre el que ja tens i, a sota, a «Lugares para añadir» («Llocs per afegir»), al mapa. 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).
- **Importar un full de càlcul:** Arrossegues el fitxer a sobre d’Interessos, o prems «Importar una hoja» («Importar un full»). Hi entra com a propostes, per acceptar-les o descartar-les (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.

### Exemple: Tres llocs a Lisboa en un minut

1. Al mapa del viatge escrius «Pastéis de Belém». Apareix a la llista amb la seva adreça; el tries i prems «Guardar el sitio». Si OpenStreetMap el té com a pastisseria o cafeteria, entra com a Menjar.
2. Escrius «Torre de Belém» i el deses igual. Si està etiquetat com a monument, entra com a Visita, amb el radi d’avís de 150 m.
3. Vols desar el tram del passeig vora el riu on vas parar l’última vegada, que no té nom. Prems «Añadir tocando el mapa», toques a la riba, li poses «Banc del riu», tries Natura i el deses.
4. Quan obres el «Banc del riu» veus que el punt ha quedat a la carretera. Arrossegues el marcador uns metres cap a l’aigua i el deixes anar.

## 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](https://kokai.app/ca/plan/#plan-con-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](https://kokai.app/ca/en-ruta/#radios).
- **«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](https://kokai.app/ca/alojamiento/)).
- **«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](https://kokai.app/ca/plan/#ver-en-el-mapa), 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.

## Portar els teus llocs d’un full de càlcul

Si fa anys que apuntes llocs en un Excel o en un full de Google, no cal teclejar-los una altra vegada: **arrossega el fitxer a sobre d’Interessos** (o prem «Importar una hoja», «Importar un full», que al mòbil és l’única manera). Kokai l’obre allà mateix, t’ensenya les primeres files perquè reconeguis que és el que volies i diu quantes n’ha llegit.

A sota, **«Qué es cada columna»** («Què és cada columna»): un desplegable per camp del lloc (nom, categoria, adreça, enllaç, coordenades, notes) amb les columnes del teu full. Kokai l’omple tota sola mirant les capçaleres —en castellà, anglès o català— i, si el full no en té, el que hi ha a les cel·les: una columna d’URL és l’enllaç, una de dos números són les coordenades. Es corregeix amb un toc, i cada columna només pot ser una cosa.

**No cal IA**: el full es llegeix i es reparteix al teu dispositiu, i el fitxer no en surt. La [IA](https://kokai.app/ca/ia/) només hi és de drecera, amb «Que lo adivine la IA» («Que ho endevini la IA»), per quan les capçaleres són estranyes o no n’hi ha: llavors li arriben la capçalera i tres files de mostra en **una sola petició** i contesta quina columna és cada cosa, així que un full de dos-cents llocs costa el mateix que un de tres.

A sota es veu quants llocs en sortirien i els tres primers com quedarien. En importar, tot hi entra com a **propostes** d’un interès nou amb el nom del fitxer: es veuen al mapa, s’accepten una a una o totes i el que no encaixa es descarta. No hi entra res al teu viatge sense que ho miris.

- **Formats:** .xlsx (Excel, LibreOffice, Google Sheets exportat) i .csv o .tsv, amb comes, punts i comes o tabuladors.
- **Quant:** Fins a 200 files per fitxer. Només el primer full del llibre; si n’hi ha més, es diu quin s’ha llegit.
- **Els enllaços amagats:** Si la cel·la ensenya un nom i l’URL és a l’hipervincle, es llegeix l’URL: és on sol ser el web d’un lloc.
- **Les dates:** Una data amb format de data es llegeix com a data i no com el número que Excel desa per dins.
- **Les coordenades:** Valen juntes en una cel·la («38.6916, -9.2160», amb coma o amb punt i coma) o en dues columnes, i també un enllaç de Google Maps o d’OpenStreetMap del qual es puguin treure.
- **La categoria:** Surt del que digui el full: «Restaurante» o «bakery» és menjar; «Museu», visita; «Estació», transport. El que no es reconegui hi entra com a Visita, que és el que es proposa en desar un lloc a mà.
- **Sense coordenades:** El que no en porti es cerca per l’adreça a Nominatim, fins a 40 llocs i una petició per segon. El que ni així es trobi es queda a la destinació del viatge, marcat perquè el moguis.

> Un full amb una capçalera clara («Nom», «Adreça», «Web», «Notes») es vincula tot sol, però no cal: si la primera fila ja és un lloc, no es pren per capçalera i no es perd. L’única cosa que no es pot endevinar després és quina columna és el nom: sense aquesta, el botó d’importar no s’encén.

## 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:

1. 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.
2. 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.
3. La seva **entitat de Wikidata**: la foto principal, el web oficial, la categoria de Commons i els enllaços a Wikipedia i Wikivoyage.
4. Les **fotos d’aquella categoria de Wikimedia Commons**.
5. 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ç.
6. 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.

### Exemple: «Lisboa i Sintra»

1. Si es pregunta sencer, un geocodificador només retorna Sintra. Per això Kokai primer mira si existeix un lloc que es digui exactament així (és el que passa amb «Trinitat i Tobago») i, si no, parteix el text per les comes, la «i» i altres separadors, fins a cinc parts.
2. Cerca «Lisboa» i, un segon després, «Sintra». Cada resposta porta un punt i la caixa que ocupa el lloc.
3. Les ajunta: el marcador del viatge va al punt de Lisboa, que és la primera, i el mapa enquadra la caixa que abasta les dues ciutats.
4. Sota el camp es llegeix «En el mapa: Lisboa · Sintra, Portugal» («Al mapa: …»). El país es diu una vegada perquè és el mateix.

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](https://kokai.app/ca/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](https://kokai.app/ca/plan/#plan-con-ia).

## 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](https://kokai.app/ca/en-ruta/#sin-conexion).

## Com comprovar-ho tu

1. 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»).
2. Ves a «Intereses» («Interessos»): ja s’obre sobre Lisboa i Sintra. Escriu «Torre de Belém» a «Buscar en tus intereses o un lugar nuevo…» («Cercar als teus interessos o un lloc nou…»), tria el resultat a «Lugares para añadir» («Llocs per afegir») i prem «Guardar el sitio» («Desar el lloc»).
3. 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í»).
4. Canvia la «Prioridad» («Prioritat») a «Imprescindible» i torna amb «Volver a la lista» («Tornar a la llista»): el lloc ho diu a la llista.
5. 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.
6. Toca la pastilla d’una categoria damunt la llista per filtrar. Després, a Ajustos, «Tema», tria «Exterior» i torna al mapa.

## 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](https://kokai.app/ca/tus-datos/).

## Fonts i referències

- [Drets d’autor i llicència d’OpenStreetMap](https://www.openstreetmap.org/copyright/ca) — OpenStreetMap Foundation
- [Open Database License (ODbL) v1.0](https://opendatacommons.org/licenses/odbl/) — Open Data Commons
- [Política d’ús de Nominatim](https://operations.osmfoundation.org/policies/nominatim/) — OpenStreetMap Foundation
- [Photon, geocodificador per a OpenStreetMap](https://github.com/komoot/photon) — komoot
- [Commons: sobre les llicències](https://commons.wikimedia.org/wiki/Commons:Licensing/ca) — Wikimedia Commons
- [Wikidata: introducció](https://www.wikidata.org/wiki/Wikidata:Introduction/ca) — Wikidata
- [OpenFreeMap](https://openfreemap.org/) — OpenFreeMap
- [Polítiques de Places API (emmagatzematge i visualització)](https://developers.google.com/maps/documentation/places/web-service/policies) — Google for Developers