Map-JS

跳转到: 导航, 搜索

目录

快速入门

获取底图引擎API密钥

一个底图API密钥只对一个“目录”或域有效,一个标准的API 密钥形式为 ee1f5e18459fd400c8f31f8b1366。

您可以点击 http://api.map.sina.com.cn/engines/mapjs/ 进行申请。如有任何问题,请通过新浪微博@新浪地图 http://weibo.com/sinamap 或 发送邮件到map_api@sina.com 联系我们。

在页面头部添加API引用地址

通过地址http://api.map.sina.com.cn/engines/v1.0/smap.js 加载API

<script src="http://api.map.sina.com.cn/engines/v1.0/smap.js?key=您的API密钥" type="text/javascript"></script>

在页面添加装在地图的容器

<div id="map" style="width: 400px; height: 300px"></div>

宽度和高度可以根据您页面的大小进行相应的调整

创建地图

通过javaScript创建地图

<script type="text/javascript">
 var mapObj=new SMap.Map("map");//创建地图对象
</script>

完整代码示例

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script type="text/javascript" src="http://api.map.sina.com.cn/engines/v1.0/smap.js?key=您的API密钥"></script>
</head>
<body>
<div id="mapObj" style="width: 400px; height: 300px"></div>
<script type="text/javascript">
 var mapOptions = new SMap.MapOptions();
 mapOptions.zoom = 12;
 mapOptions.center = new SMap.LngLat(116.39825820922851 ,39.904600759441024);
 mapOptions.toolbar = SMap.DEFAULT;
 mapOptions.toolbarPos = new SMap.Point(0,0);
 mapOptions.overviewMap = SMap.SHOW;
 mapOptions.returnCoordType = SMap.COORD_TYPE_OFFSET;
 var mapObj=new SMap.Map("mapObj", mapOptions);
</script>
</body>
</html>

类参考(命名空间:SMap)

全局常量

SMap.Constant

核心类

SMap.Map
Map类封装Ajax地图组件,对地图的操作都是通过它完成。通过创建一个Map对象并调用地图的相应方法就可以在页面中显示地图,实现基本的地图功能。
SMap.MapOptions
此类代表Map构造函数的可选参数,用来设置地图初始化时的中心点坐标、缩放级别、工具条在地图中的显示位置、返回坐标类型等。
SMap.LngLat
构造一个经纬度坐标对象,用于标注地图上一个点。
SMap.LngLats
构造经纬度坐标集合对象。
SMap.Point
构建像素坐标对象。
SMap.Size
构建显示尺寸对象。
SMap.LngLatBounds
通过西南角、东北角的经纬度坐标,构建经纬度矩形区域对象,类似于PixelBounds()的对象构建。
SMap.PixelBounds
构建像素坐标矩形区域对象,可以用来表示矩形区域最大、最小像素坐标,其值因zoom级别的不同而不同。
SMap.Event
事件对象,封装了所有事件。

基础类

SMap.MenuItem
在地图上添加的右键菜单对象。
封装了所有事件。
SMap.MapTools
地图工具类,它包含所有地图应用功能。
SMap.MassOverlayOptions
海量加载数据的参数选项。

覆盖物类

SMap.Overlay
覆盖在地图上,随地图移动而移动的所有对象都叫覆盖类(overlay)。SMap.Overlay是其他覆盖物的父类。
SMap.Marker
Marker是添加到地图上的图标标注,该标注是图标容器,它实现SMap.Overlay接口,可以用addOverlay()方法添加到地图中。
SMap.MarkerOptions
描述SMap.Marker的参数选项。
SMap.Box
Box是添加到地图上的HTML标注,该标注是HTML标签的容器,它实现SMap.Overlay接口,可以用addOverlay()方法添加到地图中。
SMap.BoxOptions
描述SMap.Box的参数选项。
SMap.Label
Label是地图上的文字标签。它有两个参数lngLat与option,lnglat用来设置文字标签的显示位置,option用来设置文字标签的字体样式、内容等。
SMap.LabelOptions
描述SMap.Label的参数选项。
SMap.Polyline
创建多折线对象,继承自SMap.Overlay。
SMap.LineOptions
描述线样式的参数选项。
SMap.Area
构建覆盖面对象,以便能在地图上显示。参数设置、构造方法均类似于SMap.Polyline。SMap.Area与SMap.Label、SMap.Marker、SMap.Polyline一起继承父类Overlay的属性及方法,同时又将属性、方法传递到子类上。一般我们并不直接构造SMap.Area对象,而是构建其子类的对象。
SMap.AreaOptions
描述面选项,该类除了可另外指定填充色和不透明性外,其他方面都非常类似于SMap.LineOptions。
SMap.Rectangle
描述矩形面对象,继承自SMap.Area。
SMap.Circle
构建圆对象,继承自SMap.Area。
SMap.Polygon
描述多边形面的覆盖物,继承自SMap.Area。
SMap.GroundImage
地图的背景图,图片在地图上会随着地图的缩放而缩放,此类继承自SMap.Overlay。
SMap.GroundImgeOptions
GroundImge的参数选项。
SMap.TipOptions
信息窗口选项对象,通过该对象的各个属性来设置信息窗口的标题、内容、边框风格等,信息窗口可以在地图上单独打开,也可以在SMap.Marker、SMap.Polyline、SMap.Area对象上打开。
SMap.TileLayer
通过地图叠加层的类别及参数选项确定地图叠加层信息。
SMap.TileLayerOptions
描述地图叠加层选项。
SMap.FontStyle
描述字体的风格。
SMap.LineStyle
描述线的风格,如线的粗细度、颜色及透明度等,此对象既可服务于Polyline,又可以服务于Area的边框线。
SMap.AreaStyle
描述面的风格,除了比LineStyle多填充样式外,其它方面都很类似。
SMap.FillStyle
描述面对象的填充风格。
文档更新时间: 2012-03-06