Quines confirmacions de reserva en PDF llegeix Kokai i com

Com funciona: text, no imatge

Una confirmació de reserva en PDF gairebé sempre porta text de veritat a dins: el que pots seleccionar i copiar. Kokai el treu amb pdf.js, la biblioteca de Mozilla (llicència Apache-2.0) que fa servir Firefox per mostrar els PDF, i només la carrega quan afegeixes un PDF. Tot passa al dispositiu:

1. Si el fitxer passa de 20 MB, es desa sense llegir.
2. pdf.js treu el text de les 6 primeres pàgines: les confirmacions diuen el que és important al començament, i vint pàgines de condicions no hi afegeixen res.
3. Kokai reconstrueix les línies: pdf.js dona trossos de text amb la seva posició, i una línia s’acaba quan el tros següent baixa més de mitja alçada de lletra.
4. El text es passa a minúscules i sense accents per buscar etiquetes («Número de confirmación» i «numero de confirmacion» són el mateix), però el que es troba es retalla de l’original, i així el localitzador surt amb les seves majúscules.
5. Es decideix què és i de qui és, i es busquen les dades per les seves etiquetes. No hi ha plantilles per proveïdor, que canvien cada pocs mesos.
6. Si no es reconeix la classe i surten menys de dues dades, es dona per no llegit: «No he encontrado los datos de una reserva en el PDF. Rellénalos a mano.» («No he trobat les dades d’una reserva al PDF. Omple-les a mà.»)

No hi ha reconeixement de lletres en imatges (OCR). Una foto del bitllet, una captura de pantalla o un PDF escanejat es desen i s’obren sense connexió, però no es llegeixen. Un PDF protegit amb contrasenya, tampoc.

On es llegeix un PDF a l’app

A Documents, mentre llegeix, l’app diu «Leyendo el PDF en este dispositivo…» («Llegint el PDF en aquest dispositiu…»); a Allotjament, «Leyendo el PDF…». El que ha entès surt en una línia que comença per «Leído en este dispositivo:» («Llegit en aquest dispositiu:»). Més sobre els documents a Documents de viatge sense connexió.

Les 8 classes de reserva

Cada classe decideix el tipus de document, l’etiqueta que s’hi posa i quines etiquetes es busquen per a les dates. Per reconèixer-la compten paraules típiques, cadascuna una sola vegada encara que es repeteixi:

Les 65 marques que reconeix

Una marca reconeguda posa la seva etiqueta al document («Booking.com», «Renfe») i pesa molt a l’hora de decidir la classe. Si la teva no hi és, la reserva es pot llegir igualment per les seves paraules i les seves etiquetes: només hi faltarà l’etiqueta del proveïdor.

Algunes marques només compten amb la forma completa, perquè el seu nom sol és una paraula corrent: «Booking.com» o «Booking B.V.» (booking vol dir «reserva» en anglès), «Italo Treno», «Enterprise Rent-A-Car», «Avis Budget» o «alsa.es». El nom sol («booking», «alsa», «avis») és una menció feble.

Com decideix què és i de qui és

La classe i el proveïdor surten d’un recompte de punts, el mateix per a tots els PDF:

• La puntuació d’una classe és la de les seves paraules més la de la seva millor marca.
• Guanya la classe amb més punts, i només si en té almenys 4: n’hi ha prou amb dues paraules típiques (un hotel sense plataforma es reconeix com a allotjament), però no amb un «hotel» sol.
• El proveïdor s’indica si la seva marca, d’aquella classe, té almenys 5 punts: hi ha de sortir el nom complet, o l’ha de portar el nom del fitxer. Tres mencions febles sumen 3 i no n’hi ha prou.

Quines dades treu

El títol es compon segons la classe: el nom de l’hotel (o «Alojamiento de Booking.com» si no hi surt), «Vuelo» amb el seu número, o la classe i el proveïdor («Tren · Renfe»).

Les etiquetes que reconeix, idioma per idioma

Es busquen sense distingir majúscules ni accents. Un guió vol dir que aquell idioma no té una forma pròpia a la llista (sovint coincideix amb un altre: el català «número de reserva» és la forma castellana).

A més, el preu es busca en últim lloc després de la paraula sola en qualsevol dels set idiomes: precio, price, importe, amount, montant, prix, prezzo, preço, preu.

Dates i hores

• Les abreviatures que també són paraules (out, des, set, gen, mag, lug, ott, mai, mar) només compten com a mes si porten l’any al darrere: «3 out of 5 guests» no és el 3 d’octubre.
• En una taula amb «Check-in Check-out» en una línia i les dues dates a sota, la primera data després de «Check-out» és la d’entrada, i se la salta.
• Si no hi ha etiqueta, es fa servir la primera data que no vagi després de «fecha de reserva», «emitido», «booked on», «fecha de nacimiento» o «caduca». En una assegurança, no s’endevina.
• Un allotjament amb «3 noches» i sense data de sortida llegible: la sortida es calcula sumant les nits a l’entrada.
• Una data de final a més de 62 dies de l’inici es descarta: és una altra data que s’ha colat.
• Hores: 15:00, 15h00, 3:00 PM o 3 PM. A l’hora d’inici guanya la que va amb «desde», «from» o «a partir de»; a la sortida d’un allotjament, l’última amb «hasta», «until» o «before»: «de 07:00 a 11:00» és sortida fins a les 11:00.

Preu i moneda

La moneda surt del símbol o del codi que hi ha al costat de l’import, davant o darrere («€ 390,00», «390,00 EUR»), o del codi entre parèntesis després de «Total (EUR)». Reconeix 37 codis ISO 4217:

EUR USD GBP JPY CHF CAD AUD MXN ARS COP CLP PEN BRL DKK SEK NOK PLN CZK HUF
RON BGN TRY MAD THB CNY HKD SGD NZD ZAR INR KRW ISK IDR VND EGP AED ILS

Els separadors s’interpreten com a cada país: 1.234,56 i 1,234.56 són el mateix, 1 234,56 també, «1.234» són mil dos-cents trenta-quatre i «12,50» són dotze amb cinquanta.

Un «$» sol es llegeix sempre com a dòlar dels Estats Units, i un «¥», com a ien. Si reserves en pesos mexicans o en iuans i el PDF només posa el símbol, corregeix la moneda a l’estada. Si no hi ha moneda, l’estada agafa la del viatge.

Què fa amb el que llegeix

La regla és una de sola: mai no trepitja el que algú ha escrit.

• En un document nou, si canvies el tipus o el títol mentre es llegeix, es queda el teu. Si canvies el tipus que s’ha llegit (una «Reserva» que passes a «Entrada»), no s’hi posen les etiquetes de la lectura.
• En un document que ja existeix, només s’omplen el localitzador, el titular i les dates si són buits, i el tipus només si era «Otro» («Altre»). Si el tipus llegit és diferent, la fitxa ofereix «Cambiar el tipo a…» («Canviar el tipus a…») sense canviar-lo.
• S’hi afegeixen dues etiquetes, la del proveïdor i la de la classe («Booking.com» i «Alojamiento»), sense treure les que ja tenia.

Si és un allotjament amb entrada i sortida, i el document és una reserva, s’associa a una estada, les nits d’aquell hotel en el viatge:

1. Si ja hi ha una estada enllaçada a aquest document, es completa (hores, preu, cancel·lació) sense tocar el que ja tingui.
2. Si no, es busca l’hotel: el lloc relacionat del document o un allotjament del mapa amb el mateix nom (almenys el 60 % de les paraules en comú, sense comptar «hotel», «apartamento», «de» o «the»).
3. Si aquell hotel té una opció sense document enllaçat que coincideix amb aquestes nits, passa a reservada, amb el document enllaçat i les dates del PDF.
4. Si l’hotel no és al mapa, la seva adreça va a Nominatim (el cercador d’OpenStreetMap), o el seu nom dins de la zona de la destinació. Si ja tens un allotjament a menys de 150 m del que s’ha trobat, és aquest; si no, es crea el lloc amb la seva adreça i el seu telèfon, i se’n busquen les fotos.
5. Si no hi havia cap opció, es crea una estada reservada nova, en aquell lloc si s’ha trobat. Sense xarxa, o si Nominatim no troba res, queda sense situar, amb el seu nom, i se situa després a mà.

Amb l’estada arriben els recordatoris de l’allotjament: cancel·lar gratis, «Mañana duermes en…» («Demà dorms a…») i «Hoy dejas…» («Avui deixes…»); la taula completa és a Documents. Si un document de reserva té dates però no s’ha associat, la seva fitxa ofereix «Es un alojamiento: añadir estas noches» («És un allotjament: afegir aquestes nits»).

Nominatim només rep el text de l’adreça (o el nom de l’hotel i la zona), amb un mínim d’1,1 segons entre peticions, com demana la seva política d’ús. Mai el localitzador, el titular ni el preu.

Exemple: una confirmació de Booking.com per a Lisboa

Limitacions

• Fotos i escanejats, no. Només es llegeix text; no hi ha OCR.
• Provat amb textos d’exemple, no amb confirmacions reals de cada proveïdor. Les proves imiten el que pdf.js treu de Booking.com (en castellà i en anglès, amb taula), Airbnb (en tots dos idiomes), un hotel sense plataforma, Ryanair, Renfe i Europcar, i un PDF generat es llegeix de principi a fi. Amb cadascuna de les 65 marques, no s’ha provat.
• Un PDF amb el text desordenat (columnes que pdf.js lliura en un altre ordre) pot deixar les etiquetes lluny dels seus valors, i la dada no surt.
• Només un bitllet per document. Un PDF d’anada i tornada dona la data d’anada i la de tornada, però no dos documents, ni escales.
• Només el primer PDF quan tries diversos fitxers alhora en crear un document.
• Tot el que es llegeix es pot corregir. Mira sempre la fitxa: l’app t’ho demana amb «Revisa que esté bien.»

Si la teva reserva no s’ha llegit bé

Corregeix les dades a mà a la fitxa: es desen soles i la lectura no les torna a trepitjar. I si vols que la versió següent la llegeixi millor, explica-ho al formulari de contacte amb el motiu «Una reserva en PDF que no s’ha llegit bé». Ajuda dir:

• El proveïdor i l’idioma de la confirmació.
• Quina dada ha fallat (la data de sortida, el preu, el nom de l’hotel) i què posava el PDF al costat d’aquesta dada, amb l’etiqueta tal com era.
• Si el PDF és un correu imprès, una descàrrega del web del proveïdor o una targeta d’embarcament.

No enganxis localitzadors, noms, adreces ni números de targeta reals: canvia’ls per dades inventades abans d’enviar-ho («XXXX1234», «Ana Ejemplo»). El formulari no admet adjunts, i no cal el PDF: n’hi ha prou amb les línies que fallen.

Preguntes freqüents

Fonts i referències

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

1. PDF.js Mozilla
2. Repositori de PDF.js (codi i llicència Apache-2.0) Mozilla, a GitHub
3. ISO 4217, codis de moneda (agència de manteniment) SIX Group
4. Nominatim Usage Policy OpenStreetMap Foundation
5. Nominatim: Search API Nominatim

Continua llegint

• DocumentsCom desa Kokai bitllets, reserves i passaport amb el PDF o la foto per obrir-los sense xarxa, què t’avisa abans que caduquin i què no surt del dispositiu.
• AllotjamentCom Kokai organitza l’allotjament per nits: reserves, opcions per comparar, nits sense cobrir, reserves dobles, avisos de cancel·lació i l’adreça sense xarxa.
• Cercar allotjamentCom cercar hotel amb dates a Booking.com, Airbnb, Expedia, Vrbo, Agoda, Trip.com, Kayak i Google Hoteles amb un enllaç: destinació, dates, viatgers i exemples.
• GlossariQuè és una geotanca, una estada, un localitzador, la histèresi del GPS o un PMTiles: 35 termes de viatges i mapes, amb les xifres que fa servir Kokai.