Japan Address Mix API

Turn Japanese addresses into developer-ready data. Search, normalize, and structure addresses without understanding Japan's complex address system.

原始信息汇总

Japan Address Mix API 数据集详情

数据集概述

Japan Address Mix API 是一个用于日本地址标准化与解析的API服务，通过整合日本邮政（Japan Post）的邮政编码数据和日本数字厅地址基准登记簿（ABR），将日本地址和邮政编码转换为结构化、可解释的JSON格式数据。该API专为面向日本市场的应用程序设计，提供了完整的地址组件、地方政府代码、町田ID、坐标（如可用）、匹配等级、可解释置信度、警告和数据来源信息。

核心功能

• 地址标准化：将日文地址和邮政编码标准化为结构化数据
• 邮政编码解析：支持日本邮政编码数据的查询与解析
• 多源数据整合：融合日本邮政数据、数字厅ABR数据及平台自身的归一化处理
• 可解释性输出：提供置信度等级而非简单概率，基于邮编、都道府县、市区町村、町域、未匹配文本、候选数量、ABR精度及来源一致性等综合判定
• 坐标返回：在可用时返回坐标，并明确报告精度和来源状态，不推断缺失坐标

技术规格

接口信息

项目	详情
端点	POST /v1/address/resolve
认证方式	通过RapidAPI处理，使用X-RapidAPI-Key和X-RapidAPI-Host请求头
请求体	仅需必填字段 query，可接受日本邮政编码、地址或两者结合

响应状态

API返回HTTP 200时，match.status 可能包含以下值：

状态	说明
matched	单一结果满足匹配规则
partial	解析出有用的地址组件，但部分查询未解决
ambiguous	返回多个可能候选结果
not_found	搜索正常完成但无匹配结果

数据来源

1. 日本邮政：邮政编码数据
2. 日本数字厅：地址基准登记簿（ABR）
3. JAPAN API STORE：归一化处理与来源协调

官方数据源按不同时间表更新，data_versions 字段分别报告各来源版本。

错误码

状态码	含义
400	JSON格式错误或输入无效
401	请求未通过RapidAPI接收
429	达到套餐或安全限制
500	意外内部错误
503	临时认证、使用或数据源故障

订阅方案

方案	价格
BASIC	$0.00/月
PRO	$25.00/月
ULTRA	$99.00/月

服务表现

• 流行度：8.5
• 服务等级：100%
• 延迟：318ms
• 测试：N/A（不可用）

提供商信息

• 类别：商业软件
• 订阅用户数：1
• 产品网站：https://japanapistore.com/
• 完整文档：https://japanapistore.com/docs/address-mix

补充说明

该API提供英文文档和可直接复制的代码示例，面向全球开发者设计。值得注意的是，置信度并非概率，而是基于多个维度的证据等级评分；同时，坐标精度可能低于地址匹配精度，且可能为空值，API不会伪造缺失的坐标数据。