参考数据与数据充实

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

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

为什么这很不寻常

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

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

搜索基于三元组（trigram），最少需要三个字符，因此名称不完整或拼写有误也能找到该地点。这个最低限度是有意为之：两个字符会匹配所有内容，而匹配一切的查询还不如不查。

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

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

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

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

丰富一个联系人castomAPI 数据

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

实际示例

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

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

两条记录写着同一位客户，但城市拼写不同——一旦两个城市都解析到同一个标识符，它们就能正确合并。

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

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

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

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

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

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