周边查询-基础API-地理编码_信息查询服务(IQS)-阿里云帮助中心

本文介绍通过阿里云OpenAPI SDK调用周边查询-基础API-地理编码的方法以及参数说明。

地理编码

将详细的结构化地址转换为高德经纬度坐标，支持精确到建筑物名称。

重要

该接口目前仅面向特定受邀用户开放，暂未对所有用户公开。

API定义

接口名称

GeoCode

请求参数

参数名	含义及规则	是否必须	缺省值	参数样例
address	结构化地址信息。规则遵循：国家、省份、城市、区县、城镇、乡村、街道、门牌号码	必填	无	北京市朝阳区阜通东大街6号
city	指定查询的城市。可输入城市的中文、拼音全拼以及行政编码	可选	无	北京市

响应参数

参数名			类型	说明
requestId			string	请求id
data			list	返回的地点数据列表
	province		string	地点所属省份
	city		string	地点所属城市
	cityCode		string	地点所属城市编码
	district		string	地点所属区域
	districtCode		string	地点所属区域编码
	street		string	街道
	number		string	门牌
	longitude		string	坐标点的经度
	latitude		string	坐标点的纬度
	level		string	匹配级别，参见下方表格
	building		object	楼信息
		name	string	建筑名称
		type	string	POI 类型

地理编码匹配级别列表

匹配级别	示例
国家	中国
省	河北省、北京市
市	宁波市
区县	北京市朝阳区
开发区	亦庄经济开发区
乡镇	回龙观镇
村庄	三元村
热点商圈	上海市黄浦区老西门
道路	北京市朝阳区阜通东大街
道路交叉路口	北四环西路辅路/善缘街
兴趣点	北京市朝阳区奥林匹克公园(南门)
门牌号	朝阳区阜通东大街6号
单元号	望京西园四区5号楼2单元
楼层	保留字段，建议兼容
房间	保留字段，建议兼容
公交地铁站点	海淀黄庄站 A1西北口
门址（新增）	北京市朝阳区阜荣街10号
小巷（新增）	保留字段，建议兼容
住宅区（新增）	广西壮族自治区柳州市鱼峰区德润路华润凯旋门
未知	未确认级别的 POI

示例

响应示例

{
  "requestId": "2FCBD99B-3E17-1660-9672-82BF24B05C26",
  "success": true,
  "data": [
    {
      "number": "6号",
      "districtCode": "110105",
      "province": "北京市",
      "city": "北京市",
      "level": "门址",
      "cityCode": "010",
      "street": "阜通东大街",
      "district": "朝阳区",
      "latitude": "39.990496",
      "building": {
        "name": "",
        "type": ""
      },
      "longitude": "116.482086"
    },
    {
      "number": "6号院",
      "districtCode": "110105",
      "province": "北京市",
      "city": "北京市",
      "level": "门址",
      "cityCode": "010",
      "street": "阜通东大街",
      "district": "朝阳区",
      "latitude": "39.990039",
      "building": {
        "name": "",
        "type": ""
      },
      "longitude": "116.482145"
    }
  ]
}