API Códigos Postales España

Consulta cualquier código postal o municipio de España con datos geográficos completos.

原始信息汇总

API Códigos Postales España 数据集概述

基本信息

• 数据集名称: API Códigos Postales España
• 类别: Commerce
• 提供者: Iñaki Serrano (Webcomunica Solutions)
• 支持联系: [e-mail]

功能描述

用于查询西班牙的任何邮政编码或城市，并提供完整的地理数据。通过一次GET调用，可返回包含地点、省份、自治区和地理坐标的JSON数据。旨在集成到结账或客户注册表单中，以实现地址的自动填充。

技术特性

• 版本: 1.0.0 (current)
• 认证方式: 仅需一个API密钥，无需SDK、OAuth或会过期的令牌。
• 响应格式: 简洁的JSON。
• 数据源: GeoNames的更新数据。

数据覆盖范围

• 超过11,000个邮政编码。
• 52个省份。
• 17个自治区。
• 每个地点的地理坐标。

端点详情

1. 按邮政编码搜索

• 端点: GET /index.php
• 必需参数: cp (字符串类型，例如 "29110")。
• 功能: 返回与该邮政编码关联的所有城市及其省份、自治区和坐标。

2. 按城市搜索

• 端点: GET /buscar.php
• 必需参数: municipio (字符串类型，例如 "monda")。
• 可选参数: provincia (字符串类型，例如 "malaga")，用于筛选结果。
• 功能: 按城市名称进行部分匹配搜索，返回关联的邮政编码。

3. 列出省份和城市

• 端点: GET /provincias.php
• 可选参数: provincia (字符串类型，例如 "malaga")。
• 功能: 无参数时列出所有52个省份；提供省份参数时，返回该省份的所有城市及其邮政编码。

响应示例

json { "exito": true, "total": 1, "resultados": [ { "codigo_postal": "29110", "municipio": "Monda", "provincia": "Málaga", "comunidad_autonoma": "Andalucía", "latitud": 36.6333, "longitud": -4.8333 } ] }

典型用例

• 电子商务/结账: 用户输入邮政编码，应用自动填充城市和省份，减少购物车放弃率。
• 送货表单: 验证邮政编码是否存在并向用户显示地点以供确认。
• CRM/ERP系统: 规范化客户地址，避免省份或自治区的拼写错误。
• 配送区域计算: 利用坐标计算距离并分配送货区域或费用。
• 地理分析: 利用包含的坐标，按省份和自治区映射客户或销售数据。

错误代码

• 200: 成功。
• 400: 缺少必需参数或格式无效。
• 401: 请求头中缺少API密钥。
• 404: 未找到邮政编码或城市。
• 429: 超出订阅计划限制。

集成示例

提供了JavaScript、PHP和Python的代码示例，演示如何调用API并处理响应以填充表单字段。

订阅计划

• BASIC: $0.00 / 月
• PRO: $4.99 / 月
• ULTRA: $14.99 / 月
• MEGA: $29.99 / 月

性能指标

• 流行度: 8.9
• 服务等级: 100%
• 延迟: 66ms
• 测试状态: N/A