定位API参数
请求参数 | 响应参数
定位API查询字符串参数
| 参数 | 说明 | 默认值 | |
| api | 正式开发使用的主机名称: api.weathercn.com | N/A | 必选 |
| apidev | 测试开发使用的主机名称: apidev.weathercn.com | N/A | 必选 |
| apikey | 用以在API里验证与授权使用的用户密钥。 | N/A | 必选 |
| version | 当前API版本 | v1 | 必选 |
| q | 匹配文字 | N/A | 必选 |
| locationkey | 用以搜索指定地点的特定ID | N/A | 必选 |
| format | 响应格式 | JSON | 可选 |
| language | 指定响应数据语言的字符串 | en-us | 可选 |
| countryCode | 特定国家代码ID | No filter | 可选 |
| adminCode | 特定行政区域代码ID | No filter | 可选 |
| details | 用以判断是否在地点里包括相关细节的布尔值 | False | 可选 |
| alias | 用以判断是否在结果中包括别名的列举值。默认只有无官方名字的情况下返回别名。列举值: Never 从不或Always 总是 | NoOfficialMatchFound | 可选 |
| offset | 请求响应的第一资源数量整数（限制25）。如果没有提供offset，最大数（100）个结果将会返回 | 0 | 可选 |
| group | 请求响应的城市数量。目前支持数值为50,100,150 | N/A | 必选 |
| type | 兴趣点特定类型 (只适用于兴趣点搜索) | No filter | 可选 |
| cityID | 用以搜索指定地点的特定ID，与locationkey一样 | N/A | 必选 |
| partnerID | 用于在the Designated Marketing Area (DMA指定营销地区)上识别展示合作方的特定数字ID。 | Null | 可选 |
| toplevel | 用于GeoPosition。 当使用经纬度搜索时toplevel=true，最高排名的城市将会返回。大城市的排名会高于城市内的区域排名，所以当toplevel=true时将返回一个更通用的定位结果。 (示例: 40.73,-74.00 当toplevel=false时返回 Greenwich Village, NY 当 toplevel=false. 当 toplevel=true, 同样的经纬度将返回 New York, NY.) | False | 可选 |
定位API响应参数
| 参数 | 说明 | |
| Version | 当前API版本 | |
| Key | 用以搜索指定地点的特定ID | |
| Type | 定位种类（城市，邮编，兴趣点或经纬度） | |
| Rank | 取决于地点人口，政治重要性以及地理大小因素的排名数 | |
| LocalizedName | URL显示根据语言代码的本地化地点名称。 默认为US English (us-en) 美式英语 | |
| EnglishName | 地点英文名 | |
| PrimaryPostalCode | 由定位数据供应商提供的定位官方邮编号码 | |
| Region | 地区 |
| Country | 国家 |
| AdministrativeArea | 行政区域 |
| TimeZone | 时区 |
| GeoPosition | 地理定位 |
| IsAlias | 判断一个地点是否使用别名的布尔值。true“是” 或false“否” |
| SupplementalAdminAreas | 附加行政区域 |
| Details | 特定地点的相关细节 |