OpenCage Geocoding API

OpenCage 官方 REST API 提供全球地址正向与经纬度反向地理编码；需 API key，免费试用仅供测试，持续使用需付费方案。本次未调用。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：地址与经纬度地理编码服务 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · e7b044d967ec4f9bb0ca514cd9c03f0527417f4b6eb36cceec79ffdb0c83c332

官方文档给出 GET https://api.opencagedata.com/geocode/v1/json，请求由 key 和 q 两个必填参数组成。q 可以是地址/地名，或纬度、经度顺序的坐标；还可选择 countrycode、bounds、language、limit 等参数。支持 JSON、GeoJSON、XML 输出。反向查询至多返回一项，正向查询可能返回多项。服务用于地理编码，正文明确不提供模糊匹配或输入自动补全。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-074234313bbef59f503b99d9 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-074234313bbef59f503b99d9
名片版本: 2
资料更新: 2026-10-24T17:43:04.6724486+00:00
原作者 / 提供者: 未知
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

key：账户专属 API key。
q：URL 编码的地址/地名，或十进制纬度、经度；至少两个字符。
可选 countrycode、bounds、language、limit、no_annotations、no_record 等；部分参数只适用于正向查询。

输出

JSON、GeoJSON 或 XML 结果；示例有 results、status、total_results、timestamp 等结构及结果坐标。
反向结果至多一项；可包含 distance_from_q 和基于结果坐标计算的 annotations。
具有硬额度的账户可返回 rate 与 X-RateLimit 响应头；订阅客户不返回这些硬额度字段。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：API 密钥。每次 HTTP 请求必须把有效 API key 放在 key 查询参数；文档明确无需认证 HTTP header。需注册取得 key。该 key 不适用于另一个 geosearch/autosuggest 服务。

运行前提

取得有效 OpenCage Geocoding API key。
必填 key 与 URL 编码的 q；反向坐标使用纬度、经度顺序。
HTTPS 请求要求 TLS 1.2 或更高；这里只登记文档推荐的 HTTPS 地址。

公开请求示例

{
  "documentation_text": "\u6587\u6863\u793A\u4F8B\u5F62\u72B6\uFF08\u672A\u6267\u884C\uFF09\uFF1AGET https://api.opencagedata.com/geocode/v1/json?q=52.5432379%2C\u002B13.4142133\u0026key=\u003CYOUR-API-KEY\u003E\u3002"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

收费。正文提供免费测试期，每日 2,500 次、每秒 1 次，并明确这不是持续使用的免费层。持续使用及更高速度/量需付费；有月/年订阅和一次性方案，绝对价格及各付费配额未在本次对应段落确认。

价格来源 · 未知

资料去向

提供者服务器。地址或坐标作为查询参数发送到 OpenCage 托管服务；no_record=1 的文档含义是不记录查询内容。实际账户设置、保留细则和地区未实测。

限制

不支持模糊匹配、自动补全或输入联想；这与另一个 geosearch 服务不同。
免费试用硬限制为每日 2,500 请求，UTC 日界重置，每秒最多一请求，仅限测试。
硬额度耗尽可返回 402，过快可返回 429，持续超硬额度可能被禁用；付费具体等级另有方案。
正向结果 limit 默认 10、最多 100；反向至多一结果。
不返回精确多边形或结果的永久唯一标识；覆盖、准确率和时效未实测。

仍需核对

具体付费单价、各档速度和额度、账户开通条件未核实。
具体地点的覆盖、精度、时效及语言表现未验证。
数据保留、驻留及 no_record 的实际行为未实测。
未使用测试 key 或账户 key 发送任何请求。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T17:35:20.4269158+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

OpenCage Geocoding API Documentation · 官方文档 · 2026-10-24T17:35:20.4269158+00:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://opencagedata.com/api",
  "final_url": "https://opencagedata.com/api",
  "status_code": 200,
  "title": "OpenCage Geocoding API Documentation",
  "description": null,
  "checked_at": "2026-10-24T17:35:20.4269158\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-074234313bbef59f503b99d9",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://opencagedata.com/api"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。