参考数据与数据增强

三千四百万行数据，作为一个步骤

国家、语言和货币。1340 万个有人居住的地点和地理要素。1900 万个名称变体。200 万个邮政编码。机场、海港、汽车品牌。65 个接口，无需身份验证，没有费率表，因为它就运行在你的工作流所在的同一个平台上。

为什么这很不寻常

在其他所有自动化工具里，“校验这个地址”都是需要付费的第三方集成。你要找供应商、开账户、谈费率、拿密钥、存密钥、盯配额，用量变化时还得重新谈判。查询本身只要二十毫秒；采购流程却要两个星期。

而在这里，它只是选择器里的一个步骤。这些数据是公开的参考数据——GeoNames、官方代码表、公开登记册——由 castomAPI 清洗、索引并提供服务。castomAPI 之所以存在，是因为这个产品家族里的十几个产品都需要同样的东西，建一次比建十二次便宜。

搜索基于三元组（trigram），最少需要三个字符，因此部分拼写或拼错的名称仍能找到地点。这个下限是有意为之：两个字符会匹配所有内容，而匹配一切的查询比查不到更糟。

校验——把坏数据挡在门外。这是那个城市真实存在的邮政编码吗？那个国家代码存在吗，还是 2019 年某人打错、此后一直传播的笔误？PLN 是一种货币吗，而且是不是应该向这位客户收取的那种？

规范化——“Warsaw”、“Warszawa”、“Varsovie”和“Варшава”是同一个地点、同一个标识符。存在一千九百万个名称变体，这样你的客户数据库就不必保存同一城市的四种拼写，还假装它们是四个城市。

充实——城市名称变成坐标、时区、行政区划和人口数字。机场代码变成名称和位置。邮政编码变成层级中它之上的所有内容。原本需要人工输入的六个字段，二十毫秒内填好，分文不取。

解析一个地点会得到它的时区，而时区正是让“早上九点发送”对收件人来说是他们的早上九点、而不是你的早上九点的关键。静默时段、日程和提醒对国际名单自动变得正确，无需任何人维护映射表。

充实一个联系人castomAPI 数据

耗时：40 毫秒65 个可用端点

实际示例

在购买运单之前完成地址校验和规范化。一张被拒的运单意味着一笔费用和一天时间；一个被拒的邮政编码只花二十毫秒。

在开具发票之前校验货币代码和国家代码，这比发票发出后再校验便宜得多。

同一客户的两条记录、同一城市的两种拼写，一旦两个城市都解析到同一标识符，就能正确合并。

客户的坐标和你的仓库坐标，运行时自动选择最近的一个，无需任何人维护邮政编码到仓库的电子表格。

一个国家解析出它的语言，因此发出的消息使用收件人大概率读得懂的一种——由数据决定，而不是凭一面旗帜去猜。

车辆品牌、机场和海港作为规范记录，服务于那些工作涉及实物移动的流程。

这是公开的参考数据，不是商业地址核验服务。它会告诉你 53-332 是弗罗茨瓦夫真实存在的邮政编码，并给出该地区的坐标。它不会告诉你 5 号楼 212 室是否存在，或是否有人住在那里。要达到投递点级别的核验，你需要国家邮政运营商的产品，工作流可以通过 HTTP 在使用本数据的同时调用它。

它也不是个人数据的来源。里面没有任何人。它包含的是地点、代码、名册和公开事实——这正是它可以无需身份验证即可提供的原因。

关于时效性：参考数据变化缓慢，本数据按计划刷新而非持续更新。一个刚改名的新村庄不会当天下午就出现。对于按小时变化的内容，你应该使用事件订阅，它正是为此而构建的。