Dados de referência e enriquecimento
Trinta e quatro milhões de linhas, como um passo
Países, línguas e moedas. 13,4 milhões de localidades e acidentes geográficos habitados. 19 milhões de variantes de nomes. Dois milhões de códigos postais. Aeroportos, portos marítimos, marcas de veículos. Sessenta e cinco endpoints, sem autenticação, sem tabela de preços, porque é a mesma plataforma em que o teu fluxo já corre.
Porque é que isto é invulgar
Em todas as outras ferramentas de automação, «validar este endereço» é uma integração paga de terceiros. Encontras um fornecedor, abres uma conta, acordas uma tabela de preços, obtens uma chave, guardas a chave, vigias a quota e renegocias quando o teu volume muda. A consulta em si leva vinte milissegundos; a contratação leva uma quinzena.
Aqui é um passo no seletor. Os dados são dados de referência públicos — GeoNames, listas de códigos oficiais, registos publicados — limpos, indexados e servidos pela castomAPI, que existe porque uma dúzia de produtos desta família precisava do mesmo e construí-lo uma vez era mais barato do que construí-lo doze vezes.
A pesquisa é baseada em trigramas com um mínimo de três caracteres, por isso um nome parcial ou mal escrito ainda encontra o lugar. Esse mínimo é deliberado: dois caracteres correspondem a tudo, e uma consulta que corresponde a tudo é pior do que nenhuma consulta.
As três coisas que as pessoas fazem com isto
Validar — parar os maus dados à porta. Aquele código postal é real para aquela cidade? Aquele código de país existe, ou é um erro de escrita que alguém fez em 2019 e que se propagou desde então? PLN é uma moeda, e é aquela em que este cliente deve ser cobrado?
Normalizar — «Warsaw», «Warszawa», «Varsovie» e «Варшава» são um lugar com um identificador. Dezanove milhões de variantes de nomes existem para que a tua base de dados de clientes não tenha de guardar quatro grafias da mesma cidade e fingir que são quatro cidades.
Enriquecer — um nome de cidade torna-se coordenadas, um fuso horário, uma região administrativa e uma população. Um código de aeroporto torna-se um nome e uma localização. Um código postal torna-se tudo o que está acima dele na hierarquia. Seis campos que uma pessoa teria de escrever, preenchidos em vinte milissegundos, de graça.
O fuso horário é o discreto
Resolver um lugar dá-te o seu fuso horário, e um fuso horário é o que faz «enviar isto às nove da manhã» significar nove da manhã para quem recebe, e não nove da manhã para ti. Horas de silêncio, agendamentos e lembretes tornam-se todos corretos para uma lista internacional sem ninguém ter de manter uma tabela de correspondências.
- 1Entrada«ul. Powstańców Śląskich 5, 53-332 Wrocław, PL»
- 2Código postal correspondido53-332 → Wrocław, Dolnośląskie, PL.
- 3Localidade resolvida51.0938 N, 17.0226 E · Europe/Warsaw · população 674 079.
- 4Escrito de voltaSeis campos preenchidos que uma pessoa teria de escrever à mão.
- §CustoPasso determinístico. Sem chave, sem quota, sem custo por consulta.
Decorrido: 40 ms65 endpoints disponíveis
Trinta e quatro milhões de linhas. Um passo.
Exemplos práticos
Onde ganha o seu lugar
Antes de a transportadora o ver
Um endereço verificado e normalizado antes de comprar a etiqueta de envio. Uma etiqueta rejeitada custa uma taxa e um dia; um código postal rejeitado custa vinte milissegundos.
Antes de o contabilista o ver
Um código de moeda e um código de país validados antes de uma fatura ser emitida, o que é consideravelmente mais barato do que validá-los depois de ela ter sido enviada.
Remover duplicados de uma lista
Dois registos com o mesmo cliente sob duas grafias da mesma cidade fundem-se corretamente assim que ambas as cidades resolvem para o mesmo identificador.
Encaminhar por geografia
Coordenadas de um cliente e coordenadas dos teus depósitos, e a execução escolhe o mais próximo sem ninguém ter de manter uma folha de cálculo de código postal para depósito.
A língua, corretamente
Um país resolve para as suas línguas, por isso a mensagem que sai está numa que o destinatário provavelmente lê — decidido por dados em vez de por uma suposição sobre uma bandeira.
Frota e logística
Marcas de veículos, aeroportos e portos marítimos como registos canónicos, para os fluxos cujo trabalho envolve algo em movimento físico.
Os limites honestos
Estes são dados de referência públicos, não um serviço comercial de verificação de endereços. Vai dizer-te que 53-332 é um código postal real em Wrocław e dar-te as coordenadas da localidade. Não te vai dizer se o apartamento 212 existe no número 5, nem se alguém lá vive. Para verificação ao nível do ponto de entrega queres um produto de um operador postal nacional, e um workflow pode chamar um por HTTP em paralelo com isto.
Também não é uma fonte de dados pessoais. Não há pessoas nele. Contém lugares, códigos, registos e factos públicos — e é precisamente por isso que pode ser servido sem autenticação.
Sobre a atualidade: os dados de referência mudam lentamente, e este é atualizado por agenda em vez de continuamente. Uma aldeia recentemente renomeada não vai aparecer na mesma tarde. Para o que muda à hora queres antes o feed de eventos, que foi feito exatamente para isso.