目录

位置类API

功能介绍

根据经纬度信息，获取基础citycode信息。

接口原型

承载协议

HTTPS POST

接口方向

开发者服务器 -> 华为天气服务器

接口URL

{rootUrl}/v1/location/code

说明：

{rootUrl}：请参见站点信息

数据格式

请求消息：Content-Type: application/json

响应消息：Content-Type: application/json

请求参数

Request Header

参数

是否必选

参数类型

描述

Content-Type

是

String

取值为：application/json

Authorization

是

String

您动态获取的Access Token

说明：

Bearer后面拼接空格，再拼接获取的access_token

Request Body

参数

是否必选

参数类型

描述

location

是

Struct

经纬度信息，请参见location参数。

location

参数

是否必选

参数类型

描述

longitude

是

String

经度。

latitude

是

String

纬度。

locationsystem

否

String

定位坐标系。

  • GCJ02：火星坐标系
  • WGS84：标准坐标系（默认）

请求示例

GET {rootUrl}/v1/location/code
Content-Type:application/json
Authorization:Bearer {access_token}
{
  "location": {
    "longitude": "116.405285",    //经度
    "latitude": "39.904989",      //纬度
    "locationsystem": "WGS84"     //定位坐标系，火星坐标系：GCJ02;标准坐标系：WGS84（默认）
  }
}

响应参数

状态码为200时：

Response Header

参数

参数类型

描述

Content-Type

String

取值为：application/json

Response Body

参数

参数类型

描述

ret

String

返回码，具体请参见错误码

msg

String

返回值描述

data

Object

返回数据，具体请参见响应示例

requestid

String

请求id，用于查询日志

响应示例

HTTP/1.1 200 OK
Content-type: application/json
{
  "ret": 0,
  "msg": "success",
  "data": {
    "location": {
      "ca": "39.928353",
      "citycode": "57460",
      "co": "116.416357",
      "countrycode": "CN",
      "countryname": "中国",
      "englishcityname": "Dongcheng District",
      "englishcountryname": "China",
      "name": "东城区",
      "provincename": "北京市",
      "timezone": "Asia/Shanghai"
    }
  },
  "requestid": "xxxxxxxxxx"
}