地理编码

地理编码 API 服务地址
`GET /integration/amap/v3/geocode/geo`

**请求头Headers**
| 名称 | 字段 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| wwtp-company | 公司 | 是 | urlencode utf-8编码 |
| wwtp-account | OA账号或手机号 | 是 | urlencode utf-8编码 |
| wwtp-area | 大区 | 否 | urlencode utf-8编码 |
| Authorization | token | 是 | Bearer token  [参考授权](https://mrdoc.wwuche.com/doc/41/)|
| X-map | 地图厂商 | 否 | 可选值：amap、baidu，默认高德 amap |

**请求参数**
| 参数 | 名称 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| address | 结构化地址信息 | 是 | 规则遵循：国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦，如：北京市朝阳区阜通东大街6号。 |
| city | 指定查询的城市 | 否 | 可选输入内容包括：指定城市的中文（如北京）、指定城市的中文全拼（beijing）、citycode（010）、adcode（110000），不支持县级市。当指定城市查询内容为空时，会进行全国范围内的地址转换检索。adcode 信息可参考 城市编码表 获取 |
| callback | 回调函数 | 否 | callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。 |

**返回结果参数说明**
响应结果的格式可以通过请求参数 output 指定，默认为 JSON 形式。
响应参数由中台包裹一层,data字段以高德响应字段作为标准，兼容百度响应结果
以下是返回参数说明：

```
{
    "code": 0,
    "msg": null,
    "data": {
        "status": "1", //返回结果状态值
        "info": "OK",  //返回状态说明
        "infocode": "10000", //返回结果数目
        "count": 1, //返回结果数目
        "geocodes": [  //地理编码信息列表
            {
                "formattedAddress": "四川省成都市",
                "country": "中国", //国家
                "province": "四川省", //地址所在的省份名
                "city": "成都市", //地址所在的城市名
                "citycode": "028", //城市编码
                "district": "", //地址所在的区
                "street": "", //街道
                "number": "", //门牌
                "adcode": "510100", //区域编码
                "location": "104.066301,30.572961", //坐标点
                "level": "市" //匹配级别
            }
        ]
    },
    "requestId": "4ab801fa55dc4908853e67a2fc89e749",
    "ok": true
}
```