GeoNames

简介

GeoNames 是最古老的免费地理数据库之一——地名、坐标、国家、邮编、时区和 Wikipedia 链接——通过近似免密钥的 Web 服务提供（免费的用户名就是“密钥”）。demo 账号可用于测试，但其共享每日配额经常被耗尽。

注（2026-08 实测）：共享的 demo 用户名返回“每日限额已超”——请在 geonames.org 注册免费用户名获得自己的配额。

快速开始

搜索地点（替换 YOUR_USERNAME）：

curl "http://api.geonames.org/searchJSON?q=berlin&maxRows=5&username=YOUR_USERNAME"

{
  "totalResultsCount": 1234,
  "geonames": [
    {
      "name": "Berlin",
      "lat": 52.52437,
      "lng": 13.41053,
      "countryCode": "DE",
      "population": 3426354,
      "fcl": "P",
      "fcode": "PPLC"
    }
  ]
}

邮编查询：

curl "http://api.geonames.org/postalCodeSearchJSON?postalcode=90210&maxRows=3&username=YOUR_USERNAME"

按经纬度查时区：

curl "http://api.geonames.org/timezoneJSON?lat=52.52&lng=13.41&username=YOUR_USERNAME"

国家信息：

curl "http://api.geonames.org/countryInfoJSON?username=YOUR_USERNAME"

认证方式

• 免费用户名（geonames.org → 注册）即密钥——通过 username= 参数传递。
• demo 账号可用但共享配额经常耗尽（实测）。

速率限制与注意事项

• 免费层：约 30,000 积分/天（每个注册用户名）；更高需付费。
• 服务：搜索、邮编、时区、国家信息、Wikipedia 链接、海拔等。
• 支持 HTTP（站点以 http 优先；多数端点支持 https）。
• fcl/fcode 字段分类地点（PPLC = 首都、PPL = 城镇……）。

常见问题

GeoNames 免费吗？ 是的——免费用户名约 3 万积分/天。

为什么 demo 失败？ 共享 demo 账号的配额经常耗尽——请注册自己的用户名。

有什么数据？ 地名、坐标、邮编、时区、国家数据和 Wikipedia 链接。