我们的观点

为什么应该把邮政编码查询视为一等公民

产品的优先级,早在任何关于什么最重要的明确声明出现之前,就已经体现在定价结构和文档深度上。一个被塞进较低价格档位的端点,或者一个只用三句话写成文档、旁边却是旗舰功能完整详尽页面的端点,都在传达一个关于内部优先级的真实事实,无论是否有人有意传达。邮政编码查询是这种模式的常见受害者:技术上可用,却很少获得投入,与完整的地理编码相比被视为一个次要的小工具。

我们有意让邮政编码查询与其他所有端点同等定价,正是为了避免这种悄无声息的降级。它同样包含在每日免费配额之内,超出部分同样按每次请求 €0.0001 计费,或者同样包含在 €50 的 Unlimited 密钥中,与地理编码、IP 查询、时区或海拔完全一样。没有任何折扣档位暗示邮政查询被认为价值较低,也没有任何高级档位暗示相反的意思。它与其他所有功能处于同一水平,因为我们认为理应如此。

同等定价只是起点,而不是论证的全部。邮政编码查询值得被当作一等功能对待,更深层的原因在于,其底层数据确实与任何其他类型的位置数据一样值得认真对待。邮政系统并不是地理编码的简化版本。它们自成一类结构,在格式、单个编码所覆盖的区域大小,以及编码与行政边界的对应程度上,都因国家而异。要在多个国家正确构建这一功能,需要真正而持续的关注,也就是旗舰地理编码功能因被默认视为重要功能而天然获得的那种关注。

把一个端点当作一等功能对待,也意味着它获得同样的文档标准:真实的示例、对返回哪些数据及其结构的清晰描述,以及按国家如实说明覆盖范围的局限,而不是一句含糊笼统的声明。一个因被认为简单而只写了单薄文档的端点,往往恰恰在那些重要的方面一直停留在简单层面,因为没有人仔细到足以注意它哪里做得不够。

除了在工程精力分配上的公平之外,这样做还有实际的回报。许多真实的应用,例如运费计算器、税务辖区检查、服务区域验证,更直接地依赖于正确的邮政编码解析,而不是完整的街道级地理编码。把邮政查询视为相对于地理编码的次要功能,恰恰对最需要这些数据的应用把实际依赖关系弄反了。给予它同等定价和同等文档并不是一种象征性姿态,而更接近于纠正一个行业内大多未经审视便沿袭下来的类别错误。