地理编码-百度版
<h3>接口描述</h3>
<ul>
<li>用户可通过该功能，将结构化地址（省/市/区/街道/门牌号）解析为对应的位置坐标。地址结构越完整，地址内容越准确，解析的坐标精度越高。</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/geocode/baidu/geo/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>address</td>
<td>String</td>
<td>是</td>
<td>待解析的地址。最多支持84个字节。可以输入两种样式的值，分别是：1、标准的结构化地址信息，北京市海淀区上地十街十号【推荐，地址结构越完整，解析精度越高】2、支持“<em>路与</em>路交叉口”描述方式，如北一环路和阜阳路的交叉路口第二种方式并不总是有返回结果，只有当地址库中存在该地址描述时才有返回。</td>
</tr>
<tr>
<td>city</td>
<td>String</td>
<td>否</td>
<td>地址所在的城市名。用于指定上述地址所在的城市，当多个城市都有上述地址时，该参数起到过滤作用，但不限制坐标召回城市。</td>
</tr>
<tr>
<td>retCoordtype</td>
<td>String</td>
<td>否</td>
<td>添加后返回国测局经纬度坐标或百度米制坐标。示例：gcj02（国测局坐标，仅限中国）、bd09mc（百度墨卡托坐标）。默认bd09ll。</td>
</tr>
<tr>
<td>output</td>
<td>String</td>
<td>否</td>
<td>输出格式为json或者xml，默认json</td>
</tr>
<tr>
<td>callback</td>
<td>String</td>
<td>否</td>
<td>将json格式的返回值通过callback函数返回以实现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;340833941206534747872156&quot;,//本次请求号
&quot;data&quot;: {
&quot;confidence&quot;: 75,//描述打点绝对精度（即坐标点的误差范围）。confidence=100，解析误差绝对精度小于20m；confidence≥90，解析误差绝对精度小于50m；confidence≥80，解析误差绝对精度小于100m；confidence≥75，解析误差绝对精度小于200m；confidence≥70，解析误差绝对精度小于300m；confidence≥60，解析误差绝对精度小于500m；confidence≥50，解析误差绝对精度小于1000m；confidence≥40，解析误差绝对精度小于2000m；confidence≥30，解析误差绝对精度小于5000m；confidence≥25，解析误差绝对精度小于8000m；confidence≥20，解析误差绝对精度小于10000m；
&quot;analys_level&quot;: &quot;POI&quot;,//可以解析地址文本中的最小地址结构，例如问题地址：北京市海淀区北京路百度大厦，analys_level：&quot;POI&quot;，能精确理解的地址类型包含: 省 市 区县 乡镇 道路 门址 POI 。
&quot;level&quot;: &quot;商务大厦&quot;,//可以打点到地址文本中的真实地址结构，例如问题地址：北京市海淀区北京路百度大厦，level：&quot;道路&quot;，能精确理解的地址类型，包含：UNKNOWN、国家、省、城市、区县、乡镇、村庄、道路、地产小区、商务大厦、政府机构、交叉路口、商圈、生活服务、休闲娱乐、餐饮、宾馆、购物、金融、教育、医疗 、工业园区 、旅游景点 、汽车服务、火车站、长途汽车站、桥 、停车场/停车区、港口/码头、收费区/收费站、飞机场 、机场 、收费处/收费站 、加油站、绿地、门址
&quot;location&quot;: {
&quot;lng&quot;: 120.00135828539837,//经度值
&quot;lat&quot;: 30.287874445189647 //纬度值
},
&quot;precise&quot;: 1,//位置的附加信息，是否精确查找。1为精确查找，即准确打点；0为不精确，即模糊打点。
&quot;comprehension&quot;: 35 //描述地址理解程度。分值范围0-100，分值越大，服务对地址理解程度越高（建议以该字段作为解析结果判断标准）,当comprehension值为以下值时，对应的准确率如下：comprehension=100，解析误差100m内概率为91%，误差500m内概率为96%；comprehension≥90，解析误差100m内概率为89%，误差500m内概率为96%；comprehension≥80，解析误差100m内概率为88%，误差500m内概率为95%；comprehension≥70，解析误差100m内概率为84%，误差500m内概率为93%；comprehension≥60，解析误差100m内概率为81%，误差500m内概率为91%；comprehension≥50，解析误差100m内概率为79%，误差500m内概率为90%，解析误差：地理编码服务解析地址得到的坐标位置，与地址对应的真实位置间的距离。
}
}</code></pre>
<h3>失败返回样例</h3>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;参数不正确&quot;,
&quot;code&quot;: 400
}</code></pre>
<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>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>