城市搜索
根据城市ID、中文、英文、拼音、IP、经纬度搜索匹配的城市。
请求地址示例
- 用城市ID搜索 https://api.seniverse.com/v3/location/search.json?key=your_api_key&q=WX4FBXXFKE4F
- 用城市中文搜索 https://api.seniverse.com/v3/location/search.json?key=your_api_key&q=北京
- 用城市英文搜索 https://api.seniverse.com/v3/location/search.json?key=your_api_key&q=beijing
- 用城市拼音缩写搜索 https://api.seniverse.com/v3/location/search.json?key=your_api_key&q=bj
- 用IP地址搜索 https://api.seniverse.com/v3/location/search.json?key=your_api_key&q=220.181.111.86
- 用经纬度搜索 https://api.seniverse.com/v3/location/search.json?key=your_api_key&q=39.93:116.40
- 用省市名称限定搜索 https://api.seniverse.com/v3/location/search.json?key=your_api_key&q=辽宁朝阳
- 搜索所有中英文名称中包含“san”的城市,返回第2页的10个结果 https://api.seniverse.com/v3/location/search.json?key=your_api_key&q=san&limit=10&offset=10
参数
参数名 | 类型 | 默认值 | 必须 | 备注 |
---|---|---|---|---|
key | String | 无 | 是 | 你的API密钥 |
location | Location | 无 | 是 | 所查询的位置 |
language | Language | zh-Hans | 否 | 语言 |
limit | Int | 50 | 否 | 分页每页最多记录数 |
offset | Int | 0 | 否 | 跳过的记录数 (可选) 配合limit参数实现分页 |
返回结果
{
"results": [{
"id": "WX4EQ2XJD7V2", //城市ID
"name": "海淀", //城市名称
"country": "CN", //国家代码
"path": "海淀,北京,中国", //隶属层级,从小到大
"timezone": "Asia/Shanghai", //IANA标准时区名称(该名称不受夏令时影响)
"timezone_offset": "+08:00" //相对于UTC时区的偏移量(采用夏令时的城市会因夏令时而变化)
}]
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10