Skip to main content

地理编码API

将地址转换为坐标,反之亦然

将地址转换为精确坐标,将坐标转换为可读地址。对于需要处理位置数据的任何应用程序都是必不可少的。

主要功能

适用于每个用例的精确地理编码

正向地理编码

将地址和地名转换为精确的地理坐标(纬度/经度)

逆向地理编码

将坐标转换为带有详细位置信息的可读地址

自动完成

在输入时提供实时地点和地址建议,具有智能位置过滤和边界控制

全球覆盖

对全球地址进行地理编码,支持国际地址格式

高精度

地址的屋顶级精度,具有建筑物特定坐标

一致的结果

可靠、可重现的地理编码,具有高成功率和质量评分

反向地理编码:将坐标转换为地址

反向地理编码接收一对纬度和经度,并返回最接近的人类可读地址。它是正向地理编码的逆过程,正向地理编码是从地址出发获得坐标。反向地理编码为所有以地图上某个点为起点的应用提供支持:门店定位、配送投放确认、GPS 签到、带地理标签的照片,以及需要为用户提供的坐标获取可验证街道地址的 AI 代理。

MapAtlas Geocoding API 会为任意坐标返回完整的地址结构:街道、门牌号、街区、城市、行政区域、邮政编码和国家,覆盖全球各种地址格式。响应在各国之间保持一致,并且足够稳定,可以与您现有的记录进行比对。

示例请求

curl -X GET "https://api.mapatlas.xyz/v1/geocode/reverse?lat=52.3676&lon=4.9041" \
  -H "Authorization: Bearer YOUR_API_KEY"

精准定位的全球覆盖

我们的地理编码引擎在190多个国家和地区提供行业领先的精度。基于OpenStreetMap数据和先进的地址解析技术,我们为每个结果提供置信度评分和详细的元数据。

190+
覆盖国家
High
准确率
<100ms
平均响应时间
  • 为每个地理编码结果提供置信度评分
  • 详细的地址组件(街道、城市、邮政编码)
  • 支持结构化和自由格式地址输入

适用于各种场景的高级功能

通过为生产应用程序设计的强大功能超越基本地理编码。从结构化地址解析到多语言支持,我们提供构建复杂位置服务所需的工具。

地址标准化

将不一致的地址格式标准化并清理为结构化、验证的组件

多语言支持

通过Unicode支持为全球应用程序返回多种语言的结果

自动完成与建议

用户输入时提供实时地址建议,提升用户体验和准确性

符合GDPR

隐私优先架构,无数据保留,采用欧盟托管基础设施

标准化
"123 main st"
↓
123 Main Street
City, State ZIP
多语言
?text=Tokyo Tower
&lang=ja

// 東京タワー
// 日本
自动完成
/autocomplete
?text=Eiffe

// Eiffel Tower
// Eiffel 65
符合GDPR
No data logsNo retentionEU servers

技术规格

核心功能

地理编码类型
正向和逆向
精度
屋顶级精度

覆盖范围和规模

覆盖范围
全球,所有国家
自动完成
实时建议

数据格式

响应格式
包含完整详细信息的JSON
编码
UTF-8,所有语言

定价

免费套餐
10,000次地理编码/月
速率限制
无限制

准备好开始了吗?

立即使用MapAtlas开始构建。免费注册并立即访问我们所有的地图API,享受慷慨的免费层限制。

关于地理编码 API 的常见问题

在集成 MapAtlas 地理编码 API 之前需要了解的一切。

正在用 AI 构建?让你的 agent 直接调用此 API。

Cursor、Copilot、Cline 和自主 agent 可通过公开的 OpenAPI 3.1 spec 或 MapAtlas MCP server 使用此 endpoint。自动发现,无需 glue code。

查看 AI 集成指南

关于地理编码 API 的常见问题

在集成 MapAtlas 地理编码 API 之前需要了解的一切。

正向地理编码和反向地理编码有什么区别?
正向地理编码将文本地址转换为坐标(纬度和经度)。反向地理编码则相反:接受坐标并返回最近的地址。MapAtlas 地理编码 API 在单个集成中同时支持两者。
MapAtlas 地理编码的精度如何?
MapAtlas 地理编码结合官方地址数据库、OpenStreetMap 数据和专有数据丰富,在欧洲和全球范围内提供街道级精度。每个结果都会返回置信度分数,以便您的应用程序能够优雅地处理不确定的匹配。
我可以批量地理编码吗?
是的。MapAtlas 通过我们的 API 支持批量地理编码,每次请求最多可处理 1,000 个地址。这非常适合迁移地址数据库、丰富 CRM 数据或处理配送地址。
地理编码 API 是否符合 GDPR?
所有地理编码请求均在基于欧盟的服务器上处理,请求生命周期之外不存储任何地址或坐标。MapAtlas 运行在通过 ISO 27001 认证的欧盟数据中心,并符合 GDPR。
地理编码 API 返回哪些格式?
结果以 JSON 格式返回,包含结构化地址组件(街道、城市、邮政编码、国家)、坐标和置信度分数。也支持 GeoJSON 输出。
如何把经纬度转换成地址?
使用反向地理编码接口即可。将纬度和经度作为查询参数发送,API 会返回最接近的邮政地址,并提供街道、城市、邮编和国家等结构化字段。免费版的限流较为宽松,付费版还支持批量查询。
如何把地址转换成坐标?
调用正向地理编码接口,将地址作为一段文本字符串传入。API 会返回一个或多个候选位置,每个候选都带有精确的经纬度、置信度评分以及匹配到的字段。最终是直接采用第一个结果,还是让用户在候选中选择,由开发者自行决定。
它能当作地址校验工具用吗?
可以。正向地理编码同时承担地址校验的角色:如果 API 返回了屋顶级或街道级的高置信度匹配,说明该地址有效且可解析;如果最佳匹配只落到了城市或邮编中心点,那就是在结账或注册流程中把该地址标记为可疑的信号。