Datos de referencia y enriquecimiento
Treinta y cuatro millones de filas, como un paso
Países, idiomas y monedas. 13,4 millones de lugares poblados y accidentes geográficos. 19 millones de variantes de nombres. Dos millones de códigos postales. Aeropuertos, puertos marítimos, marcas de vehículos. Sesenta y cinco endpoints, sin autenticación, sin tarifa de uso, porque es la misma plataforma donde ya se ejecuta tu flujo de trabajo.
Por qué esto es inusual
En todas las demás herramientas de automatización, «validar esta dirección» es una integración de pago de un tercero. Encuentras un proveedor, abres una cuenta, acuerdas una tarifa, obtienes una clave, guardas la clave, vigilas la cuota y renegocias cuando cambia tu volumen. La consulta en sí tarda veinte milisegundos; la contratación tarda dos semanas.
Aquí es un paso del selector. Los datos son datos de referencia públicos —GeoNames, listas de códigos oficiales, registros publicados— depurados, indexados y servidos por castomAPI, que existe porque una docena de productos de esta familia necesitaban lo mismo y construirlo una vez era más barato que construirlo doce veces.
La búsqueda se basa en trigramas con un mínimo de tres caracteres, así que un nombre parcial o mal escrito sigue encontrando el lugar. Ese mínimo es deliberado: dos caracteres coinciden con todo, y una búsqueda que coincide con todo es peor que ninguna búsqueda.
Las tres cosas que la gente hace con esto
Validar — detener los datos malos en la puerta. ¿Es ese un código postal real de esa ciudad? ¿Existe ese código de país, o es una errata que alguien cometió en 2019 y que se ha estado propagando desde entonces? ¿Es PLN una moneda, y es la que se le debe cobrar a este cliente?
Normalizar — «Warsaw», «Warszawa», «Varsovie» y «Варшава» son un solo lugar con un solo identificador. Existen diecinueve millones de variantes de nombre para que tu base de datos de clientes no tenga que guardar cuatro grafías de la misma ciudad y fingir que son cuatro ciudades.
Enriquecer — un nombre de ciudad se convierte en coordenadas, una zona horaria, una región administrativa y una cifra de población. Un código de aeropuerto se convierte en un nombre y una ubicación. Un código postal se convierte en todo lo que hay por encima de él en la jerarquía. Seis campos que una persona tendría que escribir, rellenados en veinte milisegundos, gratis.
La zona horaria es lo silencioso
Resolver un lugar te da su zona horaria, y una zona horaria es lo que hace que «enviar esto a las nueve de la mañana» signifique las nueve de la mañana para el destinatario y no las nueve de la mañana para ti. Las horas de silencio, los horarios y los recordatorios se vuelven correctos para una lista internacional sin que nadie mantenga una tabla de correspondencias.
- 1Entrada«ul. Powstańców Śląskich 5, 53-332 Wrocław, PL»
- 2Código postal coincidente53-332 → Wrocław, Baja Silesia, PL.
- 3Lugar resuelto51.0938 N, 17.0226 E · Europe/Warsaw · población 674 079.
- 4Escrito de vueltaSeis campos rellenados que una persona habría tenido que teclear.
- §CostePaso determinista. Sin clave, sin cuota, sin cargo por consulta.
Tiempo transcurrido: 40 ms65 endpoints disponibles
Treinta y cuatro millones de filas. Un paso.
Ejemplos prácticos
Dónde gana su sitio
Antes de que lo vea la transportista
Una dirección comprobada y normalizada antes de comprar la etiqueta de envío. Una etiqueta rechazada cuesta una tasa y un día; un código postal rechazado cuesta veinte milisegundos.
Antes de que lo vea el contable
Un código de moneda y un código de país validados antes de emitir una factura, lo cual es considerablemente más barato que validarlos después de haberla enviado.
Deduplicar una lista
Dos registros con el mismo cliente bajo dos grafías de la misma ciudad se fusionan correctamente una vez que ambas ciudades se resuelven al mismo identificador.
Enrutado por geografía
Coordenadas de un cliente y coordenadas de tus almacenes, y la ejecución elige el más cercano sin que nadie mantenga una hoja de cálculo de código postal a almacén.
El idioma, correctamente
Un país se resuelve a sus idiomas, así que el mensaje que se envía está en uno que el destinatario probablemente lee —decidido por datos y no por una suposición sobre una bandera.
Flota y logística
Marcas de vehículos, aeropuertos y puertos marítimos como registros canónicos, para los flujos de trabajo cuyo trabajo implica algo que se mueve físicamente.
Los límites honestos
Esto son datos de referencia públicos, no un servicio comercial de verificación de direcciones. Te dirá que 53-332 es un código postal real de Wrocław y te dará las coordenadas de la localidad. No te dirá si existe el piso 212 en el número 5, ni si alguien vive allí. Para la verificación a nivel de punto de entrega quieres el producto de un operador postal nacional, y un flujo de trabajo puede llamar a uno por HTTP junto con esto.
Tampoco es una fuente de datos personales. No hay personas en él. Contiene lugares, códigos, registros y hechos públicos — que es exactamente por lo que puede servirse sin autenticación.
Sobre la frescura: los datos de referencia cambian lentamente, y esto se actualiza de forma programada en lugar de continua. Una aldea recién renombrada no aparecerá esa misma tarde. Para cualquier cosa que cambie hora a hora quieres el feed de eventos en su lugar, que está construido exactamente para eso.