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.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
- 描述面对象的填充风格。