地理编码
优质
小牛编辑
129浏览
2023-12-01
地理编码服务可以根据用户输入的地址描述和城市范围返回对应的地理坐标和结构化的地址详细描述。
使用服务前需要先申请 key。
资源服务地址：https://www.supermapol.com/iserver/services/location-china/rest/locationanalyst/China/geocoding
资源接口参数说明
地理编码服务支持GET和HEAD请求，支持json\xml\jsonp等格式
GET 请求参数
| 参数名 | 类型 | 默认值 | 范例 | 是否必须 | 描述 |
|---|---|---|---|---|---|
| address | String | 无 | 朝阳区酒仙桥北路超图软件 | 是 | 地址描述指定需要地理编码分析的具体地址描述。传入单个地址时，格式：address=超图软件，返回单个地址的匹配结果；batch=true时，address可批量传入多个地址（最多10个，使用英文逗号分隔），格式：batch=true&address=超图软件,58同城,百度大厦，返回相应个数的匹配结果。如果batch设置为false，即使address传入多个地址也按照一个地址进行解析。 |
| city | String | 无 | 北京市 | 是 | 城市名称用来指定地理编码分析的范围 |
| batch | boolean | false | true | 否 | 设置批量请求参数，设置为true时进行批量查询操作。 |
| maxResult | int | 1 | 3 | 否 | 设置最多返回几条匹配结果 |
| to | int | 910101 | 910101 | 否 | 输出结果坐标类型。枚举值：910101、910111、910102、910112、910113。坐标类型编码参考坐标类型。 |
以数组形式返回结果如下
| 名称 | 类型 | 描述 | |
|---|---|---|---|
| location | Point2D | 匹配输入地址描述的地理坐标 | |
| x | double | 地理坐标经度值 | |
| y | double | 地理坐标纬度值 | |
| name | String | 匹配的数据记录名称 | |
| formatedAddress | String | 符合地理编码规范的规范地名地址描述 | |
| address | AddressComponent | 详细地址信息 | |
| province | String | 省级地址描述（省、直辖市、省级民族自治区、特别行政区） | |
| city | String | 市级地址描述 | |
| cityCode | String | 市级地址编码 | |
| county | String | 县级地址描述（县、县级市、区） | |
| countyCode | String | 县级地址编码 | |
| town | String | 乡镇/街道地址描述（此街道为社区街道，不是道路信息） | |
| streetNumber | StreetNumber | 街道、门号信息 | |
| geometry | Geometry | 匹配输入地址描述具体几何对象 | |
Geometry 类接口说明如下：
| 字段 | 类型 | 含义 |
|---|---|---|
| id | int | 几何对象唯一标识符 |
| points | Point2D[] | 组成几何对象的节点的二维坐标对数组 |
| parts | int[] | 描述几何对象中各个子对象所包含的节点的个数 |
| type | GeometryType | 几何对象的类型，枚举值：POINT、LINE、REGION等 |
StreetNumber类接口说明如下：
| 字段 | 类型 | 含义 |
|---|---|---|
| distance | String | 门牌地址到请求坐标的距离(m) |
| number | String | 门牌号 |
| street | String | 街道名称 |
服务示例
https://www.supermapol.com/iserver/services/location-china/rest/locationanalyst/China/ geocoding.json?address=朝阳区酒仙桥北路超图软件&city=北京市&key=fvV2osxwuZWlY0wJb8FEb2i5
| 参数名 | 值 | 备注 |
|---|---|---|
| address | 朝阳区酒仙桥北路超图软件 | 具体地址描述：区+街道+门牌号 |
| city | 北京市 | 查询城市：市 |
响应结果
[{
"address": {
"countyCode": "110105",
"province": "北京市",
"town": "",
"city": "北京市",
"townCode": null,
"streetNumber": {
"number": "",
"distance": "",
"street": ""
},
"cityCode": "010",
"county": "朝阳区"
},
"confidence": 0,
"name": null,
"formatedAddress": "北京市朝阳区超图软件",
"location": {
"x": 116.505722,
"y": 39.985586
},
"geometry": null
}]