Referentsandmed ja rikastamine
Kolmkümmend neli miljonit rida, ühe sammuna
Riigid, keeled ja valuutad. 13,4 miljonit asustatud kohta ja geograafilist objekti. 19 miljonit nimevarianti. Kaks miljonit postikohta. Lennujaamad, sadamad, automargid. Kuuskümmend viis lõpp-punkti, ilma autentimiseta, ilma hinnakirjata, sest tegemist on sama platvormiga, kus sinu töövoog juba töötab.
Miks see on erandlik
Kõigis teistes automatiseerimisvahendites on „kontrolli seda aadressi“ tasuline kolmanda osapoole integratsioon. Otsid müüja üles, avad konto, lepitud kokku hinnakirja, hankid võtme, hoiad võtme, jälgid kvooti ja otsid uuesti läbi, kui sinu maht muutub. Otsing ise võtab kakskümmend millisekundit; hankimine kaks nädalat.
Siin on üks samm valijas. Andmed on avalikud võrdlusandmed — GeoNames, ametlikud koodiloendid, avaldatud registrid — mis on puhastatud, indekseeritud ja serveeritud teenuse castomAPI poolt, mis on olemas seepärast, et tosin toodet selles perekonnas vajas sama asja ja ühe korra ehitamine oli odavam kui kaksteist korda ehitamine.
Otsing põhineb trigrammidel ja nõuab vähemalt kolme tähemärki, nii et poolik või valesti kirjutatud nimi leiab koha ikkagi üles. See miinimum on tahtlik: kaks tähemärki sobituvad kõigega, ja otsing, mis sobitub kõigega, on halvem kui otsingu puudumine.
Kolm asja, mida sellega tehakse
Kinnita — peata halb andmed juba ukse juures. Kas see on tõeline sihtnumber sellele linnale? Kas see riigikood eksisteerib, või on see kirjaviga, kelle keegi 2019. aastal tegi ja mis on sellest ajast levinud? Kas PLN on valuuta, ja kas just see on see, milles see klient tuleks tasu võtta?
Normaliseeri — „Warsaw”, „Warszawa”, „Varsovie” ja „Варшава” on üks koht ühe identifikaatoriga. Olemas on üheksateist miljonit nimevarianti, et sinu kliendiandmebaas ei peaks hoidma sama linna nelja kirjaviisi ja esitama neid nelja linnana.
Rikasta — linnanimest saavad koordinaadid, ajavöönd, halduspiirkond ja elanike arv. Lennujaamakoodist saab nimi ja asukoht. Sihtnumbrist saab kõik, mis hierarhias selle kohal on. Kuus välja, mida inimene muidu oleks käsitsi kirjutanud, täidetakse kakskümmend millisekundiga, tasuta.
Ajavöönd on see vaikne osa
Koha lahendamisel saad ka selle ajavööndi, ja just ajavöönd teeb „saada see hommikul kell üheksa” tähenduslikuks — kell üheksa hommikul saaja jaoks, mitte sinu jaoks. Vaiksed tunnid, ajakavad ja meeldetuletused muutuvad rahvusvahelise loendi jaoks õigeteks ilma et keegi peaks vastendustabelit hoidma.
- 1Sisend„ul. Powstańców Śląskich 5, 53-332 Wrocław, PL”
- 2Postikood sobitus53-332 → Wrocław, Dolnośląskie, PL.
- 3Koht tuvastatud51.0938 N, 17.0226 E · Europe/Warsaw · elanikke 674 079.
- 4Kirjutatakse tagasiKuus välja täidetud, mida muidu oleks inimene käsitsi sisestanud.
- §MaksumusDeterministlik samm. Võtmet pole, kvooti pole, otsingutasu pole.
Kulunud: 40 ms65 lõpp-punkti saadaval
Kolmkümmend neli miljonit rida. Üks samm.
Töönäited
Kus see oma koha ära teenib
Enne kui vedaja seda näeb
Aadress kontrollitakse ja normaliseeritakse enne saatismärgi ostmist. Tagasi lükatud saatis maksab tasu ja päeva; tagasi lükatud sihtnumber maksab kakskümmend millisekundit.
Enne kui raamatupidaja seda näeb
Valuutakood ja riigikood kinnitatakse enne arve esitamist, mis on tunduvalt odavam kui nende kinnitamine pärast saatmist.
Loendi dedubleerimine
Kaks kirjet sama kliendiga kahe kirjaviisiga samast linnast liidetakse korralikult kokku, kui mõlemad linnad lahenevad samaks identifikaatoriks.
Suunamine geograafia järgi
Kliendi koordinaadid ja sinu ladude koordinaadid, ja käik valib lähima ilma et keegi peaks sihtnumbrite-ladude arvutustabelit hoidma.
Keel, õigesti
Riik laheneb oma keeltele, nii et väljaminev sõnum on ühes, mida saaja tõenäoliselt loeb — otsustatakse andmete põhjal, mitte lipu kohta tehtud eelduse põhjal.
Laevastik ja logistika
Sõidukite margid, lennujaamad ja meresadamad kanooniliste kirjetena, nende töövoogude jaoks, kus midagi füüsiliselt liigub.
Ausad piirid
See on avalik võrdlusandmestik, mitte kommertslik aadressi kinnitamise teenus. See ütleb sulle, et 53-332 on tõeline sihtnumber Wrocławis, ja annab asula koordinaadid. See ei ütle, kas korter 212 numbris 5 eksisteerib, ega kas keegi seal elab. Tarnepunkti tasemel kinnitamiseks vajad riikliku postiettevõtte toodet, ja töövoog saab seda HTTP kaudu selle kõrval välja kutsuda.
See ei ole ka isikuandmete allikas. Inimesi seal pole. See sisaldab kohti, koode, registreid ja avalikke fakte — ja just seepärast saab seda serveerida autentimiseta.
Värskuse kohta: võrdlusandmed muutuvad aeglaselt, ja neid värskendatakse ajakava järgi, mitte pidevalt. Äsja ümber nimetatud küla ei ilmu samal pärastlõunal. Kõige kohta, mis muutub tunni kaupa, on sul vaja hoopis sündmuste voogu, mis on just selleks ehitatud.