城市搜索

基本调用

• 认证与鉴权 | 错误信息

curl "https://singer.caiyunhub.com/v3/cartography/city_search?token=token&query=北京&limit=2"

请求参数:

参数名	类型	说明
query	string	查询关键词
limit	int	限制返回条数，默认为 10，最大可设置为 20

查询结果如下：

{
  "result": [
    {
      "name": "北京市",
      "level": 3,
      "location": {
        "latitude": 39.904989,
        "longitude": 116.405285
      },
      "city_code": "g_wx4g0b7xrtpe", // 可以代替经纬度进行天气查询
      "parents": [
        {
          "name": "中国",
          "level": 1,
          "adcode": "100000"
        },
        {
          "name": "北京市",
          "level": 2,
          "adcode": "110000"
        }
      ],
      "timezone": "Asia/Shanghai",
      "adcode": "110100" // 国内会返回行政区编码，区县级别以下的行政区和海外不返回此字段
    },
    {
      "name": "东城区",
      "level": 4,
      "location": {
        "latitude": 39.928359,
        "longitude": 116.416334
      },
      "city_code": "g_wx4g1hez91w7",
      "parents": [
        {
          "name": "中国",
          "level": 1,
          "adcode": "100000"
        },
        {
          "name": "北京市",
          "level": 2,
          "adcode": "110000"
        },
        {
          "name": "北京市",
          "level": 3,
          "adcode": "110100"
        }
      ],
      "timezone": "Asia/Shanghai",
      "adcode": "110101"
    }
  ]
}

多语言设置

curl "https://singer.caiyunhub.com/v3/cartography/city_search?token=token&query=北京&limit=1" \
     -H 'Accept-Language: en-US'

{
  "result": [
    {
      "name": "Beijing",
      "level": 3,
      "location": {
        "latitude": 39.904989,
        "longitude": 116.405285
      },
      "city_code": "g_wx4g0b7xrtpe",
      "parents": [
        {
          "name": "China",
          "level": 1,
          "adcode": "100000"
        },
        {
          "name": "Beijing",
          "level": 2,
          "adcode": "110000"
        }
      ],
      "timezone": "Asia/Shanghai",
      "adcode": "110100"
    }
  ]
}

地点级别（level）

值	含义
1	国家
2	省 / 州 / 都道府县
3	城市（地级市 / 县级市 / 市）
4	区 / 县
5	镇 / 街道 / 町
6	村 / 社区
7	AOI（兴趣区域）
8	POI（兴趣点）