Referenční data a obohacení
Třicet čtyři milionů řádků jako jeden krok
Země, jazyky a měny. 13,4 milionu obydlených míst a zeměpisných objektů. 19 milionů variant názvů. Dva miliony poštovních směrovacích čísel. Letiště, námořní přístavy, značky vozidel. Šedesát pět koncových bodů, bez ověřování, bez ceníku — protože jde o stejnou platformu, na které už váš workflow běží.
Proč je to neobvyklé
V každém jiném automatizačním nástroji je „ověřit tuto adresu“ placená integrace třetí strany. Najdete dodavatele, založíte účet, dohodnete ceník, získáte klíč, uložíte klíč, hlídáte kvótu a při změně objemu znovu vyjednáváte. Samotné vyhledání trvá dvacet milisekund; pořízení trvá čtrnáct dní.
Zde je to krok v nabídce. Jde o veřejná referenční data — GeoNames, oficiální číselníky, zveřejněné registry — očištěná, zaindexovaná a poskytovaná službou castomAPI, která vznikla proto, že tuctet produktů v této rodině potřeboval totéž a postavit to jednou bylo levnější než dvanáckrát.
Vyhledávání je založeno na trigramech s minimem tří znaků, takže částečný nebo překlepnutý název místo přesto najde. Toto minimum je záměrné: dva znaky odpovídají všemu a vyhledávání, které odpovídá všemu, je horší než žádné vyhledávání.
Tři věci, které s tím lidé dělají
Ověřování — zastavte špatná data u dveří. Je to skutečné poštovní směrovací číslo pro toto město? Existuje ten kód země, nebo je to překlep, který někdo udělal v roce 2019 a od té doby se šíří? Je PLN měna — a je to ta, ve které má být tento zákazník účtován?
Normalizace — „Warszawa“, „Varšava“, „Varsovie“ a „Варшава“ jsou jedno místo s jedním identifikátorem. Devatenáct milionů variant názvů existuje proto, aby vaše databáze zákazníků nemusela uchovávat čtyři pravopisy téhož města a vydávat je za čtyři města.
Obohacení — název města se změní na souřadnice, časové pásmo, administrativní region a počet obyvatel. Kód letiště se změní na název a polohu. Poštovní směrovací číslo se změní na vše nad sebou v hierarchii. Šest polí, která by člověk jinak musel vypsat, vyplněných za dvacet milisekund, zdarma.
Časové pásmo je to tiché
Rozřešení místa vám dá jeho časové pásmo — a časové pásmo je to, díky čemuž „odešli to v devět ráno“ znamená devět ráno pro příjemce, nikoli devět ráno pro vás. Tiché hodiny, plány a připomínky se pro mezinárodní seznam stanou správnými, aniž by kdokoli udržoval mapovací tabulku.
- 1Vstup„ul. Powstańców Śląskich 5, 53-332 Wrocław, PL“
- 2Poštovní směrovací číslo odpovídá53-332 → Vratislav, Dolnoslezské, PL.
- 3Místo vyřešeno51.0938 N, 17.0226 E · Europe/Warsaw · počet obyvatel 674 079.
- 4Zapsáno zpětŠest vyplněných polí, která by jinak musel člověk napsat ručně.
- §NákladyDeterministický krok. Žádný klíč, žádná kvóta, žádná platba za vyhledání.
Uplynulý čas: 40 msK dispozici 65 koncových bodů
Třicet čtyři milionů řádků. Jeden krok.
Pracovní příklady
Kde se vyplatí
Než to uvidí dopravce
Adresa zkontrolovaná a normalizovaná před zakoupením přepravního štítku. Odmítnutý štítek stojí poplatek a den; odmítnuté poštovní směrovací číslo stojí dvacet milisekund.
Než to uvidí účetní
Kód měny a kód země ověřené před vystavením faktury, což je výrazně levnější než jejich ověřování po odeslání.
Deduplikace seznamu
Dva záznamy se stejným zákazníkem pod dvěma pravopisy téhož města se správně sloučí, jakmile obě města vedou ke stejnému identifikátoru.
Směrování podle geografie
Souřadnice zákazníka a souřadnice vašich skladů — a běh vybere nejbližší, aniž by kdokoli udržoval tabulku PSČ a skladů.
Jazyk, správně
Země se rozřeší na své jazyky, takže odeslaná zpráva bude v jednom z nich, který příjemce pravděpodobně čte — rozhodnuto daty, nikoli domněnkou o vlajce.
Flotila a logistika
Značky vozidel, letiště a námořní přístavy jako kanonické záznamy — pro workflow, jejichž náplní je něco, co se fyzicky pohybuje.
Poctivé limity
Jde o veřejná referenční data, nikoli o komerční službu ověřování adres. Řekne vám, že 53-332 je skutečné poštovní směrovací číslo ve Vratislavi, a dá vám souřadnice lokality. Neřekne vám, zda byt 212 v čísle 5 existuje, ani zda tam někdo bydlí. Pro ověřování na úrovni doručovacího místa potřebujete produkt národního poštovního operátora — a workflow ho může zavolat přes HTTP vedle tohoto.
Není to ani zdroj osobních údajů. Nejsou v něm žádní lidé. Obsahuje místa, kódy, registry a veřejné fakty — a přesně proto ho lze poskytovat bez ověřování.
K aktuálnosti: referenční data se mění pomalu a tato se obnovují podle plánu, nikoli průběžně. Nově přejmenovaná vesnice se neobjeví hned odpoledne. Pro cokoli, co se mění po hodinách, použijte raději kanál událostí, který je pro přesně tohle postaven.