静态地图
<h3>接口描述</h3>
<ul>
<li>根据位置返回一张地图图片，使用户能够将地图以图片形式嵌入自己的网页中</li>
<li>用户可以指定请求的地图位置、图片大小、以及在地图上添加覆盖物，如标签、标注、折线、多边形</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/static-map/create</code></p>
<h3>请求方式</h3>
<ul>
<li>GET/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>中心点坐标。规则：经度和纬度用","分隔 经纬度小数点后不得超过6位。</td>
</tr>
<tr>
<td>zoom</td>
<td>String</td>
<td>必填</td>
<td>地图级别，地图缩放级别:[1,17]</td>
</tr>
<tr>
<td>size</td>
<td>String</td>
<td>可选</td>
<td>地图大小，图片宽度 <em> 图片高度。 最大值为1024</em>*1024</td>
</tr>
<tr>
<td>scale</td>
<td>String</td>
<td>可选</td>
<td>普通/高清 1-普通图; 2-高清图，图片高度和宽度都增加一倍，zoom 也增加一倍（当zoom 为最大值时，zoom 不再改变）。</td>
</tr>
<tr>
<td>markers</td>
<td>String</td>
<td>可选</td>
<td>标注，使用规则见 markers 详细说明，标注最大数10个</td>
</tr>
<tr>
<td>labels</td>
<td>String</td>
<td>可选</td>
<td>标签，使用规则见 labels 详细说明，标签最大数10个</td>
</tr>
<tr>
<td>paths</td>
<td>String</td>
<td>可选</td>
<td>折线，使用规则见 paths 详细说明，折线和多边形最大数4个</td>
</tr>
<tr>
<td>traffic</td>
<td>String</td>
<td>可选</td>
<td>交通路况标识，底图是否展现实时路况。 可选值： 0-不展现；1-展现</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;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;65171553403304103621&quot;,
&quot;charge&quot;: true,
&quot;data&quot;: {
&quot;url&quot;:&quot;&quot;//地图图片url，有效期30天。建议自行下载保存，避免丢失
}
}</code></pre>
<h3>失败返回样例</h3>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;参数[zoom]不能为空&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>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>
<h3>markers 说明</h3>
<p>格式 </p>
<pre><code class="language-json">markers=markersStyle1:location1;location2..|markersStyle2:location3;location4..|markersStyleN:locationN;locationM.. </code></pre>
<p>location 为经纬度信息，经纬度之间使用","分隔，不同的点使用";"分隔。 markersStyle 可以使用系统提供的样式，也可以使用自定义图片。<br />
系统 marersStyle：label，font ,bold, fontSize，fontColor，background。</p>
<table>
<thead>
<tr>
<th>marersStyle（参数名称）</th>
<th>说明</th>
<th>默认值</th>
</tr>
</thead>
<tbody>
<tr>
<td>size</td>
<td>可选值： small,mid,large</td>
<td>small</td>
</tr>
<tr>
<td>color</td>
<td>可选值： 选值范围：[0x000000, 0xffffff]</td>
<td>0xFC6054</td>
</tr>
<tr>
<td>label</td>
<td>[0-9]、[A-Z]、[单个中文字] 当 size 为 small 时，图片不展现标注名。</td>
<td>无</td>
</tr>
</tbody>
</table>
<h3>labels 说明</h3>
<p>格式 </p>
<pre><code class="language-json">labels=labelsStyle1:location1;location2..|labelsStyle2:location3;location4..|labelsStyleN:locationN;locationM.. </code></pre>
<p>location 为经纬度信息，经纬度之间使用","分隔，不同的点使用";"分隔。<br />
labelsStyle：label, font, bold, fontSize, fontColor, background。 各参数使用","分隔，如有默认值则可为空。</p>
<table>
<thead>
<tr>
<th>labelsStyle（参数名称）</th>
<th>说明</th>
<th>默认值</th>
</tr>
</thead>
<tbody>
<tr>
<td>content</td>
<td>标签内容，字符最大数目为15</td>
<td>无</td>
</tr>
<tr>
<td>font</td>
<td>0：微软雅黑；1：宋体；2：Times New Roman; 3：Helvetica</td>
<td>0</td>
</tr>
<tr>
<td>bold</td>
<td>0：非粗体；1：粗体</td>
<td>0</td>
</tr>
<tr>
<td>fontSize</td>
<td>字体大小，可选值[1,72]</td>
<td>0</td>
</tr>
<tr>
<td>fontColor</td>
<td>字体颜色，取值范围：[0x000000, 0xffffff]</td>
<td>0xFFFFFF</td>
</tr>
<tr>
<td>background</td>
<td>背景色，取值范围：[0x000000, 0xffffff]</td>
<td>0x5288d8</td>
</tr>
</tbody>
</table>
<h3>paths 说明</h3>
<p>格式 </p>
<pre><code class="language-json">paths=pathsStyle1:location1;location2..|pathsStyle2:location3;location4..|pathsStyleN:locationN;locationM.. </code></pre>
<p>location 为经纬度，经纬度之间使用","分隔，不同的点使用";"分隔。
pathsStyle：weight, color, transparency, fillcolor, fillTransparency。</p>
<table>
<thead>
<tr>
<th>pathsStyle（参数名称）</th>
<th>说明</th>
<th>默认值</th>
</tr>
</thead>
<tbody>
<tr>
<td>weight</td>
<td>线条粗细。可选值： [2,15]</td>
<td>5</td>
</tr>
<tr>
<td>color</td>
<td>可选值： 选值范围：[0x000000, 0xffffff]</td>
<td>0x0000FF</td>
</tr>
<tr>
<td>transparency</td>
<td>透明度。可选值[0,1]，小数后最多2位，0表示完全透明，1表示完全不透明。</td>
<td>1</td>
</tr>
<tr>
<td>fillcolor</td>
<td>多边形的填充颜色，此值不为空时折线封闭成多边形。取值规则同color</td>
<td>无</td>
</tr>
<tr>
<td>fillTransparency</td>
<td>填充面透明度。可选值[0,1]，小数后最多2位，0表示完全透明，1表示完全不透明。</td>
<td>0.5</td>
</tr>
</tbody>
</table>