Dades de referència i enriquiment
Trenta-quatre milions de files, com a pas
Països, idiomes i monedes. 13,4 milions de poblacions i elements geogràfics habitats. 19 milions de variants de noms. Dos milions de codis postals. Aeroports, ports marítims, marques de vehicles. Seixanta-cinc endpoints, sense autenticació, sense tarifa, perquè és la mateixa plataforma on ja s'executa el teu flux de treball.
Per què això és excepcional
A totes les altres eines d'automatització, «valida aquesta adreça» és una integració de terç de pagament. Has de trobar un proveïdor, obrir un compte, acordar una tarifa, obtenir una clau, emmagatzemar-la, vigilar la quota i renegociar quan canvia el teu volum. La consulta en si triga vint mil·lisegons; la contractació, quinze dies.
Aquí és un pas del selector. Les dades són dades de referència públiques — GeoNames, llistes de codis oficials, registres publicats — netejades, indexades i servides per castomAPI, que existeix perquè una dotzena de productes d'aquesta família necessitaven el mateix i construir-ho una vegada era més barat que construir-ho dotze.
La cerca es basa en trigrames amb un mínim de tres caràcters, de manera que un nom parcial o mal escrit encara troba el lloc. Aquest mínim és deliberat: dos caràcters coincideixen amb tot, i una cerca que coincideix amb tot és pitjor que cap cerca.
Les tres coses que la gent hi fa
Valida — atura les dades dolentes a la porta. És un codi postal real d'aquella ciutat? Existeix aquest codi de país, o és una errata que algú va fer el 2019 i que s'ha estat propagant des de llavors? PLN és una moneda, i és la que s'ha de cobrar a aquest client?
Normalitza — «Warsaw», «Warszawa», «Varsovie» i «Варшава» són un sol lloc amb un sol identificador. Existeixen dinou milions de variants de nom perquè la teva base de dades de clients no hagi de guardar quatre grafies de la mateixa ciutat i fer com si fossin quatre ciutats.
Enriqueix — un nom de ciutat es converteix en coordenades, un fus horari, una regió administrativa i una xifra de població. Un codi d'aeroport es converteix en un nom i una ubicació. Un codi postal es converteix en tot el que hi ha per sobre seu a la jerarquia. Sis camps que una persona hauria d'haver escrit, omplerts en vint mil·lisegons, de franc.
El fus horari és el discret
Resoldre un lloc et dona el seu fus horari, i un fus horari és el que fa que «envia això a les nou del matí» signifiqui les nou del matí per al destinatari i no les nou del matí per a tu. Les hores de silenci, els horaris i els recordatoris esdevenen correctes per a una llista internacional sense que ningú hagi de mantenir una taula de correspondències.
- 1Entrada«ul. Powstańców Śląskich 5, 53-332 Wrocław, PL»
- 2Codi postal coincident53-332 → Wrocław, Dolnośląskie, PL.
- 3Lloc resolt51.0938 N, 17.0226 E · Europe/Warsaw · població 674 079.
- 4S'ha escrit de tornadaSis camps emplenats que una persona hauria hagut d'escriure.
- §CostPas determinista. Sense clau, sense quota, sense càrrec per consulta.
Temps transcorregut: 40 ms65 punts finals disponibles
Trenta-quatre milions de files. Un sol pas.
Exemples pràctics
On guanya el seu lloc
Abans que el transportista el vegi
Una adreça comprovada i normalitzada abans de comprar l'etiqueta d'enviament. Una etiqueta rebutjada costa una taxa i un dia; un codi postal rebutjat costa vint mil·lisegons.
Abans que el comptable el vegi
Un codi de moneda i un codi de país validats abans d'emetre una factura, que és considerablement més barat que validar-los després d'haver-la enviat.
Deduplicar una llista
Dos registres amb el mateix client sota dues grafies de la mateixa ciutat es fusionen correctament un cop ambdues ciutats es resolen al mateix identificador.
Encaminar per geografia
Coordenades d'un client i coordenades dels teus magatzems, i l'execució tria el més proper sense que ningú hagi de mantenir un full de càlcul de codis postals a magatzem.
L'idioma, correctament
Un país es resol als seus idiomes, de manera que el missatge que s'envia està en un que el destinatari probablement llegeix — decidit per dades i no per una suposició sobre una bandera.
Flota i logística
Marques de vehicles, aeroports i ports marítims com a registres canònics, per als fluxos de treball la feina dels quals implica que alguna cosa es mogui físicament.
Els límits honestos
Això són dades de referència públiques, no un servei comercial de verificació d'adreces. Et dirà que 53-332 és un codi postal real de Wrocław i et donarà les coordenades de la localitat. No et dirà si existeix el pis 212 al número 5, ni si hi viu algú. Per a una verificació a nivell de punt de lliurament necessites el producte d'un operador postal nacional, i un flux de treball en pot cridar un per HTTP al costat d'aquest.
Tampoc no és una font de dades personals. No hi ha persones. Conté llocs, codis, registres i fets públics — que és exactament per què es pot servir sense autenticació.
Sobre l'actualitat: les dades de referència canvien lentament, i aquestes es refresquen segons un calendari i no contínuament. Un poble acabat de reanomenar no apareixerà la mateixa tarda. Per a qualsevol cosa que canviï cada hora necessites el fil d'esdeveniments, que està fet exactament per a això.