Dane referencyjne i wzbogacanie
34 miliony rekordów,jako krok.
Kraje, języki i waluty. 13,4 miliona miejscowości i obiektów geograficznych. 19 milionów wariantów nazw. Dwa miliony kodów pocztowych. Lotniska, porty morskie, marki pojazdów. Sześćdziesiąt pięć endpointów, bez uwierzytelniania i bez cennika, bo to ta sama platforma, na której już działa Twój proces.
Dlaczego to nietypowe.
W każdym innym narzędziu do automatyzacji „sprawdź ten adres” to płatna integracja z podmiotem trzecim. Znajdujesz dostawcę, zakładasz konto, uzgadniasz cennik, zdobywasz klucz, przechowujesz klucz, pilnujesz limitu i renegocjujesz, gdy zmienia się wolumen. Samo zapytanie trwa dwadzieścia milisekund; formalności trwają dwa tygodnie.
Tutaj to krok na liście. Dane to publiczne dane referencyjne — GeoNames, oficjalne wykazy kodów, jawne rejestry — oczyszczone, zindeksowane i podawane przez castomAPI, które powstało, bo kilkanaście produktów w tej rodzinie potrzebowało tego samego, a zbudowanie tego raz było tańsze niż dwanaście razy.
Wyszukiwanie działa na trigramach, od trzech znaków, więc częściowa albo przekręcona nazwa i tak trafia w miejsce. To minimum jest celowe: dwa znaki pasują do wszystkiego, a wyszukiwanie pasujące do wszystkiego jest gorsze niż jego brak.
Trzy rzeczy,
do których się tego używa.
Sprawdzanie — zatrzymanie złych danych przy drzwiach. Czy to prawdziwy kod pocztowy dla tego miasta? Czy ten kod kraju istnieje, czy jest literówką z 2019 roku, która od tamtej pory się rozmnaża? Czy PLN to waluta i czy to ta, w której należy obciążyć tego klienta?
Normalizowanie — „Warsaw”, „Warszawa”, „Varsovie” i „Варшава” to jedno miejsce z jednym identyfikatorem. Dziewiętnaście milionów wariantów nazw istnieje po to, żeby Twoja baza klientów nie musiała trzymać czterech pisowni tego samego miasta i udawać, że to cztery miasta.
Wzbogacanie — nazwa miasta staje się współrzędnymi, strefą czasową, jednostką administracyjną i liczbą mieszkańców. Kod lotniska staje się nazwą i lokalizacją. Kod pocztowy — wszystkim, co nad nim w hierarchii. Sześć pól, które inaczej ktoś by wpisał, uzupełnionych w dwadzieścia milisekund, za darmo.
Strefa czasowa to ta cicha.
Rozpoznanie miejsca daje jego strefę czasową, a strefa czasowa sprawia, że „wyślij o dziewiątej rano” znaczy dziewiąta rano u odbiorcy, a nie u Ciebie. Godziny ciszy, harmonogramy i przypomnienia stają się poprawne dla listy międzynarodowej bez utrzymywania przez kogokolwiek tabeli przypisań.
- 1Wejście„ul. Powstańców Śląskich 5, 53-332 Wrocław, PL”
- 2Kod pocztowy dopasowany53-332 → Wrocław, dolnośląskie, PL.
- 3Miejsce rozpoznane51,0938 N, 17,0226 E · Europe/Warsaw · 674 079 mieszkańców.
- 4ZapisaneSześć pól, które inaczej ktoś musiałby wpisać ręcznie.
- §KosztKrok deterministyczny. Bez klucza, bez limitu, bez opłaty za zapytanie.
Czas: 40 ms65 dostępnych endpointów
34 miliony rekordów.
Jeden krok.
Przykłady z praktyki
Gdzie to zarabia na siebie.
Zanim zobaczy to kurier
Adres sprawdzony i znormalizowany, zanim kupisz etykietę. Odrzucona etykieta kosztuje opłatę i dzień; odrzucony kod pocztowy kosztuje dwadzieścia milisekund.
Zanim zobaczy to księgowa
Kod waluty i kod kraju sprawdzone przed wystawieniem faktury, co jest znacznie tańsze niż sprawdzenie ich po jej wysłaniu.
Odchudzanie bazy
Dwa rekordy tego samego klienta z dwiema pisowniami miasta scalają się porządnie, gdy oba miasta rozwiązują się do tego samego identyfikatora.
Kierowanie po geografii
Współrzędne klienta i współrzędne magazynów — a przebieg sam wybiera najbliższy, bez utrzymywania przez kogokolwiek arkusza „kod pocztowy → magazyn”.
Język, poprawnie
Kraj rozwiązuje się do swoich języków, więc wiadomość wychodzi w takim, który odbiorca prawdopodobnie czyta — na podstawie danych, a nie założenia zrobionego po fladze.
Flota i logistyka
Marki pojazdów, lotniska i porty jako rekordy kanoniczne — dla procesów, w których coś fizycznie się przemieszcza.
Uczciwe ograniczenia.
To są publiczne dane referencyjne, a nie komercyjna usługa weryfikacji adresów. Powiedzą Ci, że 53-332 to prawdziwy kod pocztowy we Wrocławiu, i podadzą współrzędne miejscowości. Nie powiedzą, czy pod numerem 5 istnieje lokal 212 ani czy ktoś tam mieszka. Do weryfikacji na poziomie punktu doręczenia potrzebujesz produktu operatora pocztowego — a proces może wywołać go po HTTP obok tego.
To także nie jest źródło danych osobowych. Nie ma w nim ludzi. Są miejsca, kody, rejestry i fakty publiczne — i właśnie dlatego można je podawać bez uwierzytelniania.
O świeżości: dane referencyjne zmieniają się powoli i są odświeżane cyklicznie, a nie na bieżąco. Świeżo przemianowana wieś nie pojawi się tego samego popołudnia. Do wszystkiego, co zmienia się co godzinę, służy strumień wydarzeń, zbudowany dokładnie do tego.