NavoNavo

Help your AI find the right capability, and help others find yours.

Integration guide
Back

GeoNames · 地名与时区REST服务

Close

GeoNames · 地名与时区REST服务

GeoNames官方文档提供坐标逆地理、国家、邮编、海拔及时区REST服务；每次请求需自有注册账户的username，可按接口返回JSON、XML或文本。免费与premium服务的范围和数量限制不同。仅文档整理，未调用，HTTPS可用性及总额度未验证。

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-6a9555652eeb594141b10530
Card version
2
Updated
2026-10-24T17:33:06.2335660+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

Inputs

  • countryCode：lat、lng，type可为xml或JSON，不指定则文本；lang及海岸radius可选。
  • timezone：lat、lng；可选radius、lang、date，返回点位所在时区及当地日出日落信息。
  • postalCodeSearch：postalcode或placename至少一个，可加country、maxRows、style等；其余服务按各自参数表。

Outputs

  • countryCode返回ISO国家代码，XML/JSON还含国家名称。
  • timezone返回timezoneId、国家、当地时间、标准UTC偏移、日出日落等；极昼/极夜或找不到时区时无日出日落值。
  • 其他已列接口可返回地名、国家资料、邮编或海拔，具体结构和格式随服务不同。

Invocation and authentication

unknown

{
  "authentication": {
    "kind": "account",
    "notes": "\u6B63\u6587\u8981\u6C42\u6240\u6709\u8BF7\u6C42\u542B\u81EA\u6709\u8D26\u6237username\uFF0C\u5E76\u8981\u6C42\u5148\u6CE8\u518C\u514D\u8D39\u8D26\u6237\uFF1Bdemo\u8D26\u6237\u4EC5\u4F9B\u6587\u6863\u6837\u4F8B\uFF0C\u4E0D\u7528\u4E8E\u5E94\u7528\u6216\u6D4B\u8BD5\u3002\u672A\u6CE8\u518C\u6216\u8C03\u7528\u3002"
  },
  "command": null,
  "entry_url": null,
  "kind": "http_api",
  "method": "GET",
  "request_example": null,
  "requirements": [
    "\u81EA\u6709GeoNames\u8D26\u6237username\uFF1B\u6309\u6240\u9009\u670D\u52A1URL\u63D0\u4F9B\u53C2\u6570\u5E76URL\u7F16\u7801\u5B57\u7B26\u4E32\u3002",
    "\u5F53\u524D\u6B63\u6587\u5217\u7684\u662FHTTP\u63A5\u53E3\u793A\u4F8B\uFF1B\u672A\u9A8C\u8BC1HTTPS\u652F\u6301\uFF0C\u4E0D\u5C06HTTP\u793A\u4F8B\u76F4\u63A5\u63CF\u8FF0\u4E3A\u5B89\u5168\u4F20\u8F93\u4FDD\u8BC1\u3002",
    "\u9009\u62E9\u5355\u72EC\u670D\u52A1\u53CA\u5176\u8FD4\u56DE\u683C\u5F0F\uFF0C\u4E0D\u80FD\u5047\u8BBE\u6240\u6709\u63A5\u53E3\u90FD\u652F\u6301\u76F8\u540CJSON/XML\u53C2\u6570\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": "free_tier",
  "notes": "\u6B63\u6587\u660E\u786E\u53EF\u6CE8\u518C\u514D\u8D39\u8D26\u6237\uFF0C\u5E76\u533A\u5206free\u4E0Epremium\u670D\u52A1\u7684\u5355\u6B21\u53C2\u6570\u4E0A\u9650\uFF1B\u6CA1\u6709\u5728\u672C\u9875\u7ED9\u51FA\u5B8C\u6574\u603B\u914D\u989D\u6216premium\u4EF7\u683C\u3002",
  "source_url": "https://www.geonames.org/export/web-services.html"
}
{
  "location": "provider_server",
  "notes": "\u5B9E\u9645\u8BF7\u6C42\u4F1A\u628Ausername\u3001\u5750\u6807\u6216\u5730\u540D\u90AE\u7F16\u7B49\u53D1\u9001\u7ED9\u670D\u52A1\u65B9\uFF1B\u5F53\u524D\u793A\u4F8B\u4E3AHTTP\uFF0C\u4F20\u8F93\u4FDD\u62A4\u3001\u65E5\u5FD7\u7559\u5B58\u548C\u5B8C\u6574\u6570\u636E\u8BB8\u53EF\u672A\u6838\u3002\u672C\u8F6E\u672A\u53D1\u9001\u67E5\u8BE2\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

  • 附近邮编免费服务最多30km范围、500maxRows；premium列160km/2500，不将该数值当所有接口的统一额度。
  • 加拿大、爱尔兰、马耳他邮编有版权前缀限制；巴西仅主要邮编，阿根廷数据为旧4位系统。
  • 海拔产品可能有空洞和数据错误，海洋可能返回指定no-data值，不能当真实海拔。
  • 本文链接credits与异常说明，但未核总日/小时额度、SLA或完整许可，不沿旧资料填数字。

Unknowns

  • 实际调用、HTTPS支持、当前账户权限、总请求credits和付费价格未知。
  • 数据时效、覆盖完整性、具体结果准确性与SLA未验证。
  • 各数据集完整许可和商业使用要求需另查，不将某邻里数据CC BY-SA说明推广到全部数据。

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:16:29.4806421\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://www.geonames.org/export/web-services.html"
  ],
  "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

This form proposes a summary change for the current fixed version. Other supported fields use the original API. Concurrent version changes return a conflict.

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": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u5B9E\u9645\u8BF7\u6C42\u4F1A\u628Ausername\u3001\u5750\u6807\u6216\u5730\u540D\u90AE\u7F16\u7B49\u53D1\u9001\u7ED9\u670D\u52A1\u65B9\uFF1B\u5F53\u524D\u793A\u4F8B\u4E3AHTTP\uFF0C\u4F20\u8F93\u4FDD\u62A4\u3001\u65E5\u5FD7\u7559\u5B58\u548C\u5B8C\u6574\u6570\u636E\u8BB8\u53EF\u672A\u6838\u3002\u672C\u8F6E\u672A\u53D1\u9001\u67E5\u8BE2\u3002"
  },
  "description": "",
  "inputs": [
    "countryCode\uFF1Alat\u3001lng\uFF0Ctype\u53EF\u4E3Axml\u6216JSON\uFF0C\u4E0D\u6307\u5B9A\u5219\u6587\u672C\uFF1Blang\u53CA\u6D77\u5CB8radius\u53EF\u9009\u3002",
    "timezone\uFF1Alat\u3001lng\uFF1B\u53EF\u9009radius\u3001lang\u3001date\uFF0C\u8FD4\u56DE\u70B9\u4F4D\u6240\u5728\u65F6\u533A\u53CA\u5F53\u5730\u65E5\u51FA\u65E5\u843D\u4FE1\u606F\u3002",
    "postalCodeSearch\uFF1Apostalcode\u6216placename\u81F3\u5C11\u4E00\u4E2A\uFF0C\u53EF\u52A0country\u3001maxRows\u3001style\u7B49\uFF1B\u5176\u4F59\u670D\u52A1\u6309\u5404\u81EA\u53C2\u6570\u8868\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "account",
      "notes": "\u6B63\u6587\u8981\u6C42\u6240\u6709\u8BF7\u6C42\u542B\u81EA\u6709\u8D26\u6237username\uFF0C\u5E76\u8981\u6C42\u5148\u6CE8\u518C\u514D\u8D39\u8D26\u6237\uFF1Bdemo\u8D26\u6237\u4EC5\u4F9B\u6587\u6863\u6837\u4F8B\uFF0C\u4E0D\u7528\u4E8E\u5E94\u7528\u6216\u6D4B\u8BD5\u3002\u672A\u6CE8\u518C\u6216\u8C03\u7528\u3002"
    },
    "command": null,
    "entry_url": null,
    "kind": "http_api",
    "method": "GET",
    "request_example": null,
    "requirements": [
      "\u81EA\u6709GeoNames\u8D26\u6237username\uFF1B\u6309\u6240\u9009\u670D\u52A1URL\u63D0\u4F9B\u53C2\u6570\u5E76URL\u7F16\u7801\u5B57\u7B26\u4E32\u3002",
      "\u5F53\u524D\u6B63\u6587\u5217\u7684\u662FHTTP\u63A5\u53E3\u793A\u4F8B\uFF1B\u672A\u9A8C\u8BC1HTTPS\u652F\u6301\uFF0C\u4E0D\u5C06HTTP\u793A\u4F8B\u76F4\u63A5\u63CF\u8FF0\u4E3A\u5B89\u5168\u4F20\u8F93\u4FDD\u8BC1\u3002",
      "\u9009\u62E9\u5355\u72EC\u670D\u52A1\u53CA\u5176\u8FD4\u56DE\u683C\u5F0F\uFF0C\u4E0D\u80FD\u5047\u8BBE\u6240\u6709\u63A5\u53E3\u90FD\u652F\u6301\u76F8\u540CJSON/XML\u53C2\u6570\u3002"
    ]
  },
  "limitations": [
    "\u9644\u8FD1\u90AE\u7F16\u514D\u8D39\u670D\u52A1\u6700\u591A30km\u8303\u56F4\u3001500maxRows\uFF1Bpremium\u5217160km/2500\uFF0C\u4E0D\u5C06\u8BE5\u6570\u503C\u5F53\u6240\u6709\u63A5\u53E3\u7684\u7EDF\u4E00\u989D\u5EA6\u3002",
    "\u52A0\u62FF\u5927\u3001\u7231\u5C14\u5170\u3001\u9A6C\u8033\u4ED6\u90AE\u7F16\u6709\u7248\u6743\u524D\u7F00\u9650\u5236\uFF1B\u5DF4\u897F\u4EC5\u4E3B\u8981\u90AE\u7F16\uFF0C\u963F\u6839\u5EF7\u6570\u636E\u4E3A\u65E74\u4F4D\u7CFB\u7EDF\u3002",
    "\u6D77\u62D4\u4EA7\u54C1\u53EF\u80FD\u6709\u7A7A\u6D1E\u548C\u6570\u636E\u9519\u8BEF\uFF0C\u6D77\u6D0B\u53EF\u80FD\u8FD4\u56DE\u6307\u5B9Ano-data\u503C\uFF0C\u4E0D\u80FD\u5F53\u771F\u5B9E\u6D77\u62D4\u3002",
    "\u672C\u6587\u94FE\u63A5credits\u4E0E\u5F02\u5E38\u8BF4\u660E\uFF0C\u4F46\u672A\u6838\u603B\u65E5/\u5C0F\u65F6\u989D\u5EA6\u3001SLA\u6216\u5B8C\u6574\u8BB8\u53EF\uFF0C\u4E0D\u6CBF\u65E7\u8D44\u6599\u586B\u6570\u5B57\u3002"
  ],
  "outputs": [
    "countryCode\u8FD4\u56DEISO\u56FD\u5BB6\u4EE3\u7801\uFF0CXML/JSON\u8FD8\u542B\u56FD\u5BB6\u540D\u79F0\u3002",
    "timezone\u8FD4\u56DEtimezoneId\u3001\u56FD\u5BB6\u3001\u5F53\u5730\u65F6\u95F4\u3001\u6807\u51C6UTC\u504F\u79FB\u3001\u65E5\u51FA\u65E5\u843D\u7B49\uFF1B\u6781\u663C/\u6781\u591C\u6216\u627E\u4E0D\u5230\u65F6\u533A\u65F6\u65E0\u65E5\u51FA\u65E5\u843D\u503C\u3002",
    "\u5176\u4ED6\u5DF2\u5217\u63A5\u53E3\u53EF\u8FD4\u56DE\u5730\u540D\u3001\u56FD\u5BB6\u8D44\u6599\u3001\u90AE\u7F16\u6216\u6D77\u62D4\uFF0C\u5177\u4F53\u7ED3\u6784\u548C\u683C\u5F0F\u968F\u670D\u52A1\u4E0D\u540C\u3002"
  ],
  "pricing": {
    "model": "free_tier",
    "notes": "\u6B63\u6587\u660E\u786E\u53EF\u6CE8\u518C\u514D\u8D39\u8D26\u6237\uFF0C\u5E76\u533A\u5206free\u4E0Epremium\u670D\u52A1\u7684\u5355\u6B21\u53C2\u6570\u4E0A\u9650\uFF1B\u6CA1\u6709\u5728\u672C\u9875\u7ED9\u51FA\u5B8C\u6574\u603B\u914D\u989D\u6216premium\u4EF7\u683C\u3002",
    "source_url": "https://www.geonames.org/export/web-services.html"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:16:29.4806421\u002B00:00",
      "title": "GeoNames Web Service Documentation \u2014 GeoNames UI",
      "url": "https://www.geonames.org/export/web-services.html"
    }
  ],
  "summary": "GeoNames\u5B98\u65B9\u6587\u6863\u63D0\u4F9B\u5750\u6807\u9006\u5730\u7406\u3001\u56FD\u5BB6\u3001\u90AE\u7F16\u3001\u6D77\u62D4\u53CA\u65F6\u533AREST\u670D\u52A1\uFF1B\u6BCF\u6B21\u8BF7\u6C42\u9700\u81EA\u6709\u6CE8\u518C\u8D26\u6237\u7684username\uFF0C\u53EF\u6309\u63A5\u53E3\u8FD4\u56DEJSON\u3001XML\u6216\u6587\u672C\u3002\u514D\u8D39\u4E0Epremium\u670D\u52A1\u7684\u8303\u56F4\u548C\u6570\u91CF\u9650\u5236\u4E0D\u540C\u3002\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u8C03\u7528\uFF0CHTTPS\u53EF\u7528\u6027\u53CA\u603B\u989D\u5EA6\u672A\u9A8C\u8BC1\u3002",
  "tags": [
    "GeoNames",
    "\u9006\u5730\u7406\u7F16\u7801",
    "\u5730\u540D",
    "\u65F6\u533A",
    "\u90AE\u7F16",
    "REST API",
    "\u9700\u8D26\u6237"
  ],
  "terms_url": null,
  "title": "GeoNames \u00B7 \u5730\u540D\u4E0E\u65F6\u533AREST\u670D\u52A1",
  "unknowns": [
    "\u5B9E\u9645\u8C03\u7528\u3001HTTPS\u652F\u6301\u3001\u5F53\u524D\u8D26\u6237\u6743\u9650\u3001\u603B\u8BF7\u6C42credits\u548C\u4ED8\u8D39\u4EF7\u683C\u672A\u77E5\u3002",
    "\u6570\u636E\u65F6\u6548\u3001\u8986\u76D6\u5B8C\u6574\u6027\u3001\u5177\u4F53\u7ED3\u679C\u51C6\u786E\u6027\u4E0ESLA\u672A\u9A8C\u8BC1\u3002",
    "\u5404\u6570\u636E\u96C6\u5B8C\u6574\u8BB8\u53EF\u548C\u5546\u4E1A\u4F7F\u7528\u8981\u6C42\u9700\u53E6\u67E5\uFF0C\u4E0D\u5C06\u67D0\u90BB\u91CC\u6570\u636ECC BY-SA\u8BF4\u660E\u63A8\u5E7F\u5230\u5168\u90E8\u6570\u636E\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:16:29.4806421\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://www.geonames.org/export/web-services.html"
    ],
    "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-6a9555652eeb594141b10530",
  "version": 2,
  "source_url": "https://www.geonames.org/export/web-services.html",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://www.geonames.org/export/web-services.html",
    "final_url": "https://www.geonames.org/export/web-services.html",
    "status_code": 200,
    "title": "GeoNames Web Service Documentation \u2014 GeoNames UI",
    "description": null,
    "checked_at": "2026-10-24T17:16:29.4806421\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:16:32.2376244\u002B00:00",
  "updated_at": "2026-10-24T17:33:06.2335660\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-6a9555652eeb594141b10530?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-6a9555652eeb594141b10530?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\u4E0E\u516C\u5171\u6570\u636E\uFF5C\u9700\u6CE8\u518C\u8D26\u6237\u7684\u5730\u540D\u4E0E\u65F6\u533AREST\u670D\u52A1",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-8d25d378c0cdd28c7b1774e55c5fb1c0",
        "source_url": "https://www.geonames.org/export/web-services.html",
        "content_sha256": "95f2054ff67cb2b21a5dacaf4ddc8accae396806924459e288ecf080b8a8839e",
        "decoded_bytes": 72875,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:16:29.4806421\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "95f2054ff67cb2b21a5dacaf4ddc8accae396806924459e288ecf080b8a8839e",
        "text_utf8_bytes": 72875,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-6a9555652eeb594141b10530/materials/material-8d25d378c0cdd28c7b1774e55c5fb1c0?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-a0eccbd44a05416fa4d2f40000ed80fb",
    "reason": "\u636E\u672C\u6279GeoNames\u5B98\u65B9Web Service Documentation\u6574\u7406\u8D26\u6237\u3001\u5750\u6807\u67E5\u8BE2\u548C\u6570\u636E\u9650\u5236\uFF1B\u672A\u8C03\u7528\u793A\u4F8B\u6216\u4F7F\u7528demo\u8D26\u6237\u3002",
    "source_urls": [
      "https://www.geonames.org/export/web-services.html"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-6a9555652eeb594141b10530",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-6a9555652eeb594141b10530?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-6a9555652eeb594141b10530?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"
    ]
  }
}

Submit another public source · Privacy and disclosure

Copy for your AI

Copy this text manually if clipboard access is unavailable. Copying does not register, install or connect anything.