# Cercar vols amb les dates del viatge i els aeroports més propers

> Kokai no ven bitllets ni consulta preus: cerca a la seva pròpia llista de 3.244 aeroports, sense xarxa, els més propers a la destinació i el de la teva sortida, i construeix l’enllaç de cerca de set webs (Google Vuelos, Skyscanner, Kayak, Momondo, eDreams, Trip.com i Aviasales) amb les dates del viatge i els viatgers ja posats. Fins que no en toques un, no surt res del dispositiu.

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

## En poques paraules

- **On és:** Botó «Buscar vuelos» («Cercar vols») al «Resumen» («Resum») del viatge (si encara no ha passat) i a «Documentos» («Documents»).
- **Aeroports:** 3.244, els que tenen vols regulars i codi IATA, d’OurAirports (domini públic). Van dins de l’app.
- **Aeroports de la destinació:** Els que hi ha a menys de 150 km de la destinació situada al mapa, fins a quatre; els petits compten com si fossin al doble de lluny.
- **Webs:** Set: Google Vuelos, Skyscanner, Kayak, Momondo, eDreams, Trip.com i Aviasales. Anada i tornada o només anada.
- **Què s’omple:** Aeroport de sortida i d’arribada, dates i viatgers (d’1 a 9). Google Vuelos no admet viatgers a l’enllaç.
- **Què surt del dispositiu:** Res fins que toques un enllaç. Només si escrius una ciutat que no és a la llista es cerca a Nominatim per trobar-ne els aeroports.
- **Preu:** Gratis. Kokai no cobra res ni s’emporta cap comissió, llevat que algun dia un enllaç sigui d’afiliat, i aleshores ho diu.

## Què fa i què no fa

Cercar un vol és gairebé sempre el mateix: triar d’on surts, on vas, les dates i quants viatgeu, i repetir-ho en tres o quatre webs per comparar. Kokai ja sap la destinació, les dates i els viatgers del teu viatge, així que t’estalvia la part repetida: obre cada cercador amb tot això escrit.

- **Sí**: troba els aeroports propers a la destinació, recorda el teu aeroport de sortida en aquell dispositiu i obre set cercadors amb la cerca feta.
- **No**: no mostra preus, no compara tarifes ni horaris, no compra bitllets i no avisa si baixa un preu. Tot això ho fa cada web, sota les seves condicions.
- **Després**: quan compris, afegeix el PDF del bitllet a [Documents](https://kokai.app/ca/documentos/). Kokai el llegeix al dispositiu, sense IA, i et recorda el vol la vigília.

## Per què enllaços i no una cerca dins de l’app

Mostrar preus dins de Kokai exigiria una API de vols o llegir les pàgines de resultats d’altres. Revisat el 17 de setembre de 2026, cap de les dues vies serveix per a una app que no té servidor de cerca ni vol que el teu viatge passi per un:

| Via | Què passa avui |
| --- | --- |
| Amadeus for Developers | El seu portal d’autoservei, el que donava claus gratis, «es va desmantellar el 17 de juliol»: el seu web ja només ofereix el portal d’empreses. |
| Kiwi.com (Tequila) | El seu portal per a desenvolupadors no deixa entrar: respon amb un error 403. |
| Skyscanner | Les seves API de cerca són per als seus socis comercials, amb normes d’ús i de disseny; el que sí que publica per a tothom és el format dels seus enllaços. |
| Duffel | És una API per vendre bitllets: demana compte, i cada reserva es paga. Una app que no ven res no la necessita. |
| Llegir les pàgines de resultats | Va contra les condicions d’aquestes webs, el navegador ho impedeix (les pàgines d’un altre domini no es poden llegir des d’una app web) i obligaria a enviar el teu viatge a un servidor que ho fes per tu. |

Un enllaç, en canvi, no necessita permís de ningú, funciona igual al navegador i al mòbil, i no envia res fins que el toques. És el mateix que fa [Allotjament](https://kokai.app/ca/alojamiento/) amb Booking.com o Airbnb.

## La llista d’aeroports, sense xarxa

Kokai porta dins la llista d’aeroports d’**OurAirports**, un projecte de dades obertes de **domini públic**. Dels seus més de 80.000 aeròdroms es queden els que serveixen per comprar un bitllet: aeroports grans i mitjans, amb vols regulars i amb codi IATA de tres lletres. Són **3.244**.

- **Què en desa de cadascun:** El codi IATA, el nom, la ciutat, el país, les coordenades (amb tres decimals, uns 100 m) i si és gran, i els seus altres noms («Lisboa» i «Portela» al de Lisboa, «Londres» a Heathrow).
- **Quant ocupa:** 278 KB, 112 KB comprimida. Es carrega només en obrir la cerca de vols, no en obrir l’app.
- **Com s’actualitza:** Amb `npm run aeropuertos`, que torna a baixar la llista i la retalla. La que va a l’app és del 17 de setembre de 2026.

Els noms venen en anglès, tal com els publica OurAirports («Lisbon Humberto Delgado Airport»); el país surt en l’idioma de l’app. El **codi IATA** és el que s’envia a cada cercador, i és igual en tots els idiomes.

## Els aeroports més propers a la destinació

Si la destinació del viatge està situada al mapa, Kokai mesura la distància en línia recta des d’aquest punt fins a cada aeroport de la llista i n’ofereix fins a **quatre a menys de 150 km**, amb la seva distància. Tria el primer pel seu compte.

Un aeroport gran a 40 km sol tenir més vols que un de petit a 15, així que, en ordenar, **els petits compten com si fossin al doble de lluny**. Si no n’hi ha cap en 150 km, s’ofereix el més proper, sigui on sigui.

| Destinació situada a… | El que ofereix, en ordre |
| --- | --- |
| Lisboa | LIS (a 6,6 km) i CAT, Cascais (a 18,7 km) |
| Vilafranca del Penedès | BCN, Barcelona (a 32 km), REU, Reus (a 50 km), GRO, Girona (a 108 km) i ILD, Lleida (a 106 km) |
| Ciutadella de Menorca | MAH, Menorca (a 36 km) i PMI, Palma (a 106 km) |
| Kyoto | ITM, Osaka Itami (a 39 km), UKB, Kobe (a 65 km), KIX, Kansai (a 81 km) i NGO, Chubu (a 96 km) |
| Illa de Flores (Açores) | FLW, Santa Cruz das Flores (a 6 km) |

> La distància és en línia recta, no per carretera. Abans de triar un aeroport llunyà, mira com s’arriba des d’allà a la destinació: de vegades el més barat és el que més costa després.

## D’on surts

El camp «Desde dónde sales» («D’on surts») es cerca per **codi, ciutat o nom**, sense tenir en compte accents ni majúscules. Primer surt el codi exacte («MAD»), després les ciutats o els altres noms que comencen pel que has escrit («Londres» dona Heathrow) i després els aeroports amb alguna paraula que comenci així («Humberto» dona Lisboa); en igualtat, els grans al davant.

Es cerca per paraules, no per trossos: «oporto» no troba els aeroports italians que porten «aeroporto» al nom. Si el que has escrit no és a la llista (una ciutat sense aeroport, o un nom en un altre idioma com «Oporto» o «Nueva York»), apareix «Buscar aeropuertos cerca de «…»» («Cercar aeroports a prop de «…»»): Kokai situa aquest lloc al mapa amb Nominatim, com fa amb la destinació del viatge, i n’ofereix els aeroports propers.

L’aeroport de sortida es **recorda en aquell dispositiu** per al viatge següent. No es copia al teu compte ni als teus altres dispositius.

## Les set webs i el format de cada enllaç

Cada enllaç es va obrir a Chromium el 17 de setembre de 2026, de Madrid a Lisboa, del 3 al 8 d’octubre i amb 2 adults, d’anada i tornada i només d’anada, i es va mirar què omplia el web:

| Web | Format | Què omple |
| --- | --- | --- |
| Google Vuelos | `google.com/travel/flights?q=…` amb la cerca escrita en anglès: `Flights to LIS from MAD on 2026-10-03 through 2026-10-08` | Aeroports i dates. Els viatgers, no: cerca per a una persona |
| Skyscanner | `skyscanner.net/g/referrals/v1/flights/day-view/` amb `origin`, `destination`, `outboundDate`, `inboundDate`, `adultsv2` i `locale` | El format és el que publica a la seva documentació; el seu web no deixa entrar un navegador automàtic i no es va poder obrir |
| Kayak | `kayak.es/flights/MAD-LIS/2026-10-03/2026-10-08/2adults` (`kayak.com` en anglès) | Aeroports, dates i viatgers |
| Momondo | `momondo.es/flight-search/MAD-LIS/2026-10-03/2026-10-08/2adults` | Aeroports, dates i viatgers |
| eDreams | `edreams.es/travel/#results/type=R;from=MAD;to=LIS;dep=…;ret=…;adults=2` (`type=O` i sense `ret` per a només anada) | Aeroports, dates i viatgers |
| Trip.com | `es.trip.com/flights/showfarefirst` amb `dcity`, `acity`, `ddate`, `rdate`, `triptype` (`rt` o `ow`) i `quantity` | Aeroports, dates i viatgers |
| Aviasales | `aviasales.com/search/MAD0310LIS08102`: origen, dia i mes d’anada, destinació, dia i mes de tornada i viatgers | Aeroports, dates i viatgers |

### Exemple: Madrid → Lisboa, del 3 al 8 d’octubre de 2026, 2 viatgers

Són els enllaços que genera Kokai amb l’app en castellà, trets d’executar la seva pròpia funció:

```
https://www.google.com/travel/flights?q=Flights+to+LIS+from+MAD+on+2026-10-03+through+2026-10-08&hl=es
https://www.skyscanner.net/g/referrals/v1/flights/day-view/?origin=mad&destination=lis&outboundDate=2026-10-03&inboundDate=2026-10-08&adultsv2=2&locale=es-ES
https://www.kayak.es/flights/MAD-LIS/2026-10-03/2026-10-08/2adults
https://www.momondo.es/flight-search/MAD-LIS/2026-10-03/2026-10-08/2adults
https://www.edreams.es/travel/#results/type=R;from=MAD;to=LIS;dep=2026-10-03;ret=2026-10-08;buyPath=36;internalSearch=true;adults=2
https://es.trip.com/flights/showfarefirst?dcity=mad&acity=lis&ddate=2026-10-03&rdate=2026-10-08&triptype=rt&class=y&quantity=2&locale=es-ES
https://www.aviasales.com/search/MAD0310LIS08102
```

Amb «Solo ida» («Només anada»), Kayak queda a `kayak.es/flights/MAD-LIS/2026-10-03/2adults` i Aviasales a `aviasales.com/search/MAD0310LIS2`.

Van quedar fora **Kiwi.com**, que amb codis d’aeroport no cerca res (vol noms de ciutat en el seu idioma, com `madrid-espana`), i **Expedia**, que no publica el format del seu enllaç i tampoc no el va deixar obrir. Les webs canvien les adreces sense avisar: si un enllaç deixa d’omplir alguna cosa, escriu pel [formulari de contacte](https://kokai.app/ca/contacto/).

## Dates, anada i tornada i viatgers

- «Ida» («Anada») i «Vuelta» («Tornada») comencen amb les dates del viatge, i es poden canviar sense tocar el viatge: per exemple, per mirar si surt més barat tornar un dia després.
- Amb «Solo ida» desapareix la tornada. Si la tornada queda abans de l’anada, els enllaços no es generen fins que s’arregla.
- «Viajeros» («Viatgers») comença amb els del viatge. Els cercadors en reben d’1 a 9, tots com a adults: nens i nadons s’ajusten a cada web.
- Sense aeroport de sortida o d’arribada, o amb tots dos iguals, Kokai diu el que falta en lloc de mostrar enllaços trencats.

## Enllaços d’afiliat

Com els d’allotjament, els enllaços de vols estan preparats per a programes d’afiliats, que paguen una comissió a qui els porta una compra sense que el preu canviï. S’activen en compilar l’app (`VITE_AFILIADOS`), amb els paràmetres de cada programa o amb l’enllaç d’una xarxa que redirigeix. Kayak, Trip.com i Google comparteixen configuració amb els d’allotjament, perquè el programa és el mateix.

Avui l’app es publica **sense afiliats**. Si algun dia un enllaç ho és, sota la llista surt: «Algunos son enlaces de afiliado: si reservas desde ellos, Kokai puede recibir una comisión, sin que te cueste más.» («Alguns són enllaços d’afiliat: si reserves des d’aquests, Kokai pot rebre una comissió, sense que et costi més.»)

## Què surt del teu dispositiu

| Quan | Qui ho rep | Què |
| --- | --- | --- |
| En obrir «Buscar vuelos» | Ningú | La llista d’aeroports va dins de l’app, i els propers es calculen al dispositiu |
| En prémer «Buscar aeropuertos cerca de «…»» | Nominatim, de la Fundació OpenStreetMap | Només el text escrit |
| En tocar un cercador | Aquell web | Els dos codis d’aeroport, les dates, els viatgers i l’idioma, a l’adreça de l’enllaç |

La resta del viatge (els llocs, el pla, els documents) no va a cap enllaç. El que faci cada web amb la teva cerca ho diuen les seves condicions i la seva política de privacitat. Més informació a [Les teves dades](https://kokai.app/ca/tus-datos/).

## Com comprovar-ho tu

1. Obre un viatge amb dates i amb la destinació situada al mapa, i al «Resumen» prem «Buscar vuelos».
2. A «Adónde vas» («On vas») ja surt triat l’aeroport més proper a la destinació, amb la distància a cada opció.
3. A «Desde dónde sales», escriu `Madrid` i tria «MAD · Madrid». Escriu després `Oporto`: com que no és a la llista, apareix «Buscar aeropuertos cerca de «Oporto»» («Cercar aeroports a prop de «Oporto»»).
4. Mira les dates i els viatgers: són els del viatge. Canvia a «Solo ida» i la tornada desapareix.
5. Toca «Kayak»: s’obre en una altra pestanya amb els aeroports, les dates i els viatgers ja posats.
6. Tanca i torna a obrir «Buscar vuelos»: l’aeroport de sortida continua triat en aquell dispositiu.

## Preguntes freqüents

### Kokai em diu quin és el vol més barat?

No. No consulta preus: obre cada cercador amb la teva cerca feta, i la comparació la fa cada web. Obrir-ne dos o tres ajuda a veure si un preu és bo.

### Per què Google Vuelos cerca per a una persona?

Perquè la seva adreça no admet el nombre de viatgers: es canvia a la mateixa pàgina, a dalt, al costat de «Anada i tornada». El preu de Google Vuelos és per persona.

### I si la meva ciutat no té aeroport?

Escriu-la a «Desde dónde sales» i prem «Buscar aeropuertos cerca de…»: Kokai la situa al mapa i ofereix els aeroports a menys de 150 km.

### Serveix per a vols amb escales o de diverses destinacions?

Cerca d’un aeroport a un altre, d’anada i tornada o només d’anada; les escales les proposa cada web. Els viatges de diverses destinacions, de moment, es cerquen al web.

### Desa el vol que compro?

No, perquè la compra es fa a l’altre web. Afegeix el PDF del bitllet a «Documentos»: es llegeix al dispositiu i es reconeixen 15 aerolínies (Ryanair, Vueling, Iberia, TAP Air Portugal…), i la vigília t’arriba l’avís.

## Fonts i referències

- [Open data @ OurAirports](https://ourairports.com/data/) — OurAirports
- [ourairports-data (Unlicense, domini públic)](https://github.com/davidmegginson/ourairports-data) — David Megginson, a GitHub
- [Referrals: examples (format dels enllaços)](https://developers.skyscanner.net/docs/referrals/examples) — Skyscanner Developers
- [Usage guidelines de les API](https://developers.skyscanner.net/docs/getting-started/usage-guidelines) — Skyscanner Developers
- [Avís del tancament del portal d’autoservei](https://developers.amadeus.com/) — Amadeus for Developers
- [Cercar bitllets d’avió a Google Vols](https://support.google.com/travel/answer/2475306?hl=ca) — Ajuda de Google
- [Codi d’aeroports IATA](https://ca.wikipedia.org/wiki/Codi_d%27aeroports_IATA) — Viquipèdia
- [Política d’ús de Nominatim](https://operations.osmfoundation.org/policies/nominatim/) — Fundació OpenStreetMap