逆地理编码_腾讯版
<h3>接口描述</h3>
<ul>
<li>全球逆地理编码服务提供将坐标点（经纬度）转换为对应位置信息（如所在行政区划，周边地标点分布）功能。
支持根据输入经纬度，获取：
1 . 经纬度所在省、市、区、乡镇、门牌号、行政区划代码，及周边参考位置信息，如道路及交叉口、河流、湖泊、桥等
2 . 通过知名地点、地标组合形成的易于理解的地址，如：北京市海淀区中钢国际广场(欧美汇购物中心北)。
3 . 商圈、附近知名的一级地标、代表当前位置的二级地标等。
4 . 周边POI（AOI）列表。</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/geocode/ttmap/regeo/query</code></p>
<h3>请求方式</h3>
<ul>
<li>POST</li>
</ul>
<h3>请求格式</h3>
<ul>
<li>x-www-form-urlencoded</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>是</td>
<td>当前时间戳</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名，详见签名算法说明</td>
</tr>
<tr>
<td>location</td>
<td>String</td>
<td>是</td>
<td>经纬度（GCJ02坐标系），格式：纬度,经度。例如：120.067824,31.413068。</td>
</tr>
<tr>
<td>radius</td>
<td>Integer</td>
<td>否</td>
<td>解析行政区划的吸附半径，如入参经纬度在近海海域（未在任何行政区划内），可设置此参数解析返回在该半么范围内最近的行政区划信息。单位米，默认0，最大设置5000</td>
</tr>
<tr>
<td>poiType</td>
<td>Integer</td>
<td>否</td>
<td>是否返回周边地点（POI）列表，0: 不返回(默认) 1: 返回</td>
</tr>
<tr>
<td>poiOptions</td>
<td>String</td>
<td>否</td>
<td>周边POI（AOI）列表控制参数：<br/>1.返回短地址，缺省时返回长地址:address_format=short<br/>2. 半径，取值范围 1-5000（米）radius=5000<br/> 3. 控制返回场景，policy=1/2/3/4/5 <br/>policy=1[默认] 以地标+主要的路+近距离POI为主，着力描述当前位置；<br/>policy=2 到家场景：筛选合适收货的POI，并会细化收货地址，精确到楼栋；<br/>policy=3 出行场景：过滤掉车辆不易到达的POI(如一些景区内POI)，增加道路出入口、交叉口、大区域出入口类POI，排序会根据真实API大用户的用户点击自动优化。<br/>policy=4 社交签到场景，针对用户签到的热门 地点进行优先排序。<br/>policy=5 位置共享场景，用户经常用于发送位置、位置分享等场景的热门地点优先排序<br/>注：policy=1/2/3最多返回10条周边POI，policy=4/5最多返回20条 <br/>4. 按距离排序 orderby=_distance，开启POI距离排序 <br/>注：仅在policy=1/2/3时生效 <br/>5. 返回POI附加字段：added_fields=字段1,字段2,…可同时指定多个字段，逗号分隔，支持：is_aoi 是否为aoi：1是（即该POI包含轮廓边界），0否category_code 分类代码（仅policy=1/2/3时、及无poi分类筛选时支持）</td>
</tr>
<tr>
<td>output</td>
<td>String</td>
<td>否</td>
<td>返回格式：支持JSON、JSONP，默认:JSON</td>
</tr>
<tr>
<td>callback</td>
<td>String</td>
<td>否</td>
<td>JSONP方式回调函数</td>
</tr>
</tbody>
</table>
<h3>签名算法说明</h3>
<p><code>sign = sha256(appId + appSecret + timestamp)</code></p>
<p>用服务商分配的 appId、服务商分配的 appSecret，当前时间时间戳 timestamp，按上述顺序拼接成字符串，再进行 sha256 哈希得到。如下：</p>
<pre><code class="language-java">String appId = &quot;xyzxy2121zxyz&quot;；
String timestamp = &quot;1555378976238&quot;；
String appSecret = &quot;efcefcef1121cefcefc1212121&quot;；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>成功返回样例</h3>
<pre><code class="language-json">{
&quot;charge&quot;: true,//计费标志
&quot;code&quot;: 200,//返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;,//返回码对应描述
&quot;taskNo&quot;: &quot;024539994248655132104819&quot;,//本次请求号
&quot;data&quot;: {
&quot;address&quot;: &quot;北京市海淀区彩和坊路&quot;,//以行政区划+道路+门牌号等信息组成的标准格式化地址
&quot;ad_info&quot;: { // 行政区划信息
&quot;_distance&quot;: 0,
&quot;adcode&quot;: &quot;110108&quot;,//行政区划代码，规则详见：行政区划代码说明
&quot;nation&quot;: &quot;中国&quot;,//国家
&quot;city&quot;: &quot;北京市&quot;,//市 / 地级区 及同级行政区划，如果当前城市为省直辖县级区划，city与district字段均会返回此城市 注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
&quot;city_code&quot;: &quot;156110000&quot;,//城市代码，由国家码+行政区划代码（提出城市级别）组合而来，总共为9位
&quot;nation_code&quot;: &quot;156&quot;,//国家代码（ISO3166标准3位数字码）
&quot;province&quot;: &quot;北京市&quot;,// 省/直辖市
&quot;district&quot;: &quot;海淀区&quot;, // 区/县级市 及同级行政区划
&quot;name&quot;: &quot;中国,北京市,北京市,海淀区&quot;,//行政区划名称
&quot;location&quot;: { //行政区划中心点坐标
&quot;lng&quot;: 116.2977, //经度
&quot;lat&quot;: 39.959893 //纬度
},
&quot;phone_area_code&quot;: &quot;010&quot; //城市电话区号
},
&quot;address_reference&quot;: { //坐标相对位置参考
&quot;town&quot;: { //乡镇/街道（四级行政区划）
&quot;_distance&quot;: 0, //此参考位置到输入坐标的直线距离
&quot;title&quot;: &quot;海淀街道&quot;,//名称/标题
&quot;_dir_desc&quot;: &quot;内&quot;, //此参考位置到输入坐标的方位关系，如：北、南、内
&quot;location&quot;: { //坐标
&quot;lng&quot;: 116.313581, //纬度
&quot;lat&quot;: 39.975116 // 经度
},
&quot;id&quot;: &quot;110108012&quot; //乡镇/街道唯一标识（行政区划代码adcode）
},
&quot;famous_area&quot;: { //知名区域，如商圈或人们普遍认为有较高知名度的区域
&quot;_distance&quot;: 0,//此参考位置到输入坐标的直线距离
&quot;title&quot;: &quot;中关村&quot;,//名称/标题
&quot;_dir_desc&quot;: &quot;内&quot;, //此参考位置到输入坐标的方位关系，如：北、南、内
&quot;location&quot;: { //坐标
&quot;lng&quot;: 116.311,//经度
&quot;lat&quot;: 39.9806 //纬度
},
&quot;id&quot;: &quot;14178584199053362783&quot; // 地点唯一标识
},
&quot;business_area&quot;: { //商圈，目前与famous_area一致
&quot;_distance&quot;: 0,
&quot;title&quot;: &quot;中关村&quot;,
&quot;_dir_desc&quot;: &quot;内&quot;,
&quot;location&quot;: {
&quot;lng&quot;: 116.311,
&quot;lat&quot;: 39.9806
},
&quot;id&quot;: &quot;14178584199053362783&quot;
},
&quot;street&quot;: { //道路【注】：对象结构同 famous_area
&quot;_distance&quot;: 44.4,
&quot;title&quot;: &quot;彩和坊路&quot;,
&quot;_dir_desc&quot;: &quot;西&quot;,
&quot;location&quot;: {
&quot;lng&quot;: 116.308299,
&quot;lat&quot;: 39.980641
},
&quot;id&quot;: &quot;1117461972434842147&quot;
},
&quot;crossroad&quot;: { //交叉路口 【注】：对象结构同 famous_area
&quot;_distance&quot;: 61.5,
&quot;title&quot;: &quot;彩和坊路/海淀北一街(路口)&quot;,
&quot;_dir_desc&quot;: &quot;西&quot;,
&quot;location&quot;: {
&quot;lng&quot;: 116.30823,
&quot;lat&quot;: 39.98395
},
&quot;id&quot;: &quot;529961&quot;
},
&quot;street_number&quot;: { // 门牌 【注】：对象结构同 famous_area
&quot;_distance&quot;: 44.4,
&quot;title&quot;: &quot;&quot;,
&quot;_dir_desc&quot;: &quot;西&quot;,
&quot;location&quot;: {
&quot;lng&quot;: 116.308299,
&quot;lat&quot;: 39.980641
},
&quot;id&quot;: &quot;&quot;
},
&quot;landmark_l1&quot;: { //一级地标，可识别性较强、规模较大的地点、小区等 【注】对象结构同 famous_area
&quot;_distance&quot;: 242.8,
&quot;title&quot;: &quot;海淀桥&quot;,
&quot;_dir_desc&quot;: &quot;东南&quot;,
&quot;location&quot;: {
&quot;lng&quot;: 116.306114,
&quot;lat&quot;: 39.985085
},
&quot;id&quot;: &quot;7586906308739894477&quot;
},
&quot;landmark_l2&quot;: { //二级地标，较一级地标更为精确，规模更小 【注】：对象结构同 famous_area
&quot;_distance&quot;: 0,
&quot;title&quot;: &quot;中国技术交易大厦&quot;,
&quot;_dir_desc&quot;: &quot;内&quot;,
&quot;location&quot;: {
&quot;lng&quot;: 116.307499,
&quot;lat&quot;: 39.984105
},
&quot;id&quot;: &quot;3629720141162880123&quot;
}
},
&quot;formatted_addresses&quot;: { //结合知名地点形成的描述性地址，更具人性化特点
&quot;rough&quot;: &quot;海淀区中关村中国技术交易大厦(海淀桥东南200米)&quot;,//粗略位置描述
&quot;recommend&quot;: &quot;海淀区中关村中国技术交易大厦(海淀桥东南200米)&quot;,//推荐使用的地址描述，描述精确性较高
&quot;standard_address&quot;: &quot;北京市海淀区北四环西路66号&quot;//基于附近关键地点（POI）的精确地址
},
&quot;address_component&quot;: { //地址部件，address不满足需求时可自行拼接
&quot;nation&quot;: &quot;中国&quot;,//国家
&quot;city&quot;: &quot;北京市&quot;,//市，如果当前城市为省直辖县级区划，city与district字段均会返回此城市 注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
&quot;province&quot;: &quot;北京市&quot;,//省
&quot;street&quot;: &quot;彩和坊路&quot;,//道路，可能为空字串
&quot;district&quot;: &quot;海淀区&quot;,//区，可能为空字串
&quot;street_number&quot;: &quot;&quot; //门牌，可能为空字串
},
&quot;location&quot;: {
&quot;lng&quot;: 116.30749,
&quot;lat&quot;: 39.984154
}
}
}</code></pre>
<h3>失败返回样例</h3>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;经纬度坐标不能为空&quot;,
&quot;code&quot;: 400
}</code></pre>
<h4>行政区划代码说明</h4>
<p>代码共6位，前两位代表省（一级）、中间两位为市/地区（二级），最后两位为区县（三级）
1）省级：前两位有值，后4位置0，如，河北省：130000
2）市/地区：前4四位有值，包含省代码与市代码，最后两位置0，如河北省保定市：130600
3）区县：6位全有值，包含前4位省市代码及区县代码，河北省保定市涿州市：130681
4）直辖市、香港、澳门：
同省级，在行政区划中，其下直接为区级（没有二级结构填充）
例：北京,东城区 （而非：“北京,北京,东城区”）
5）直辖县：第3、4位为90的，为省直辖县
6）中国范围内，省市区行政区划以外的区域值为999999（如中国东海）
7）东莞市、中山市、儋州市、嘉峪关市 因其下无区县级，因此增加了末位为99代码的同名子级，用于补齐到三级区划的结构</p>
<p>如何获取城市编码（city_code）：
1）编码前4位不为0，第5、6位为0的，为常规城市，可直接取用
2）北京、上海、重庆、天津、香港、澳门，编码和省一致，需要单独提出
3）第3、4位为90的为省直辖县，一般当做城市来应用，也需要单独提出
<a href ="<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/district-code_20240821/%E8%A1%8C%E6%94%BF%E5%8C%BA%E5%88%92%E7%BC%96%E7%A0%81%E8%A1%A8_202408021.xlsx">行政区划编码表</a>">https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/district-code_20240821/%E8%A1%8C%E6%94%BF%E5%8C%BA%E5%88%92%E7%BC%96%E7%A0%81%E8%A1%A8_202408021.xlsx">行政区划编码表</a></a>;</p>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见返回码说明</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>计费标志</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>返回具体结果，详见成功返回样例</td>
</tr>
</tbody>
</table>
<h4>code返回码说明</h4>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功（计费）</td>
</tr>
<tr>
<td>201</td>
<td>查无数据</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
</tr>
<tr>
<td>404</td>
<td>请求地址不正确</td>
</tr>
<tr>
<td>500</td>
<td>服务商维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>607</td>
<td>ip不在白名单</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>