Italy Postal Code & Coordinates API

Look up Italian postal codes (CAP) by municipality, province or region. Get full geolocation data and find the nearest postal zones by GPS coordinates.

原始信息汇总

Italy Postal Code & Coordinates API 数据集详情

一、数据集概述

该 API 提供意大利完整的 CAP（Codice di Avviamento Postale，邮政编码）数据库 的结构化访问，覆盖意大利全部 20 个大区（regioni） 和 110 个省（province） 下的 7,000 多个市镇（comuni）。

每条记录包含：

• CAP（5 位意大利邮政编码）
• 市镇名称（comune）
• 省缩写（provincia）
• 大区名称（regione）
• 地理坐标（纬度 latitude 和经度 longitude）

二、核心功能

功能	说明
按邮政编码查询	输入 5 位 CAP 代码，返回对应的市镇详情及 GPS 坐标
按市镇名称反向查询	输入市镇名称（支持部分匹配），返回该市镇所有关联的 CAP 及坐标
按省代码浏览	输入 2 位省缩写（如 MI、RM），返回省内所有邮政编码，支持分页
按大区名称浏览	输入大区名称（支持部分匹配），返回大区内所有邮政编码，支持分页
按地理坐标邻近搜索	输入经纬度坐标及搜索半径（delta），返回最近邮政编码并按距离排序

三、API 端点详情

1. 按 CAP 查询

• 端点: GET /{cap}
• 参数: cap（必填，5 位意大利邮编）
• 响应示例: 返回包含 cap、comune、provincia、regione、lat、lng 的对象数组

2. 按市镇名称查询

• 端点: GET /comune/{comune}
• 参数: comune（必填，支持部分名称匹配）
• 响应: 返回该市镇所有 CAP 记录

3. 按省代码查询

• 端点: GET /provincia/{provincia}
• 参数:
  • provincia（必填，2 位省代码）
  • limit（可选，默认 200，范围 1-1000）
  • offset（可选，分页偏移量）
• 响应: 返回省内所有 CAP 记录

4. 按大区名称查询

• 端点: GET /regione/{regione}
• 参数:
  • regione（必填，支持部分名称匹配）
  • limit（可选，默认 500，范围 1-2000）
  • offset（可选，分页偏移量）
• 响应: 返回大区内所有 CAP 记录

5. 按坐标邻近搜索

• 端点: GET /nearby/coordinates
• 参数:
  • lat（必填，纬度，十进制）
  • lng（必填，经度，十进制）
  • delta（可选，默认 0.1，约 11 公里）
  • limit（可选，默认 20，范围 1-100）
• 响应: 返回按距离排序的邻近 CAP 记录，包含 dist 字段

四、数据覆盖范围

• 地理范围：意大利全国所有邮政编码
• 数据粒度：每条记录均包含完整的地理坐标（纬度/经度）
• 行政区划层级：大区 → 省 → 市镇

五、适用场景

• 电商结账地址验证
• 物流配送路线规划与覆盖区域计算
• 门店定位与最近服务点查询
• 房地产平台按邮编区域筛选
• 现场服务应用按地理区域调度
• 移动应用的地址自动补全与位置感知建议
• 地图与 GIS 应用叠加意大利邮政区域数据
• CRM 数据丰富与地址标准化

六、鉴权方式

所有请求需通过 X-API-Key 头部进行鉴权：

• 缺少键值返回 422
• 无效键值返回 401
• 未授权服务返回 403

七、定价计划

计划	请求数/月	价格
FREE	100	$0
BASIC	5,000	$4.99
PRO	50,000	$14.99
MEGA	500,000	$28.99