US Geocode

Convert US addresses to coordinates and back. Forward geocoding, reverse geocoding, with structured address components — powered by frapi.io.

原始信息汇总

US Geocode 数据集详情

基本信息

• 类别: Logistics（物流）
• API提供方: frapi.io
• 订阅者数量: 1
• 服务等级: 100%
• 延迟: 773ms
• 测试成功率: 100%
• 热门度: 8.6

功能概述

US Geocode API 提供美国地址与经纬度坐标之间的双向转换服务，包含两个核心端点：

1. 正向地理编码（Forward Geocode）：将人类可读的美国地址转换为精确的经纬度坐标，同时返回结构化的地址组件（门牌号、街道、城市、县、州、邮政编码）和置信度评分。
2. 反向地理编码（Reverse Geocode）：将 WGS-84 格式的经纬度坐标转换为格式化的结构化地址。

该 API 基于 frapi.io 轻量级单租户基础设施运行，解决了传统地理编码方案的痛点（如按次付费的高昂费用、自建地址数据库的维护成本、正则表达式规则的脆弱性等）。

技术规范

1. 正向地理编码端点

• 请求方式: POST
• 接口地址: https://frapi-geocode-v1.p.rapidapi.com/v1/geocode
• 请求参数: address（字符串，必填，最少3个字符，自由格式美国地址）
• 响应字段: 包含 results 数组（含格式化地址、地址组件、坐标、置信度等）和 source 数据源

2. 反向地理编码端点

• 请求方式: POST
• 接口地址: https://frapi-geocode-v1.p.rapidapi.com/v1/reverse
• 请求参数: latitude（必填，范围-90至90）、longitude（必填，范围-180至180），均为WGS-84标准
• 响应格式: 与正向地理编码相同的 GeocodeResponse 结构

认证方式

所有请求需在 X-RapidAPI-Key 头部传递有效的 RapidAPI 密钥。

错误处理

• 422错误: 参数缺失或无效时返回标准 FastAPI 验证错误，包含字段级别的错误详情
• 429错误: 超出订阅计划速率限制时返回

定价方案

方案	价格
BASIC	$0.00/月
PRO	$9.99/月
ULTRA	$49.99/月

该 API 不设多年合同或最低消费要求，按查询次数付费，可根据业务增长灵活扩展。

地址组件说明

响应中的 AddressComponents 包含以下字段（均为可空字符串）：number（门牌号）、predirectional（方向前缀）、street（街道）、suffix（后缀）、formatted_street（格式化街道）、unit_type（单元类型）、unit_number（单元号）、city（城市）、county（县）以及额外的州/邮编/国家字段。