Nominatim Search API：地址与地点地理编码

Nominatim 官方 Search 文档提供地址或地点文本查询端点，支持自由文本和结构化地址，返回坐标及可选地址明细或几何。最多返回40条匹配；费用、认证与公共服务限流未在本附件说明，尚未实测。

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

整理进度：已整理 · 语义分类：地理空间／OSM 地址与地点地理编码 · 证据等级：公开文档，未实测。

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

Search API 将地点描述或地址转换为最佳匹配的 OSM 地点结果。可使用 q 自由文本或结构化字段，选择 JSON、JSONv2、XML、GeoJSON、GeocodeJSON 等格式；它不保证列出区域内某类型的全部对象。本卡仅依据所捕获的 Search 文档，不把示例响应视作实际查询结果。

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

固定版本的深度资料

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

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

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

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

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

输入

q 自由文本，或 amenity、street、city、county、state、country、postalcode 等结构化字段；两种模式互斥。
format 支持 xml、json、jsonv2、geojson、geocodejson；limit 默认10且最大40。
可选 addressdetails、extratags、namedetails、accept-language、countrycodes、viewbox/bounded 及一种 polygon_* 输出。

输出

JSON 示例返回地点结果数组，包含 display_name、lat、lon、boundingbox、osm_type、osm_id 等；可选 addressdetails 增加地址组成。
GeoJSON / GeocodeJSON 示例使用 FeatureCollection；polygon 参数可加入几何，实际字段依格式和可用数据变化。

使用方式

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

鉴权：未知。此 Search 文档的参数与示例未说明凭据要求；不能仅凭示例 URL 推断公共服务永远免认证。

运行前提

必须提供 q 或适用的结构化地址字段，不能将 q 与结构化查询合用。
显式指定 format；公共 nominatim.openstreetmap.org 服务省略 format 会转到 Web UI。
附件仅链接 Usage Policy，未捕获其正文；公共实例使用政策与配额待核。

公开请求示例

{
  "method": "GET",
  "notes": "\u4F9D\u636E\u6587\u6863\u81EA\u7531\u6587\u672C\u53CA\u53C2\u6570\u6574\u7406\uFF0C\u672A\u53D1\u51FA\u8BF7\u6C42\u3002",
  "query": {
    "addressdetails": 1,
    "format": "jsonv2",
    "limit": 1,
    "q": "135 pilkington avenue, birmingham"
  },
  "url": "https://nominatim.openstreetmap.org/search"
}

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

第三方价格与条款

未知。所捕获的 Search 参考页未给出收费或免费额度；OSM 数据许可与托管 API 的调用费用是不同问题。

价格来源 · 未知

资料去向

提供者服务器。查询文本、地址及可选 email 会随请求送至服务端。附件未说明日志或保留期限；本次未提交任何地址或个人资料。

限制

只返回最佳匹配集合，不适合完整枚举区域内的所有某类 OSM 对象，返回数量也可能少于 limit。
limit 最大40；q 不可与结构化地址字段组合。
search.php 已弃用；多个 polygon_* 输出选项不能同时启用。
公共服务的认证、价格、请求速率、日配额及使用政策正文不在本附件；不补写常见记忆值。

仍需核对

公共实例的认证要求、费用、限流、配额及服务保障未知，Usage Policy 未包含在本批正文。
请求日志保留和地址数据处理政策未知；样例响应不代表当前数据或实时可用性。

提交者报告的验证

仅查阅资料 · 未测试

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

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

实际检查

来源HTTPS响应可读取

未验证范围

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

公开证据

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

来源与贡献者

主要公开来源

Search - Nominatim 5.3.3 Manual · 官方文档 · 2026-10-25T01:43:27.9352654+08:00

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

本次来源读取范围

{
  "url": "https://nominatim.org/release-docs/latest/api/Search/",
  "final_url": "https://nominatim.org/release-docs/latest/api/Search/",
  "status_code": 200,
  "title": "Search - Nominatim 5.3.3 Manual",
  "description": null,
  "checked_at": "2026-10-24T17:43:27.9352654\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-f1ebf5564d40eac33d0f783d",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://nominatim.org/release-docs/latest/api/Search/"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

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

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

补充公开更正或观察

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

提出有来源的摘要更正

报告有条件的公开观察

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