US Boundaries: ZCTA, County & State Geometry

Official US Census boundary polygons for ZIP Code Tabulation Areas, counties and states — with the part nobody else tells you on the label: a ZCTA is not a ZIP Code, 7,763 US ZIP Codes (18.7%) have no polygon at all, and 30.1% of ZCTAs cross a county line. Vintage, CRS and the exact simplification applied come back in every single response.

原始信息汇总

US Boundaries: ZCTA, County & State Geometry 数据集详情

数据集概述

这是由 Synergic APIs 提供的美国地理边界数据集，专注于 ZCTA（ZIP Code Tabulation Areas）、县和州的空间几何数据。该 API 的核心价值在于明确区分 ZCTA 与 ZIP Code——ZCTA 是美国人口普查局基于 2020 年人口普查块构建的统计近似区域，而非 USPS 的邮政投递路线。

核心数据统计

• ZCTA 数量：33,791 个（2020 年人口普查版本）
• USPS 声明的 ZIP Code：41,554 个
• 无官方几何数据的 ZIP Code：7,763 个（占 18.7%）
• 跨越县界的 ZCTA：10,186 个（占 30.1%）
• 县及等效行政区：3,235 个
• 州和领地：56 个

关键特性

数据精度与来源

• 数据源：美国人口普查局 TIGER/Line® Shapefiles 和 Cartographic Boundary Files
• 坐标系：EPSG:4269 (NAD83)，未做重投影，坐标保留六位小数
• ZCTA 为 2020 年版本，冻结至 2030 年人口普查；县和州为 2024 年版本

简化策略

• 提供 ?tolerance=none|11m|55m|111m 参数，默认不做简化
• 拒绝可能导致要素消失的简化请求，返回完整几何并附带 refused_reason 说明
• 在 111m 容差下，67 个 ZCTA 会消失（如曼哈顿的 10020 洛克菲勒中心）

诚实声明机制

• 每次响应均包含数据年代、源文件、概括级别、坐标系、坐标精度及简化信息
• 对没有官方几何数据的 ZIP Code，返回文档化的“否”，而非编造形状
• 不确认 ZIP Code 在 USPS 的有效性（usps_zip_valid 始终为 null）

主要端点

方法	路径	功能
GET	/v1/zcta/{zcta}	获取 ZCTA 几何、内部点和面积
GET	/v1/zcta/by-point?lat=&lon=	坐标点所属的 ZCTA
GET	/v1/zcta/{zcta}/counties	ZCTA 触及的县及官方重叠面积
GET	/v1/zcta?bbox=&limit=&cursor=	分页列出 ZCTA 元数据（不含几何）
GET	/v1/zip/{zip}/status	查询 ZIP Code 是否有官方几何数据
GET	/v1/county/{geoid}	县几何数据
GET	/v1/county/by-point	坐标点所属的县
GET	/v1/state/{fips or usps}	州几何数据
GET	/v1/state/by-point	坐标点所属的州
GET	/health	服务健康检查

错误处理

• 200：包含“ZIP 无多边形”和“点不在任何 ZCTA 内”等正常回答
• 400：格式错误的请求（无效 ZCTA 格式、超范围坐标、未知容差）
• 404：五位数字格式正确但非已发布的 ZCTA
• 429：达到套餐配额（硬性上限，不会额外计费）

订阅方案

套餐	价格	月请求量
BASIC	免费	500 次/月（无需信用卡）
PRO	$9.90/月	25,000 次
ULTRA	$24.90/月	150,000 次
MEGA	$49.90/月	500,000 次

特别注意事项

• 国家级完整数据包：不提供一次性下载（全量 ZCTA GeoJSON 达 136.7 MB），需通过分页接口获取
• 内部点：使用人口普查局 Gazetteer 的 INTPTLAT/INTPTLONG，确保落在多边形内部
• 康涅狄格州特殊问题：2022 年 7 月后该州 8 个县改为 9 个规划区，受影响的 288 个 ZCTA 会返回 2020 年县名并注明 geometry_available: false
• 数据可存储：数据属美国联邦公共领域（17 U.S.C. §105），允许缓存、存储和再分发，需保留人口普查局归属声明

数据局限

• 不提供邻里边界（无官方联邦数据源）
• 不覆盖美国以外地区
• 不含人口统计信息（v1 版本）
• 不提供过度的几何简化（防止关键区域被删除）