Referansedata og berikjing
Trettifire millionar rader, som eit steg
Land, språk og valutaer. 13,4 millionar busette stader og geografiske førekomstar. 19 millionar namnevariantar. To millionar postnummer. Flyplassar, hamner, bilmerke. Sekstifem endepunkt, ingen autentisering, ingen prisliste, fordi det er same plattforma arbeidsflyten din alt køyrer på.
Kvifor dette er uvanleg
I alle andre automatiseringsverktøy er «valider denne adressa» ei betalt tredjepartsintegrasjon. Du finn ein leverandør, opnar ein konto, avtalar ei prisliste, skaffar ein nøkkel, lagrar nøkkelen, held auge med kvota, og forhandlar på nytt når volumet ditt endrar seg. Oppslaget sjølv tek tjue millisekund; innkjøpet tek ei veke eller to.
Her er det eit steg i veljaren. Dataa er offentlege referansedata — GeoNames, offisielle kodelister, publiserte register — reinsa, indekserte og servert av castomAPI, som finst fordi eit dusin produkt i denne familien trengde det same, og å byggja det éin gong var billegare enn å byggja det tolv gonger.
Søket er trigrambasert med eit minimum på tre teikn, så eit delvis eller feilstava namn finn framleis staden. Det minimumet er med vilje: to teikn treff alt, og eit oppslag som treff alt er verre enn ingen oppslag.
Dei tre tinga folk gjer med det
Valider — stopp dårlege data ved døra. Er det eit ekte postnummer for den byen? Finst den landskoden, eller er det ein skrivefeil nokon gjorde i 2019 som har halde fram å spreia seg sidan? Er PLN ei valuta, og er det den kunden skal fakturerast i?
Normaliser — «Warsaw», «Warszawa», «Varsovie» og «Варшава» er éin stad med éin identifikator. Nitten millionar namnevariantar finst slik at kundedatabasen din slepp å lagra fire staveformer av same byen og late som dei er fire byar.
Berik — eit bynamn blir koordinatar, ei tidssone, eit administrativt område og eit folketal. Ein flyplasskode blir eit namn og ein plassering. Eit postnummer blir alt over seg i hierarkiet. Seks felt som ein person elles ville ha skrive inn, fylt ut på tjue millisekund, utan kostnad.
Tidssona er den stille
Når du slår opp ein stad, får du tidssona, og ei tidssone er det som gjer at «send dette klokka ni om morgonen» betyr ni om morgonen for mottakaren og ikkje ni om morgonen for deg. Stille timar, timeplanar og påminningar blir alle rette for ei internasjonal liste utan at nokon vedlikeheld ei oversiktstabell.
- 1Inndata«ul. Powstańców Śląskich 5, 53-332 Wrocław, PL»
- 2Postnummer samsvara53-332 → Wrocław, Dolnośląskie, PL.
- 3Stad løyst opp51,0938 N, 17,0226 E · Europe/Warsaw · folketal 674 079.
- 4Skrevne tilbakeSeks felt fylt ut som ein person elles hadde måtta skriva inn.
- §KostnadDeterministisk steg. Ingen nøkkel, ingen kvota, ingen kostnad per oppslag.
Forløpt: 40 ms65 endepunkt tilgjengelege
Trettitre millionar rader. Eitt steg.
Utregna døme
Kvar det tenar plassen sin
Før transportøren ser det
Ein adresse kontrollert og normalisert før fraktetiketten blir kjøpt. Ein avvist etikett kostar eit gebyr og ein dag; eit avvist postnummer kostar tjue millisekund.
Før revisoren ser det
Ein valutakode og ein landskode validert før ein faktura blir oppretta, noko som er vesentleg billegare enn å validere dei etter at ho er sendt.
Fjerna duplikat frå ei liste
To postar med same kunden under to staveformer av same byen blir slått saman skikkeleg når begge byane løysast til same identifikator.
Ruting etter geografi
Koordinatar for ein kunde og koordinatar for lagera dine, og køyret vel det næraste utan at nokon vedlikeheld eit rekneark frå postnummer til lager.
Språk, rett
Eit land løysast til språka sine, så meldinga som går ut er på eit mottakaren truleg les — bestemt av data i staden for ei antaking om eit flagg.
Flåte og logistikk
Bilmerke, flyplassar og hamner som kanoniske postar, for arbeidsflytane der jobben inneber noko som fysisk flyttar seg.
Dei ærlege grensene
Dette er offentlege referansedata, ikkje ei kommersiell adresseverifiseringsteneste. Den seier deg at 53-332 er eit ekte postnummer i Wrocław og gjev deg koordinatane til staden. Ho seier deg ikkje om leilegheit 212 finst i nummer 5, eller om nokon bur der. For verifisering på leveringspunktnivå vil du ha eit produkt frå ein nasjonal postoperatør, og ein arbeidsflyt kan kalla ein over HTTP ved sida av dette.
Det er heller ikkje ei kjelde til persondata. Det finst ingen menneske i det. Det inneheld stader, koder, register og offentlege fakta — noko som er akkurat kvifor det kan serverast utan autentisering.
Om ferskhe: referansedata endrar seg sakte, og dette blir oppdatert etter ein timeplan i staden for kontinuerleg. Ein nyleg omdøypt landsby dukkar ikkje opp same ettermiddagen. For alt som endrar seg frå time til time vil du ha hendingsstraumen i staden, som er bygd for akkurat det.