地理/逆地理编码

##产品介绍##{#title:introduce}地理编码/逆地理编码API是一类简单的HTTP接口，提供结构化地址与

源代码编辑器
<div class="md-container"><h2 data-anchor="introduce" id="introduce">产品介绍</h2><p>地理编码/逆地理编码 API 是通过 HTTP/HTTPS 协议访问远程服务的接口，提供结构化地址与经纬度之间的相互转化的能力。</p><p><span class="red">结构化地址的定义： 首先，地址肯定是一串字符，内含国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦等建筑物名称。按照由大区域名称到小区域名称组合在一起的字符。一个有效的地址应该是独一无二的。注意：针对大陆、港、澳地区的地理编码转换时可以将国家信息选择性的忽略，但省、市、城镇等级别的地址构成是不能忽略的。暂时不支持返回台湾省的详细地址信息。</span></p><p>使用 API 前请您先注册高德账号<a href="https://lbs.amap.com/dev/key" class="" target="_blank">申请Key。</a></p><h2 data-anchor="scene" id="scene">适用场景&nbsp;</h2><ul>
  <li>地理编码：将详细的结构化地址转换为高德经纬度坐标。且支持对地标性名胜景区、建筑物名称解析为高德经纬度坐标。<br>
结构化地址举例：北京市朝阳区阜通东大街6号转换后经纬度：116.480881,39.989410 <br>
地标性建筑举例：天安门转换后经纬度：116.397499,39.908722</li>  <li>逆地理编码：将经纬度转换为详细结构化的地址，且返回附近周边的POI、AOI信息。<br>
例如：116.480881,39.989410 转换地址描述后：北京市朝阳区阜通东大街6号</li></ul><h2 data-anchor="limit" id="limit">使用限制</h2><p>详细的服务调用量限制可<a href="https://lbs.amap.com/api/webservice/guide/tools/flowlevel" class="" target="_blank">点我查阅</a>。</p><h2 data-anchor="instructions" id="instructions">使用说明</h2><p>第一步，<a href="https://lbs.amap.com/dev/" class="" target="_blank">申请Web服务API类型Key</a>；</p><p>第二步，参考接口参数文档发起HTTP/HTTPS请求，第一步申请的 Key 需作为必填参数一同发送；</p><p>第三步，接收请求返回的数据（JSON或XML格式），参考返回参数文档解析数据。</p><p>如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。</p><h2 data-anchor="geo" id="geo">地理编码</h2><ul>
  <li><strong>地理编码 API 服务地址</strong></li></ul><div class="md-atomic"><div class="table-container" style="width:70%;"><table class="md-table common " data-meta="%7B%22width%22%3A%2270%25%22%2C%22type%22%3A%22common%22%7D"><tbody><tr><td style="white-space:nowrap;"><p>URL</p></td><td><p>https://restapi.amap.com/v3/geocode/geo?parameters</p></td></tr><tr><td style="white-space:nowrap;"><p>请求方式</p></td><td><p>GET</p></td></tr></tbody></table></div></div><p><em>parameters</em>代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&amp;)进行分隔。下面的列表枚举了这些参数及其使用规则。</p><ul>
  <li><strong>请求参数</strong></li></ul><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table  md-table  " data-meta="%7B%22class%22%3A%22md-table%20%20%22%2C%22width%22%3A%22100%25%22%7D"><tbody><tr><th style="white-space:nowrap;"><p>参数名</p></th><th style="white-space:nowrap;"><p>含义</p></th><th><p>规则说明</p></th><th style="white-space:nowrap;"><p>是否必须</p></th><th style="white-space:nowrap;"><p>缺省值</p></th></tr><tr><td style="white-space:nowrap;"><p>key</p></td><td style="white-space:nowrap;"><p>高德Key</p></td><td><p>用户在高德地图官网<a href="https://lbs.amap.com/dev/" class="" target="_blank">申请Web服务API类型Key</a></p></td><td style="white-space:nowrap;"><p>必填</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td style="white-space:nowrap;"><p>address</p></td><td style="white-space:nowrap;"><p>结构化地址信息</p></td><td><p>规则遵循：国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦，如：北京市朝阳区阜通东大街6号。</p></td><td style="white-space:nowrap;"><p>必填</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td style="white-space:nowrap;"><p>city</p></td><td style="white-space:nowrap;"><p>指定查询的城市</p></td><td><p>可选输入内容包括：指定城市的中文（如北京）、指定城市的中文全拼（beijing）、citycode（010）、adcode（110000），不支持县级市。当指定城市查询内容为空时，会进行全国范围内的地址转换检索。</p><p>adcode信息可参考<a href="https://lbs.amap.com/api/webservice/download" class="" target="_blank">城市编码表</a>获取</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无，会进行全国范围内搜索</p></td></tr><tr><td style="white-space:nowrap;"><p>sig</p></td><td style="white-space:nowrap;"><p>数字签名</p></td><td><p>请参考<a href="https://lbs.amap.com/faq/account/key/72" class="" target="_blank">数字签名获取和使用方法</a></p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td style="white-space:nowrap;"><p>output</p></td><td style="white-space:nowrap;"><p>返回数据格式类型</p></td><td><p>可选输入内容包括：JSON，XML。设置 JSON 返回结果数据将会以JSON结构构成；如果设置 XML 返回结果数据将以 XML 结构构成。</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>JSON</p></td></tr><tr><td style="white-space:nowrap;"><p>callback</p></td><td style="white-space:nowrap;"><p>回调函数</p></td><td><p>callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无</p></td></tr></tbody></table></div></div><ul>
  <li><strong>返回结果参数说明</strong></li></ul><p>响应结果的格式可以通过请求参数 output 指定，默认为 JSON 形式。</p><p>以下是返回参数说明：</p><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table  " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="3"><p>名称</p></th><th><p>含义</p></th><th><p>规则说明</p></th></tr><tr><td colspan="3"><p>status</p></td><td><p>返回结果状态值</p></td><td><p>返回值为 0 或 1，0 表示请求失败；1 表示请求成功。</p></td></tr><tr><td colspan="3"><p>count</p></td><td><p>返回结果数目</p></td><td><p>返回结果的个数。</p></td></tr><tr><td colspan="3"><p>info</p></td><td><p>返回状态说明</p></td><td><p>当 status 为 0 时，info 会返回具体错误原因，否则返回“OK”。详情可以参阅<a href="https://lbs.amap.com/api/webservice/guide/tools/info" class="" target="_blank">info状态表</a></p></td></tr><tr><td colspan="3"><p>geocodes</p></td><td><p>地理编码信息列表</p></td><td><p>结果对象列表，包括下述字段：</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td colspan="2"><p>country</p></td><td><p>国家</p></td><td><p>国内地址默认返回中国</p></td></tr><tr><td><p><br></p></td><td colspan="2"><p>province</p></td><td><p>地址所在的省份名</p></td><td><p>例如：北京市。此处需要注意的是，中国的四大直辖市也算作省级单位。</p></td></tr><tr><td><p><br></p></td><td colspan="2"><p>city</p></td><td><p>地址所在的城市名</p></td><td><p>例如：北京市</p></td></tr><tr><td><p><br></p></td><td colspan="2"><p>citycode</p></td><td><p>城市编码</p></td><td><p>例如：010</p></td></tr><tr><td><p><br></p></td><td colspan="2"><p>district</p></td><td><p>地址所在的区</p></td><td><p>例如：朝阳区</p></td></tr><tr><td><p><br></p></td><td colspan="2"><p>street</p></td><td><p>街道</p></td><td><p>例如：阜通东大街</p></td></tr><tr><td><p><br></p></td><td colspan="2"><p>number</p></td><td><p>门牌</p></td><td><p>例如：6号</p></td></tr><tr><td><p><br></p></td><td colspan="2"><p>adcode</p></td><td><p>区域编码</p></td><td><p>例如：110101</p></td></tr><tr><td><p><br></p></td><td colspan="2"><p>location</p></td><td><p>坐标点</p></td><td><p>经度，纬度</p></td></tr><tr><td><p><br></p></td><td colspan="2"><p>level</p></td><td><p>匹配级别</p></td><td><p>参见下方的地理编码匹配级别列表</p></td></tr></tbody></table></div></div><ul>
  <li><strong>服务示例</strong></li></ul><pre><code>https://restapi.amap.com/v3/geocode/geo?address=北京市朝阳区阜通东大街6号&amp;output=XML&amp;key=&lt;用户的key&gt;</code></pre><div class="md-atomic"><div class="restdemo-container" style="white-space:normal;"><table data-type="geocode/geo" data-name="地理编码">
    <thead>
        <tr>
            <th>
                参数
            </th>            <th>
                值
            </th>            <th>
                备注
            </th>            <th>
                必选
            </th>        </tr>    </thead>    <tbody>
        <tr>
            <td>
                address
            </td>            <td>
                <input name="address" type="text" value="北京市朝阳区阜通东大街6号">
                            </td>            <td>
                填写结构化地址信息:省份＋城市＋区县＋城镇＋乡村＋街道＋门牌号码
            </td>            <td>
                是
            </td>        </tr>        <tr>
            <td>
                city
            </td>            <td>
                <input name="city" type="text" value="北京">
                            </td>            <td>
                查询城市，可选：城市中文、中文全拼、citycode、adcode
            </td>            <td>
                否
            </td>        </tr>    </tbody></table></div></div><p>示例说明：address 是需要获取坐标的结构化地址，output（XML）用于指定返回数据的格式，Key是用户请求数据的身份标识，详细可以参考上方的请求参数说明。</p><h2 data-anchor="regeo" id="regeo">逆地理编码</h2><ul>
  <li><strong>逆地理编码API服务地址</strong></li></ul><div class="md-atomic"><div class="table-container" style="width:70%;"><table class="md-table common " data-meta="%7B%22width%22%3A%2270%25%22%2C%22type%22%3A%22common%22%7D"><tbody><tr><td style="white-space:nowrap;"><p>URL</p></td><td><p>https://restapi.amap.com/v3/geocode/regeo?parameters</p></td></tr><tr><td style="white-space:nowrap;"><p>请求方式</p></td><td><p>GET</p></td></tr></tbody></table></div></div><p><em>parameters</em>代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&amp;)进行分隔。下面的列表枚举了这些参数及其使用规则。</p><ul>
  <li><strong>请求参数</strong></li></ul><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table  " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="2" style="white-space:nowrap;"><p>参数名</p></th><th style="white-space:nowrap;"><p>含义</p></th><th><p>规则说明</p></th><th style="white-space:nowrap;"><p>是否必须</p></th><th style="white-space:nowrap;"><p>缺省值</p></th></tr><tr><td colspan="2" style="white-space:nowrap;"><p>key</p></td><td style="white-space:nowrap;"><p>高德Key</p></td><td><p>用户在高德地图官网<a href="https://lbs.amap.com/dev/" class="" target="_blank">申请Web服务API类型Key</a></p></td><td style="white-space:nowrap;"><p>必填</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>location</p></td><td style="white-space:nowrap;"><p>经纬度坐标</p></td><td><p>传入内容规则：经度在前，纬度在后，经纬度间以“,”分割，经纬度小数点后不要超过 6 位。</p></td><td style="white-space:nowrap;"><p>必填</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>poitype</p></td><td style="white-space:nowrap;"><p>返回附近POI类型</p></td><td><p>以下内容需要 extensions 参数为 all 时才生效。</p><p>逆地理编码在进行坐标解析之后不仅可以返回地址描述，也可以返回经纬度附近符合限定要求的POI内容（在 extensions 字段值为 all 时才会返回POI内容）。设置 POI 类型参数相当于为上述操作限定要求。参数仅支持传入POI TYPECODE，可以传入多个POI TYPECODE，相互之间用“|”分隔。获取 POI TYPECODE 可以参考<a href="https://a.amap.com/lbs/static/amap_3dmap_lite/amap_poicode.zip" class="" target="">POI分类码表</a></p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>radius</p></td><td style="white-space:nowrap;"><p>搜索半径</p></td><td><p>radius取值范围在0~3000，默认是1000。单位：米</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>1000</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>extensions</p></td><td style="white-space:nowrap;"><p>返回结果控制</p></td><td><p>extensions 参数默认取值是 base，也就是返回基本地址信息；</p><p>extensions 参数取值为 all 时会返回基本地址信息、附近 POI 内容、道路信息以及道路交叉口信息。</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>base</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>roadlevel</p></td><td style="white-space:nowrap;"><p>道路等级</p></td><td><p>以下内容需要 extensions 参数为 all 时才生效。</p><p>可选值：0，1 <br>
当roadlevel=0时，显示所有道路 <br>
当roadlevel=1时，过滤非主干道路，仅输出主干道路数据&nbsp;</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>sig</p></td><td style="white-space:nowrap;"><p>数字签名</p></td><td><p>请参考<a href="https://lbs.amap.com/faq/account/key/72" class="" target="_blank">数字签名获取和使用方法</a></p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>output</p></td><td style="white-space:nowrap;"><p>返回数据格式类型</p></td><td><p>可选输入内容包括：JSON，XML。设置 JSON 返回结果数据将会以JSON结构构成；如果设置 XML 返回结果数据将以 XML 结构构成。</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>JSON</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>callback</p></td><td style="white-space:nowrap;"><p>回调函数</p></td><td><p>callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>homeorcorp</p></td><td style="white-space:nowrap;"><p>是否优化POI返回顺序</p></td><td><p>以下内容需要 extensions 参数为 all 时才生效。</p><p>homeorcorp 参数的设置可以影响召回 POI 内容的排序策略，目前提供三个可选参数：</p><p>0：不对召回的排序策略进行干扰。</p><p>1：综合大数据分析将居家相关的 POI 内容优先返回，即优化返回结果中 pois 字段的poi顺序。</p><p>2：综合大数据分析将公司相关的 POI 内容优先返回，即优化返回结果中 pois 字段的poi顺序。</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>0</p></td></tr></tbody></table></div></div><ul>
  <li><strong>返回结果参数说明</strong></li></ul><p>逆地理编码的响应结果的格式由请求参数output指定。</p>
<div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table  " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="4" style="white-space:nowrap;"><p>名称</p></th><th><p>含义</p></th><th><p>规则说明</p></th></tr><tr><td colspan="4" style="white-space:nowrap;"><p>status</p></td><td><p>返回结果状态值</p></td><td><p>返回值为 0 或 1，0 表示请求失败；1 表示请求成功。</p></td></tr><tr><td colspan="4" style="white-space:nowrap;"><p>info</p></td><td><p>返回状态说明</p></td><td><p>当 status 为 0 时，info 会返回具体错误原因，否则返回“OK”。详情可以参考</p><p><a href="https://lbs.amap.com/api/webservice/guide/tools/info" class="" target="_blank">info状态表</a></p></td></tr><tr><td colspan="4" style="white-space:nowrap;"><p>regeocode</p></td><td><p>逆地理编码列表</p></td><td><p>返回 regeocode 对象；regeocode 对象包含的数据如下：</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td colspan="3" style="white-space:nowrap;"><p>addressComponent</p></td><td><p>地址元素列表</p></td><td><p><br></p></td></tr><tr><td rowspan="25" colspan="2" style="white-space:nowrap;"><p><br></p></td><td colspan="2" style="white-space:nowrap;"><p>country</p></td><td><p>坐标点所在国家名称</p></td><td><p>例如：中国</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>&nbsp;</p><p>province</p></td><td><p>&nbsp;坐标点所在省名称&nbsp;</p></td><td><p>&nbsp;例如：北京市&nbsp;</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>city</p></td><td><p>坐标点所在城市名称</p></td><td><p>请注意：当城市是省直辖县时返回为空，以及城市为北京、上海、天津、重庆四个直辖市时，该字段返回为空；<a href="https://lbs.amap.com/faq/webservice/webservice-api/geocoding/43267" class="" target="_blank">省直辖县列表</a></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>citycode</p></td><td><p>城市编码</p></td><td><p>例如：010</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>district</p></td><td><p>坐标点所在区</p></td><td><p>例如：海淀区</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>adcode</p></td><td><p>行政区编码</p></td><td><p>例如：110108</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>township</p></td><td><p>坐标点所在乡镇/街道（此街道为社区街道，不是道路信息）</p></td><td><p>例如：燕园街道</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>towncode</p></td><td><p>乡镇街道编码</p></td><td><p>例如：110101001000</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>neighborhood</p></td><td><p>社区信息列表</p></td><td><p><br></p></td></tr><tr><td rowspan="2" style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>name</p></td><td><p>社区名称</p></td><td><p>例如：北京大学</p></td></tr><tr><td style="white-space:nowrap;"><p>type</p></td><td><p>POI类型</p></td><td><p>例如：科教文化服务;学校;高等院校</p><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>building</p></td><td><p>楼信息列表</p></td><td><p><br></p></td></tr><tr><td rowspan="2" style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>name</p></td><td><p>建筑名称</p></td><td><p>例如：万达广场</p></td></tr><tr><td style="white-space:nowrap;"><p>type</p></td><td><p>类型</p></td><td><p>例如：科教文化服务;学校;高等院校</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>streetNumber</p></td><td><p>门牌信息列表</p></td><td><p><br></p></td></tr><tr><td rowspan="5" style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>street</p></td><td><p>街道名称</p></td><td><p>例如：中关村北二条</p></td></tr><tr><td style="white-space:nowrap;"><p>number</p></td><td><p>门牌号</p></td><td><p>例如：3号</p></td></tr><tr><td style="white-space:nowrap;"><p>location</p></td><td><p>坐标点</p></td><td><p>经纬度坐标点：经度，纬度</p></td></tr><tr><td style="white-space:nowrap;"><p>direction</p></td><td><p>方向</p></td><td><p>坐标点所处街道方位</p></td></tr><tr><td style="white-space:nowrap;"><p>distance</p></td><td><p>门牌地址到请求坐标的距离</p></td><td><p>单位：米</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>seaArea</p></td><td><p>所属海域信息</p></td><td><p>例如：渤海</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>businessAreas</p></td><td><p>经纬度所属商圈列表</p></td><td><p><br></p></td></tr><tr><td rowspan="4" style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>businessArea</p></td><td><p>商圈信息</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p>location</p></td><td><p>商圈中心点经纬度</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p>name</p></td><td><p>&nbsp;商圈名称&nbsp;</p></td><td><p>&nbsp;例如：颐和园&nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>id</p></td><td><p>&nbsp;商圈所在区域的adcode&nbsp;</p></td><td><p>&nbsp;例如：朝阳区/海淀区&nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td colspan="3" style="white-space:nowrap;"><p>roads</p></td><td><p>道路信息列表</p></td><td><p>请求参数 extensions 为 all 时返回如下内容</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td rowspan="6" style="white-space:nowrap;"><p><br></p></td><td colspan="2" style="white-space:nowrap;"><p>road</p></td><td><p>道路信息</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td rowspan="5" style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>id</p></td><td><p>道路id</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>name</p></td><td><p>道路名称</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>distance</p></td><td><p>道路到请求坐标的距离</p></td><td><p>单位：米</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>direction</p></td><td><p>方位</p></td><td><p>输入点和此路的相对方位</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>location</p></td><td><p>坐标点</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td colspan="3" style="white-space:nowrap;"><p>roadinters</p></td><td><p>道路交叉口列表</p></td><td><p>请求参数 extensions 为 all 时返回如下内容</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td rowspan="8" style="white-space:nowrap;"><p><br></p></td><td colspan="2" style="white-space:nowrap;"><p>roadinter</p></td><td><p>道路交叉口</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td rowspan="7" style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>distance</p></td><td><p>交叉路口到请求坐标的距离</p></td><td><p>单位：米</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>direction</p></td><td><p>方位</p></td><td><p>输入点相对路口的方位</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>location</p></td><td><p>路口经纬度</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>first_id</p></td><td><p>第一条道路id</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>first_name</p></td><td><p>第一条道路名称</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>second_id</p></td><td><p>第二条道路id</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>second_name</p></td><td><p>第二条道路名称</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td colspan="3" style="white-space:nowrap;"><p>pois</p></td><td><p>poi信息列表</p></td><td><p>请求参数 extensions 为 all 时返回如下内容</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td rowspan="10" style="white-space:nowrap;"><p><br></p></td><td colspan="2" style="white-space:nowrap;"><p>poi</p></td><td><p>poi信息列表</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td rowspan="9" style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>id</p></td><td><p>poi的id</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>name</p></td><td><p>poi点名称</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>type</p></td><td><p>poi类型</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>tel</p></td><td><p>电话</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>distance</p></td><td><p>该POI的中心点到请求坐标的距离</p></td><td><p>单位：米</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>direction</p></td><td><p>方向</p></td><td><p>为输入点相对建筑物的方位</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>address</p></td><td><p>poi地址信息</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>location</p></td><td><p>坐标点</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>businessarea</p></td><td><p>poi所在商圈名称</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td colspan="3" style="white-space:nowrap;"><p>aois</p></td><td><p>aoi信息列表</p></td><td><p>请求参数 extensions 为 all 时返回如下内容</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td rowspan="8" style="white-space:nowrap;"><p><br></p></td><td colspan="2" style="white-space:nowrap;"><p>aoi</p></td><td><p>aoi信息</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td rowspan="7" style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>id</p></td><td><p>所属 aoi的id</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>name</p></td><td><p>所属 aoi 名称</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>adcode</p></td><td><p>所属 aoi 所在区域编码</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>location</p></td><td><p>所属 aoi 中心点坐标</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>area</p></td><td><p>所属aoi点面积</p></td><td><p>单位：平方米</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>distance</p></td><td><p>输入经纬度是否在aoi面之中</p></td><td><p>&nbsp;0，代表在aoi内</p><p>其余整数代表距离AOI的距离</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>type</p></td><td><p>所属 aoi 类型</p></td><td><p><br></p></td></tr></tbody></table></div></div><ul>
  <li><strong>服务示例</strong></li></ul><pre><code>https://restapi.amap.com/v3/geocode/regeo?output=xml&amp;location=116.310003,39.991957&amp;key=&lt;用户的key&gt;&amp;radius=1000&amp;extensions=all </code></pre><div class="md-atomic"><div class="restdemo-container" style="white-space:normal;"><table data-type="geocode/regeo" data-name="逆地理编码">
    <thead>
        <tr>
            <th>
                参数
            </th>            <th>
                值
            </th>            <th>
                备注
            </th>            <th>
                必选
            </th>        </tr>    </thead>    <tbody>
        <tr>
            <td>
                location
            </td>            <td>
                <input name="location" type="text" value="116.481488,39.990464">
                            </td>            <td>
                经纬度坐标;
            </td>            <td>
                是
            </td>        </tr>        <tr>
            <td>
                poitype
            </td>            <td>
                <input name="poitype" type="text" value="商务写字楼">
                            </td>            <td>
                支持传入POI TYPECODE及名称；支持传入多个POI类型，多值间用“|”分隔
            </td>            <td>
                否
            </td>        </tr>        <tr>
            <td>
                radius
            </td>            <td>
                <input name="radius" type="text" value="1000">
                            </td>            <td>
                查询POI的半径范围。取值范围：0~3000,单位：米
            </td>            <td>
                否
            </td>        </tr>        <tr>
            <td>
                extensions
            </td>            <td>
                <select name="extensions">
                    <option value="all">
                        all
                    </option>                    <option value="base">
                        base
                    </option>                </select>            </td>            <td>
                返回结果控制
            </td>            <td>
                否
            </td>        </tr>        <tr>
            <td>
                roadlevel
            </td>            <td>
                <input name="roadlevel" type="text" value="0">
                            </td>            <td>
                可选值：1，当roadlevel=1时，过滤非主干道路，仅输出主干道路数据
            </td>            <td>
                否
            </td>        </tr>    </tbody></table></div></div><p>说明：location(116.310003,39.991957) 是所需要转换的坐标点经纬度，radius（1000）为返回的附近POI的范围，单位：米，extensions(all)为返回的数据内容，output（XML）用于指定返回数据的格式，Key 是高德Web服务 Key。详细可以参考上方的请求参数说明。</p><h2 data-anchor="geo_list" id="geo_list">地理编码匹配级别列表</h2><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table  " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th style="white-space:nowrap;"><p>匹配级别</p></th><th><p>示例</p></th></tr><tr><td style="white-space:nowrap;"><p>国家</p></td><td><p>中国</p></td></tr><tr><td style="white-space:nowrap;"><p>省</p></td><td><p>河北省、北京市</p></td></tr><tr><td style="white-space:nowrap;"><p>市</p></td><td><p>&nbsp;宁波市 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>区县</p></td><td><p>北京市朝阳区</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;开发区 &nbsp;</p></td><td><p>&nbsp;亦庄经济开发区 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;乡镇 &nbsp;</p></td><td><p>&nbsp;回龙观镇 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;村庄 &nbsp;</p></td><td><p>&nbsp;三元村 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;热点商圈 &nbsp;</p></td><td><p>&nbsp;上海市黄浦区老西门 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;道路 &nbsp;</p></td><td><p>&nbsp;北京市朝阳区阜通东大街 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;道路交叉路口 &nbsp;</p></td><td><p>&nbsp;北四环西路辅路/善缘街 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;兴趣点 &nbsp;</p></td><td><p>&nbsp;北京市朝阳区奥林匹克公园(南门) &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;门牌号 &nbsp;</p></td><td><p>&nbsp;朝阳区阜通东大街6号 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;单元号 &nbsp;</p></td><td><p>&nbsp;望京西园四区5号楼2单元 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;楼层 &nbsp;</p></td><td><p>&nbsp;保留字段，建议兼容</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;房间 &nbsp;</p></td><td><p>&nbsp;保留字段，建议兼容</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;公交地铁站点 &nbsp;</p></td><td><p>&nbsp;海淀黄庄站A1西北口 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;门址 &nbsp;（新增）</p></td><td><p>&nbsp;北京市朝阳区阜荣街10号 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;小巷（新增） &nbsp;</p></td><td><p>&nbsp;保留字段，建议兼容</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;住宅区（新增） &nbsp;</p></td><td><p>&nbsp;广西壮族自治区柳州市鱼峰区德润路华润凯旋门 &nbsp;</p></td></tr><tr><td style="white-space:nowrap;"><p>&nbsp;未知 &nbsp;</p></td><td><p>&nbsp;未确认级别的POI &nbsp;</p></td></tr></tbody></table></div></div><p><br></p><p><br></p></div>
控制台
清空
返回顶部示例中心常见问题智能客服公众号
二维码