Довідкові дані та збагачення
Тридцять чотири мільйони рядків — як крок
Країни, мови та валюти. 13,4 мільйона населених пунктів і географічних об'єктів. 19 мільйонів варіантів назв. Два мільйони поштових індексів. Аеропорти, морські порти, марки автомобілів. Шістдесят п'ять ендпоінтів, без автентифікації, без тарифікації, бо це та сама платформа, на якій уже працює ваш робочий процес.
Чому це незвично
У будь-якому іншому інструменті автоматизації «перевірити цю адресу» — це платна стороння інтеграція. Ви шукаєте постачальника, відкриваєте акаунт, погоджуєте тарифи, отримуєте ключ, зберігаєте ключ, стежите за квотою і переговорюєте умови, коли змінюються ваші обсяги. Сам запит займає двадцять мілісекунд; закупівля — два тижні.
Тут це крок у списку. Дані — це публічні довідкові дані — GeoNames, офіційні кодові списки, опубліковані реєстри — очищені, проіндексовані та надані castomAPI, який з'явився тому, що десяток продуктів цієї родини потребували одного й того ж, а побудувати це один раз було дешевше, ніж дванадцять разів.
Пошук працює на основі триграм із мінімумом у три символи, тому навіть часткова назва або назва з одруківкою все одно знаходить місце. Цей мінімум — навмисний: два символи збігаються з усім, а пошук, що збігається з усім, гірший за відсутність пошуку.
Три речі, які з ним роблять
Валідація — зупинити погані дані на вході. Чи це справжній поштовий індекс для цього міста? Чи існує такий код країни, чи це одруківка, яку хтось зробив у 2019 році й яка з тих пір поширюється? Чи PLN — це валюта, і чи та, в якій слід стягувати плату з цього клієнта?
Нормалізація — «Warsaw», «Warszawa», «Varsovie» і «Варшава» — це одне місце з одним ідентифікатором. Дев'ятнадцять мільйонів варіантів назв існують саме для того, щоб вашій базі клієнтів не доводилося зберігати чотири написи одного міста й вдавати, що це чотири міста.
Збагачення — назва міста перетворюється на координати, часовий пояс, адміністративний регіон і чисельність населення. Код аеропорту — на назву та розташування. Поштовий індекс — на все, що стоїть вище за нього в ієрархії. Шість полів, які людині довелося б вводити вручну, заповнюються за двадцять мілісекунд, задарма.
Часовий пояс — найнепомітніша перевага
Визначивши місце, ви отримуєте його часовий пояс, а саме часовий пояс робить фразу «надіслати о дев'ятій ранку» такою, що означає дев'яту ранку для одержувача, а не дев'яту ранку для вас. Тиші години, розклади та нагадування стають правильними для міжнародного списку без того, щоб хтось підтримував таблицю відповідності.
- 1Вхідні дані«ul. Powstańców Śląskich 5, 53-332 Wrocław, PL»
- 2Поштовий індекс збігся53-332 → Вроцлав, Нижньосілезьке воєводство, PL.
- 3Населений пункт визначено51.0938 N, 17.0226 E · Europe/Warsaw · населення 674 079.
- 4Записано назадШість полів заповнено, які інакше довелося б вводити людині.
- §ВартістьДетермінований крок. Без ключа, без квот, без плати за кожен запит.
Минуло: 40 мс65 доступних ендпоінтів
Тридцять чотири мільйони рядків. Один крок.
Практичні приклади
Де він доводить свою цінність
До того, як це побачить перевізник
Адреса перевірена та нормалізована до купівлі транспортної етикетки. Відхилена етикетка коштує плату й день; відхилений поштовий індекс коштує двадцять мілісекунд.
До того, як це побачить бухгалтер
Код валюти та код країни перевірені до виставлення рахунку, що значно дешевше, ніж перевіряти їх після надсилання.
Дедублікація списку
Два записи з одним клієнтом у двох написах одного міста коректно об'єднуються, щойно обидва міста визначаються як той самий ідентифікатор.
Маршрутизація за географією
Координати клієнта та координати ваших складів, і маршрут обирає найближчий без того, щоб хтось підтримував таблицю «індекс — склад».
Мова, і саме та
Країна визначається до своїх мов, тож надіслане повідомлення буде тією мовою, якою одержувач, найімовірніше, володіє — за даними, а не за припущенням про прапорець.
Автопарк і логістика
Марки транспортних засобів, аеропорти та морські порти як канонічні записи — для процесів, робота яких пов'язана з фізичним переміщенням.
Чесні обмеження
Це публічні довідкові дані, а не комерційна служба верифікації адрес. Вона скаже вам, що 53-332 — справжній поштовий індекс у Вроцлаві, і надасть координати населеного пункту. Вона не скаже, чи існує квартира 212 у будинку 5, і чи живе там хтось. Для верифікації на рівні пункту доставки вам потрібен продукт національного поштового оператора, і робочий процес може викликати його через HTTP поруч із цим.
Це також не джерело персональних даних. Тут немає людей. Він містить місця, коди, реєстри та публічні факти — саме тому його можна надавати без автентифікації.
Про актуальність: довідкові дані змінюються повільно, і ці дані оновлюються за розкладом, а не безперервно. Щойно перейменоване село не з'явиться того ж дня. Для всього, що змінюється погодинно, вам натомість потрібна стрічка подій, створена саме для цього.