Nominatim Search API:地址与地点地理编码
CloseNominatim Search API:地址与地点地理编码
Nominatim 官方 Search 文档提供地址或地点文本查询端点,支持自由文本和结构化地址,返回坐标及可选地址明细或几何。最多返回40条匹配;费用、认证与公共服务限流未在本附件说明,尚未实测。
Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.
- Stable ID
- cap-f1ebf5564d40eac33d0f783d
- Card version
- 2
- Updated
- 2026-10-24T17:49:02.2770429+00:00
- Ownership state
- unclaimed
- Processing
- unknown
- Evidence level
- unknown
- Business execution
- unknown
Keep this fixed version · Original public source · Complete machine record
Published description
Search API 将地点描述或地址转换为最佳匹配的 OSM 地点结果。可使用 q 自由文本或结构化字段,选择 JSON、JSONv2、XML、GeoJSON、GeocodeJSON 等格式;它不保证列出区域内某类型的全部对象。本卡仅依据所捕获的 Search 文档,不把示例响应视作实际查询结果。
Inputs
- 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_* 输出。
Outputs
- JSON 示例返回地点结果数组,包含 display_name、lat、lon、boundingbox、osm_type、osm_id 等;可选 addressdetails 增加地址组成。
- GeoJSON / GeocodeJSON 示例使用 FeatureCollection;polygon 参数可加入几何,实际字段依格式和可用数据变化。
Invocation and authentication
{
"authentication": {
"kind": "unknown",
"notes": "\u6B64 Search \u6587\u6863\u7684\u53C2\u6570\u4E0E\u793A\u4F8B\u672A\u8BF4\u660E\u51ED\u636E\u8981\u6C42\uFF1B\u4E0D\u80FD\u4EC5\u51ED\u793A\u4F8B URL \u63A8\u65AD\u516C\u5171\u670D\u52A1\u6C38\u8FDC\u514D\u8BA4\u8BC1\u3002"
},
"command": null,
"entry_url": "https://nominatim.openstreetmap.org/search",
"kind": "http_api",
"method": "GET",
"request_example": {
"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"
},
"requirements": [
"\u5FC5\u987B\u63D0\u4F9B q \u6216\u9002\u7528\u7684\u7ED3\u6784\u5316\u5730\u5740\u5B57\u6BB5\uFF0C\u4E0D\u80FD\u5C06 q \u4E0E\u7ED3\u6784\u5316\u67E5\u8BE2\u5408\u7528\u3002",
"\u663E\u5F0F\u6307\u5B9A format\uFF1B\u516C\u5171 nominatim.openstreetmap.org \u670D\u52A1\u7701\u7565 format \u4F1A\u8F6C\u5230 Web UI\u3002",
"\u9644\u4EF6\u4EC5\u94FE\u63A5 Usage Policy\uFF0C\u672A\u6355\u83B7\u5176\u6B63\u6587\uFF1B\u516C\u5171\u5B9E\u4F8B\u4F7F\u7528\u653F\u7B56\u4E0E\u914D\u989D\u5F85\u6838\u3002"
]
}Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.
Third-party pricing and data handling
{
"model": "unknown",
"notes": "\u6240\u6355\u83B7\u7684 Search \u53C2\u8003\u9875\u672A\u7ED9\u51FA\u6536\u8D39\u6216\u514D\u8D39\u989D\u5EA6\uFF1BOSM \u6570\u636E\u8BB8\u53EF\u4E0E\u6258\u7BA1 API \u7684\u8C03\u7528\u8D39\u7528\u662F\u4E0D\u540C\u95EE\u9898\u3002",
"source_url": "https://nominatim.org/release-docs/latest/api/Search/"
}{
"location": "provider_server",
"notes": "\u67E5\u8BE2\u6587\u672C\u3001\u5730\u5740\u53CA\u53EF\u9009 email \u4F1A\u968F\u8BF7\u6C42\u9001\u81F3\u670D\u52A1\u7AEF\u3002\u9644\u4EF6\u672A\u8BF4\u660E\u65E5\u5FD7\u6216\u4FDD\u7559\u671F\u9650\uFF1B\u672C\u6B21\u672A\u63D0\u4EA4\u4EFB\u4F55\u5730\u5740\u6216\u4E2A\u4EBA\u8D44\u6599\u3002"
}Unknown is not a claim that a service is free, anonymous, private or unavailable.
Limitations
- 只返回最佳匹配集合,不适合完整枚举区域内的所有某类 OSM 对象,返回数量也可能少于 limit。
- limit 最大40;q 不可与结构化地址字段组合。
- search.php 已弃用;多个 polygon_* 输出选项不能同时启用。
- 公共服务的认证、价格、请求速率、日配额及使用政策正文不在本附件;不补写常见记忆值。
Unknowns
- 公共实例的认证要求、费用、限流、配额及服务保障未知,Usage Policy 未包含在本批正文。
- 请求日志保留和地址数据处理政策未知;样例响应不代表当前数据或实时可用性。
Fixed profiles, conditions and evidence
Read state: not_checked; review state: unknown. Do not combine different profiles.
资料与来源声明不等于本站实测;未列出的条件仍未知。
结构化配方只按公开声明检查约束与接口,不执行任务或授予权限;缺失记录保持未知,接口兼容不证明实际成功。
Contributor-reported verification
{
"checked_at": "2026-10-24T17:43:27.9352654\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://nominatim.org/release-docs/latest/api/Search/"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.
Dynamic observations and corrections
null
null
Add a public correction or observation
Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.
Propose a sourced summary correction
Report a conditional public observation
Complete fixed public record and original source fields
This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.
{
"author_name": "Nominatim developer community",
"availability": "unknown",
"callability": "documentation_only",
"category": "physical",
"data_handling": {
"location": "provider_server",
"notes": "\u67E5\u8BE2\u6587\u672C\u3001\u5730\u5740\u53CA\u53EF\u9009 email \u4F1A\u968F\u8BF7\u6C42\u9001\u81F3\u670D\u52A1\u7AEF\u3002\u9644\u4EF6\u672A\u8BF4\u660E\u65E5\u5FD7\u6216\u4FDD\u7559\u671F\u9650\uFF1B\u672C\u6B21\u672A\u63D0\u4EA4\u4EFB\u4F55\u5730\u5740\u6216\u4E2A\u4EBA\u8D44\u6599\u3002"
},
"description": "Search API \u5C06\u5730\u70B9\u63CF\u8FF0\u6216\u5730\u5740\u8F6C\u6362\u4E3A\u6700\u4F73\u5339\u914D\u7684 OSM \u5730\u70B9\u7ED3\u679C\u3002\u53EF\u4F7F\u7528 q \u81EA\u7531\u6587\u672C\u6216\u7ED3\u6784\u5316\u5B57\u6BB5\uFF0C\u9009\u62E9 JSON\u3001JSONv2\u3001XML\u3001GeoJSON\u3001GeocodeJSON \u7B49\u683C\u5F0F\uFF1B\u5B83\u4E0D\u4FDD\u8BC1\u5217\u51FA\u533A\u57DF\u5185\u67D0\u7C7B\u578B\u7684\u5168\u90E8\u5BF9\u8C61\u3002\u672C\u5361\u4EC5\u4F9D\u636E\u6240\u6355\u83B7\u7684 Search \u6587\u6863\uFF0C\u4E0D\u628A\u793A\u4F8B\u54CD\u5E94\u89C6\u4F5C\u5B9E\u9645\u67E5\u8BE2\u7ED3\u679C\u3002",
"inputs": [
"q \u81EA\u7531\u6587\u672C\uFF0C\u6216 amenity\u3001street\u3001city\u3001county\u3001state\u3001country\u3001postalcode \u7B49\u7ED3\u6784\u5316\u5B57\u6BB5\uFF1B\u4E24\u79CD\u6A21\u5F0F\u4E92\u65A5\u3002",
"format \u652F\u6301 xml\u3001json\u3001jsonv2\u3001geojson\u3001geocodejson\uFF1Blimit \u9ED8\u8BA410\u4E14\u6700\u592740\u3002",
"\u53EF\u9009 addressdetails\u3001extratags\u3001namedetails\u3001accept-language\u3001countrycodes\u3001viewbox/bounded \u53CA\u4E00\u79CD polygon_* \u8F93\u51FA\u3002"
],
"invocation": {
"authentication": {
"kind": "unknown",
"notes": "\u6B64 Search \u6587\u6863\u7684\u53C2\u6570\u4E0E\u793A\u4F8B\u672A\u8BF4\u660E\u51ED\u636E\u8981\u6C42\uFF1B\u4E0D\u80FD\u4EC5\u51ED\u793A\u4F8B URL \u63A8\u65AD\u516C\u5171\u670D\u52A1\u6C38\u8FDC\u514D\u8BA4\u8BC1\u3002"
},
"command": null,
"entry_url": "https://nominatim.openstreetmap.org/search",
"kind": "http_api",
"method": "GET",
"request_example": {
"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"
},
"requirements": [
"\u5FC5\u987B\u63D0\u4F9B q \u6216\u9002\u7528\u7684\u7ED3\u6784\u5316\u5730\u5740\u5B57\u6BB5\uFF0C\u4E0D\u80FD\u5C06 q \u4E0E\u7ED3\u6784\u5316\u67E5\u8BE2\u5408\u7528\u3002",
"\u663E\u5F0F\u6307\u5B9A format\uFF1B\u516C\u5171 nominatim.openstreetmap.org \u670D\u52A1\u7701\u7565 format \u4F1A\u8F6C\u5230 Web UI\u3002",
"\u9644\u4EF6\u4EC5\u94FE\u63A5 Usage Policy\uFF0C\u672A\u6355\u83B7\u5176\u6B63\u6587\uFF1B\u516C\u5171\u5B9E\u4F8B\u4F7F\u7528\u653F\u7B56\u4E0E\u914D\u989D\u5F85\u6838\u3002"
]
},
"limitations": [
"\u53EA\u8FD4\u56DE\u6700\u4F73\u5339\u914D\u96C6\u5408\uFF0C\u4E0D\u9002\u5408\u5B8C\u6574\u679A\u4E3E\u533A\u57DF\u5185\u7684\u6240\u6709\u67D0\u7C7B OSM \u5BF9\u8C61\uFF0C\u8FD4\u56DE\u6570\u91CF\u4E5F\u53EF\u80FD\u5C11\u4E8E limit\u3002",
"limit \u6700\u592740\uFF1Bq \u4E0D\u53EF\u4E0E\u7ED3\u6784\u5316\u5730\u5740\u5B57\u6BB5\u7EC4\u5408\u3002",
"search.php \u5DF2\u5F03\u7528\uFF1B\u591A\u4E2A polygon_* \u8F93\u51FA\u9009\u9879\u4E0D\u80FD\u540C\u65F6\u542F\u7528\u3002",
"\u516C\u5171\u670D\u52A1\u7684\u8BA4\u8BC1\u3001\u4EF7\u683C\u3001\u8BF7\u6C42\u901F\u7387\u3001\u65E5\u914D\u989D\u53CA\u4F7F\u7528\u653F\u7B56\u6B63\u6587\u4E0D\u5728\u672C\u9644\u4EF6\uFF1B\u4E0D\u8865\u5199\u5E38\u89C1\u8BB0\u5FC6\u503C\u3002"
],
"outputs": [
"JSON \u793A\u4F8B\u8FD4\u56DE\u5730\u70B9\u7ED3\u679C\u6570\u7EC4\uFF0C\u5305\u542B display_name\u3001lat\u3001lon\u3001boundingbox\u3001osm_type\u3001osm_id \u7B49\uFF1B\u53EF\u9009 addressdetails \u589E\u52A0\u5730\u5740\u7EC4\u6210\u3002",
"GeoJSON / GeocodeJSON \u793A\u4F8B\u4F7F\u7528 FeatureCollection\uFF1Bpolygon \u53C2\u6570\u53EF\u52A0\u5165\u51E0\u4F55\uFF0C\u5B9E\u9645\u5B57\u6BB5\u4F9D\u683C\u5F0F\u548C\u53EF\u7528\u6570\u636E\u53D8\u5316\u3002"
],
"pricing": {
"model": "unknown",
"notes": "\u6240\u6355\u83B7\u7684 Search \u53C2\u8003\u9875\u672A\u7ED9\u51FA\u6536\u8D39\u6216\u514D\u8D39\u989D\u5EA6\uFF1BOSM \u6570\u636E\u8BB8\u53EF\u4E0E\u6258\u7BA1 API \u7684\u8C03\u7528\u8D39\u7528\u662F\u4E0D\u540C\u95EE\u9898\u3002",
"source_url": "https://nominatim.org/release-docs/latest/api/Search/"
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [],
"sources": [
{
"basis": "official_documentation",
"checked_at": "2026-10-25T01:43:27.9352654\u002B08:00",
"title": "Search - Nominatim 5.3.3 Manual",
"url": "https://nominatim.org/release-docs/latest/api/Search/"
}
],
"summary": "Nominatim \u5B98\u65B9 Search \u6587\u6863\u63D0\u4F9B\u5730\u5740\u6216\u5730\u70B9\u6587\u672C\u67E5\u8BE2\u7AEF\u70B9\uFF0C\u652F\u6301\u81EA\u7531\u6587\u672C\u548C\u7ED3\u6784\u5316\u5730\u5740\uFF0C\u8FD4\u56DE\u5750\u6807\u53CA\u53EF\u9009\u5730\u5740\u660E\u7EC6\u6216\u51E0\u4F55\u3002\u6700\u591A\u8FD4\u56DE40\u6761\u5339\u914D\uFF1B\u8D39\u7528\u3001\u8BA4\u8BC1\u4E0E\u516C\u5171\u670D\u52A1\u9650\u6D41\u672A\u5728\u672C\u9644\u4EF6\u8BF4\u660E\uFF0C\u5C1A\u672A\u5B9E\u6D4B\u3002",
"tags": [
"http_api",
"documentation_only",
"geocoding",
"openstreetmap"
],
"terms_url": null,
"title": "Nominatim Search API\uFF1A\u5730\u5740\u4E0E\u5730\u70B9\u5730\u7406\u7F16\u7801",
"unknowns": [
"\u516C\u5171\u5B9E\u4F8B\u7684\u8BA4\u8BC1\u8981\u6C42\u3001\u8D39\u7528\u3001\u9650\u6D41\u3001\u914D\u989D\u53CA\u670D\u52A1\u4FDD\u969C\u672A\u77E5\uFF0CUsage Policy \u672A\u5305\u542B\u5728\u672C\u6279\u6B63\u6587\u3002",
"\u8BF7\u6C42\u65E5\u5FD7\u4FDD\u7559\u548C\u5730\u5740\u6570\u636E\u5904\u7406\u653F\u7B56\u672A\u77E5\uFF1B\u6837\u4F8B\u54CD\u5E94\u4E0D\u4EE3\u8868\u5F53\u524D\u6570\u636E\u6216\u5B9E\u65F6\u53EF\u7528\u6027\u3002"
],
"verification": {
"checked_at": "2026-10-24T17:43:27.9352654\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://nominatim.org/release-docs/latest/api/Search/"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
},
"schema_version": "navonavo.capability.v1",
"service_id": "cap-f1ebf5564d40eac33d0f783d",
"version": 2,
"source_url": "https://nominatim.org/release-docs/latest/api/Search/",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "importer",
"name": "NAVONAVO public material importer"
},
"submitter_identity_verified": false,
"source_check": {
"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"
]
},
"created_at": "2026-10-24T17:43:30.8403995\u002B00:00",
"updated_at": "2026-10-24T17:49:02.2770429\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-f1ebf5564d40eac33d0f783d?version=2",
"page_url": "https://navonavo.com/capabilities/cap-f1ebf5564d40eac33d0f783d?version=2",
"verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
"library_material": {
"organization": "organized",
"semantic_state": "classified",
"semantic_category": "\u5730\u7406\u7A7A\u95F4\uFF0FOSM \u5730\u5740\u4E0E\u5730\u70B9\u5730\u7406\u7F16\u7801",
"evidence_grade": "documentation_only",
"attachments": [
{
"material_id": "material-f7fa6dbc40d53d41ed3a8872b68d0122",
"source_url": "https://nominatim.org/release-docs/latest/api/Search/",
"content_sha256": "52a4f099fab49e37ed2cfb2f1b2fe13c5175e46acb6be0b08eb306cf05730b77",
"decoded_bytes": 77469,
"content_type": "text/html",
"captured_at": "2026-10-24T17:43:27.9352654\u002B00:00",
"text_representation": "decoded_text_utf8",
"text_utf8_sha256": "52a4f099fab49e37ed2cfb2f1b2fe13c5175e46acb6be0b08eb306cf05730b77",
"text_utf8_bytes": 77469,
"capture_body_reconstructed": true,
"read_path": "/api/v1/capabilities/cap-f1ebf5564d40eac33d0f783d/materials/material-f7fa6dbc40d53d41ed3a8872b68d0122?version=1"
}
]
},
"last_correction": {
"contribution_id": "contribution-347a3d8e90814829a018aa9be6e3d96d",
"reason": "\u4F9D\u636E\u672C\u6279 Nominatim Search \u5B8C\u6574\u9644\u4EF6\u7684\u660E\u786E endpoint\u3001\u81EA\u7531\u6587\u672C/\u7ED3\u6784\u5316\u67E5\u8BE2\u3001\u53C2\u6570\u548C\u54CD\u5E94\u6837\u4F8B\u6574\u7406\u5E76\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u8D39\u7528\u3001\u8BA4\u8BC1\u4E0E\u672A\u6355\u83B7\u7684\u516C\u5171\u5B9E\u4F8B\u653F\u7B56\u4FDD\u7559\u672A\u77E5\uFF0C\u4EC5 documentation_only\u3002",
"source_urls": [
"https://nominatim.org/release-docs/latest/api/Search/"
],
"reported_by": "contributor"
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-f1ebf5564d40eac33d0f783d",
"card_version": 2,
"selected_profile_id": null,
"state": "not_checked",
"review_state": null,
"read_url": "https://navonavo.com/api/v1/capabilities/cap-f1ebf5564d40eac33d0f783d?version=2",
"page_url": "https://navonavo.com/capabilities/cap-f1ebf5564d40eac33d0f783d?version=2",
"profiles": [],
"warnings": [
"\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
"\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
]
}
}