CAP Italia

Given an Italian postal code (CAP), returns municipality, province, region, GPS coordinates and timezone. 4,735 postal codes covering all 20 Italian regions and 107 provinces.

原始信息汇总

CAP Italia API 数据集概述

基本信息

• 数据集名称：CAP Italia
• 类别：Location
• 提供者：xDubby
• 许可协议：MIT

核心功能

给定一个意大利邮政编码（CAP），返回对应的市镇（comune）、省份（provincia）、大区（regione）、GPS坐标（lat, lon）和时区（timezone）。

数据规模与来源

• 覆盖范围：包含4,735个唯一的意大利邮政编码，涵盖意大利全部20个大区和107个省。
• 数据来源：GeoNames 与 ISTAT（意大利官方统计机构）的开放数据。
• 数据库特性：数据在启动时加载至内存中，以实现最低延迟。

主要特性

• 批量查询：单次请求最多可查询50个邮政编码。
• 按市镇名称搜索：支持通过市镇名称进行搜索。
• 高性能：响应时间低于100毫秒（基于内存数据库）。

应用场景

• 地址表单自动补全
• 配送区域验证
• 电子商务结账表单
• 物流与配送应用程序

接口端点

方法	路径	描述
GET	/status	健康检查
GET	/cap/{cap}	单个邮政编码查询
POST	/cap/bulk	批量查询（最多50个邮政编码）
GET	/search?q=...	按市镇名称搜索

技术栈

• 编程语言：Python 3.12
• Web框架：FastAPI（自动生成OpenAPI文档）
• ASGI服务器：Uvicorn
• 部署平台：Railway
• 发布市场：RapidAPI

定价方案

• BASIC：$0.00 / 月
• PRO：$9.99 / 月
• ULTRA：$19.99 / 月
• MEGA：$39.99 / 月

搜集汇总

背景与挑战

背景概述

CAP Italia数据集提供意大利邮政编码（CAP）的关联信息，包括对应的市镇、省份、大区、GPS坐标和时区。该数据集覆盖了意大利全部20个大区和107个省，共包含4,735个邮政编码。