Base/get map image

跳转到: 导航, 搜索
(创建新页面为 '== '''静态地图''' == 根据中心点生成静态地图的图片 == '''URL''' == http://intra.map.sina.com.cn/base/get_map_image.php == '''支持格式''' == URL == '''HTT…')
 
 
(未显示1个用户的10个中间版本)
第1行: 第1行:
== '''静态地图''' ==
+
== '''base/get_map_image''' ==
 
根据中心点生成静态地图的图片
 
根据中心点生成静态地图的图片
  
 
== '''URL''' ==
 
== '''URL''' ==
http://intra.map.sina.com.cn/base/get_map_image.php
+
http://api.t.sina.com.cn/location/base/get_map_image.(xml|json)
  
 
== '''支持格式''' ==
 
== '''支持格式''' ==
URL
+
xml/json
  
 
== '''HTTP请求方式''' ==
 
== '''HTTP请求方式''' ==
第12行: 第12行:
  
 
== '''是否需要登录''' ==
 
== '''是否需要登录''' ==
'''false'''  
+
'''true'''  
 
== '''请求数限制''' ==
 
== '''请求数限制''' ==
 
'''true'''  
 
'''true'''  
 
== '''请求参数''' ==
 
== '''请求参数''' ==
 
{| style="width:100%; height:200px;" border="1" cellspacing="0" cellpadding="0"
 
{| style="width:100%; height:200px;" border="1" cellspacing="0" cellpadding="0"
! style="width:20%;height:20px" |参数  
+
! style="text-align:center;width:20%;height:20px" |参数  
! style="width:10%" |必选
+
! style="text-align:center;width:10%" |必选
! style="width:20%" |类型及范围
+
! style="text-align:center;width:20%" |类型及范围
! style="width:50%" |说明
+
! style="text-align:center;width:50%" |说明
 
|- style="height:20px"  
 
|- style="height:20px"  
 
| style="text-align:center;" |source
 
| style="text-align:center;" |source
第29行: 第29行:
 
| style="text-align:center;" |center_coordinates
 
| style="text-align:center;" |center_coordinates
 
| style="text-align:center;" |false
 
| style="text-align:center;" |false
| style="text-align:center;" |float
+
| style="text-align:center;" |string
| 中心点坐标(用逗号分隔)
+
| 中心点坐标(用逗号分隔)(城市代码或中心点坐标至少选一项)会覆盖city
 
|-style="height:20px"
 
|-style="height:20px"
 
| style="text-align:center;" |city
 
| style="text-align:center;" |city
 
| style="text-align:center;" |false
 
| style="text-align:center;" |false
 
| style="text-align:center;" |string
 
| style="text-align:center;" |string
| 城市代码  
+
| 城市代码 (城市代码或中心点坐标至少选一项)
 
|-style="height:20px"
 
|-style="height:20px"
 
| style="text-align:center;" |coordinates
 
| style="text-align:center;" |coordinates
 
| style="text-align:center;" |false
 
| style="text-align:center;" |false
 
| style="text-align:center;" |string
 
| style="text-align:center;" |string
| 坐标串,坐标间用分号分隔,如y0,y0;x1,y1...
+
| 坐标串,多组坐标间用分号分隔,如x0,y0;x1,y1...
 
|-style="height:20px"
 
|-style="height:20px"
 
| style="text-align:center;" |names
 
| style="text-align:center;" |names
 
| style="text-align:center;" |false
 
| style="text-align:center;" |false
 
| style="text-align:center;" |string
 
| style="text-align:center;" |string
| 名称坐标串,以逗号分隔
+
| 名称串,以逗号分隔
 
|-style="height:20px"
 
|-style="height:20px"
 
| style="text-align:center;" |size
 
| style="text-align:center;" |size
第52行: 第52行:
 
| size= width x height,地图宽度,默认240,地图高度,默认240
 
| size= width x height,地图宽度,默认240,地图高度,默认240
 
|-style="height:20px"
 
|-style="height:20px"
| style="text-align:center;" |format
+
| style="text-align:center;" |img_format
 
| style="text-align:center;" |false
 
| style="text-align:center;" |false
 
| style="text-align:center;" |string
 
| style="text-align:center;" |string
 
| 输出格式图片格,包括png/jpg,,注意大小写,默认png  
 
| 输出格式图片格,包括png/jpg,,注意大小写,默认png  
|-style="height:20px"
 
| style="text-align:center;" |content
 
| style="text-align:center;" |false
 
| style="text-align:center;" |string
 
| 内容展现形式,包括URL/Base64/MAP/URLDATA,注意大小写,默认URL
 
 
|-style="height:20px"
 
|-style="height:20px"
 
| style="text-align:center;" |zoom
 
| style="text-align:center;" |zoom
第80行: 第75行:
 
| style="text-align:center;" |false
 
| style="text-align:center;" |false
 
| style="text-align:center;" |string
 
| style="text-align:center;" |string
| 用来表示需要加点的tip图片名(此值形式为105),每个点之间的图片用逗号分隔和names参数和xs,ys参数顺序对应描述一个点,图片规格12*12的 gif格式,空中网可以提交给我需要的图片样式,我到时候给空中网上传到我们的服务器,并回复给他们对应的图片文件名便可以在程序中调用
+
| 用来表示需要加点的tip图片名(此值形式为105),每个点之间的图片用逗号分隔和names参数和xs,ys参数顺序对应描述一个点,图片规格12*12的 gif格式
 
|-style="height:20px"
 
|-style="height:20px"
 
| style="text-align:center;" |font
 
| style="text-align:center;" |font
第116行: 第111行:
 
| style="text-align:center;" |scale
 
| style="text-align:center;" |scale
 
| style="text-align:center;" |false
 
| style="text-align:center;" |false
| style="text-align:center;" |string
+
| style="text-align:center;" |enums
 
| false或true,是否展示比例尺
 
| false或true,是否展示比例尺
 
|-style="height:20px"
 
|-style="height:20px"
 
| style="text-align:center;" |traffic
 
| style="text-align:center;" |traffic
 
| style="text-align:center;" |false
 
| style="text-align:center;" |false
| style="text-align:center;" |string
+
| style="text-align:center;" |enums
 
| on或off,是否叠加事实交通地图
 
| on或off,是否叠加事实交通地图
 
|}
 
|}
第127行: 第122行:
 
== '''返回结果''' ==
 
== '''返回结果''' ==
 
返回生成的静态地图的图片地址
 
返回生成的静态地图的图片地址
 +
===  '''XML示例''' ===
 +
<pre>
 +
<?xml version="1.0" encoding="UTF-8" ?>
 +
<geoResult>
 +
<url>
 +
  http://202.108.5.66:8081/MapServerBM/maptemp/20114/817/1302253899522_20.png
 +
</url>
 +
</geoResult>
 +
</pre>
  
== '''使用示例''' ==
+
=== '''JSON示例''' ===
 
<pre>
 
<pre>
http://api.t.sina.com.cn/base/get_map_image.php?center_coordinates=116.3136,39.9824&zoom=12&format=png&content=map
+
{"url":"http:\/\/202.108.5.66:8081\/MapServerBM\/maptemp\/20114\/817\/1302254393724_37.png"}
&coordinates=116.3136,39.98&names=hello&size=400x400&format=png&icons=105&px=1&traffic=on&source=appkey
+
</pre>
 +
 
 +
== '''其它''' ==
 +
 
 +
===  '''PHP示例''' ===
 +
需要开启PHP的cURL扩展
 +
<pre>
 +
<?php
 +
//改为你的微博账号,用户名和密码之间用:隔开
 +
$userPwd = 'user@sina.com:pwd';
 +
//改为你微博应用的appkey
 +
$appkey = '0123456789';
 +
 
 +
$url = "http://api.t.sina.com.cn/location/base/get_map_image.xml?center_coordinates=116.3136,39.9824&zoom=12&img_format=png&coordinates=116.3136,39.98&names=hello&size=400x400&icons=105&px=1&traffic=on&source=$appkey";
 +
 
 +
$rst = curlSample($url,$userPwd);
 +
 
 +
echo $rst;
 +
 
 +
function curlSample($url,$userPwd,$postFields = '',$header = ''){
 +
$ch = curl_init() or die (curl_error()) ;
 +
curl_setopt($ch,CURLOPT_URL,$url);
 +
curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
 +
curl_setopt($ch,CURLOPT_TIMEOUT,30);
 +
if(!empty($userPwd)){
 +
curl_setopt($ch,CURLOPT_USERPWD,$userPwd);
 +
}
 +
if(!empty($postFields)){
 +
curl_setopt($ch,CURLOPT_POST,true);
 +
curl_setopt($ch,CURLOPT_POSTFIELDS,$postFields);
 +
}
 +
if(!empty($header)){
 +
curl_setopt($ch, CURLOPT_HTTPHEADER,$header);
 +
}
 +
$result = curl_exec($ch) or die (curl_error($ch));
 +
curl_close($ch);
 +
return $result;
 +
}
 +
?>
 
</pre>
 
</pre>

2011年8月11日 (四) 14:21的最后版本

目录

base/get_map_image

根据中心点生成静态地图的图片

URL

http://api.t.sina.com.cn/location/base/get_map_image.(xml%7Cjson)

支持格式

xml/json

HTTP请求方式

GET

是否需要登录

true

请求数限制

true

请求参数

参数 必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份
center_coordinates false string 中心点坐标(用逗号分隔)(城市代码或中心点坐标至少选一项)会覆盖city
city false string 城市代码 (城市代码或中心点坐标至少选一项)
coordinates false string 坐标串,多组坐标间用分号分隔,如x0,y0;x1,y1...
names false string 名称串,以逗号分隔
size false string size= width x height,地图宽度,默认240,地图高度,默认240
img_format false string 输出格式图片格,包括png/jpg,,注意大小写,默认png
zoom false string 地图等级(1-17),如果不传,默认根据图上的加入的poi和线,自适应大小
px false string 轴偏移方向,东移为正,西移为负,单位1为1/4的图片宽度,例如px=1,等于地图向右移动1/4的长度
py false string 轴偏移方向,北移为正,南移为负,单位1为1/4的图片高度,例如px=1,等于地图向上移动1/4
icons false string 用来表示需要加点的tip图片名(此值形式为105),每个点之间的图片用逗号分隔和names参数和xs,ys参数顺序对应描述一个点,图片规格12*12的 gif格式
font false string 宋体,1,20,0xff0cc0,0xffffe0,1

含义对应关系如下: 宋体---- 字体 1---字体风格 20---字号 0xff0cc0-----字体颜色 0xffffe0-----字体背景 1------是否有背景色,0无,1有

lines false string 画线的格式和坐标描述,添加一组线示例:lines=0x000000,2,116.32569,39.96682,116.12568,39.9671,116.32568,39.8671

参数顺序依次为:
1、线的颜色值:默认为0X000000(可以为空,传则必须为0x或者0X打头的,6位16进制的数字字符串)
2、线的宽度:默认为3(可以为空,传则必须为数字字符串):
3、接着为此线的拐点的x,y组合,必须配对,添加多组线则以分号分隔即可

polygons false string 画多边形,添加一组多边形示例:polygons=0x000000,1,1,50,116.32569,39.96682,116.12568,39.9671,116.32568,39.8671

参数顺序依次为:
1、面边框的颜色值:默认为0X000000(可以为空,传则必须为0x或者0X打头的,6位16进制的数字字符串)
2、面边框的宽度:默认为1(可以为空,传则必须为小于50的数字字符串,可以为0)
3、面填充色:同面边框的颜色值,默认为0XFF0000
4、面填充的透明度:默认为50(0为全透明,100为全不透明)
5、接着为此面的拐点的x,y组合,必须配对添加多组面则以分号分隔即可。

scale false enums false或true,是否展示比例尺
traffic false enums on或off,是否叠加事实交通地图

返回结果

返回生成的静态地图的图片地址

XML示例

<?xml version="1.0" encoding="UTF-8" ?> 
<geoResult>
 <url>
  http://202.108.5.66:8081/MapServerBM/maptemp/20114/817/1302253899522_20.png
 </url>
</geoResult>

JSON示例

{"url":"http:\/\/202.108.5.66:8081\/MapServerBM\/maptemp\/20114\/817\/1302254393724_37.png"}

其它

PHP示例

需要开启PHP的cURL扩展

<?php
//改为你的微博账号,用户名和密码之间用:隔开
$userPwd = 'user@sina.com:pwd';
//改为你微博应用的appkey
$appkey = '0123456789';

$url = "http://api.t.sina.com.cn/location/base/get_map_image.xml?center_coordinates=116.3136,39.9824&zoom=12&img_format=png&coordinates=116.3136,39.98&names=hello&size=400x400&icons=105&px=1&traffic=on&source=$appkey";

$rst = curlSample($url,$userPwd);

echo $rst;

function curlSample($url,$userPwd,$postFields = '',$header = ''){
	$ch = curl_init() or die (curl_error()) ;
	curl_setopt($ch,CURLOPT_URL,$url);
	curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
	curl_setopt($ch,CURLOPT_TIMEOUT,30);
	if(!empty($userPwd)){
		curl_setopt($ch,CURLOPT_USERPWD,$userPwd);
	}
	if(!empty($postFields)){
		curl_setopt($ch,CURLOPT_POST,true);
		curl_setopt($ch,CURLOPT_POSTFIELDS,$postFields);
	}
	if(!empty($header)){
		curl_setopt($ch, CURLOPT_HTTPHEADER,$header);
	}
	$result = curl_exec($ch) or die (curl_error($ch));
	curl_close($ch);
	return $result;
}
?>
文档更新时间: 2011-08-11