首页 > HTML5/CSS3

html5plus Maps模块管理地图控件

发表于2015-07-16 11:43:24| --次阅读| 来源webkfa| 作者html5plus

摘要：Maps模块管理地图控件，用于在web页面中显示地图控件，提供各种接口操作地图控件，如添加标点、路线等。通过plus.maps可获取地图管理对象。

maps

Maps模块管理地图控件，用于在web页面中显示地图控件，提供各种接口操作地图控件，如添加标点、路线等。通过plus.maps可获取地图管理对象。

方法：

  • openSysMap: 调用系统第三方程序进行导航

对象：

  • Map: 地图控件对象
  • Point: Point对象用于表示地图元素的坐标
  • MapType: 地图视图类型
  • Overlay: 地图覆盖物基类对象
  • Marker: 地图上显示的标点对象
  • Bubble: 地图上显示的气泡对象
  • Circle: 地图上显示的圆圈对象
  • Polyline: 地图上显示的折线对象
  • Polygon: 地图上显示的多边形对象
  • Search: 地图检索对象
  • SearchPolicy: 检索策略类型
  • SearchPoiResult: 保存位置检索、周边检索和范围检索返回的结果
  • SearchRouteResult: 保存位置检索、周边检索和范围检索返回的结果
  • Position: 检索结果的位置点
  • Route: 地图中的路线对象

回调方法：

权限：

permissions 

"Maps": {
	"description": "访问地图插件"
}

Map

地图控件对象

构造：

方法：

事件：

  • onclick: 用户点击地图事件

Point

Point对象用于表示地图元素的坐标

说明：

常用语对地图上元素进行定位时使用。

构造：

方法：

  • setLng: 设置坐标点的经度
  • getLng: 获取坐标的经度
  • setLat: 设置坐标的纬度
  • getLat: 获取坐标的纬度
  • equals: 判断两个坐标点是否相等

MapType

地图视图类型

常量：

  • MAPTYPE_NORMAL: (Number 类型 )普通街道视图类型

    地图视图类型常量，普通街道视图。

  • MAPTYPE_SATELLITE: (Number 类型 )卫星视图

    地图视图类型常量，卫星视图。

Overlay

地图覆盖物基类对象 

interface Overlay {
	function Boolean isVisible();
	function void show();
	function void hide();
}

说明：

Overlay是地图上显示元素的基类，用于抽象地图元素，不用于实例化。

方法：

  • isVisible: 判断地图覆盖物是否可见
  • show: 显示地图上的覆盖物
  • hide: 隐藏地图上的覆盖物

Marker

地图上显示的标点对象

说明：

从Overlay对象继承而来，可通过Map对象的addOverlay()方法将对象添加地图中。

构造：

方法：

  • setPoint: 设置标点对象的坐标
  • getPoint: 获取标点的坐标
  • setIcon: 设置标点上显示的图标
  • setLabel: 设置标点上显示的文本标注
  • getLabel: 获取标点上显示的文本标注
  • setBubble: 设置标点的气泡内容
  • getBubble: 获取标点上显示的文本标注

事件：

  • onclick: 用户点击地图标点事件

Bubble

地图上显示的气泡对象

说明：

此对象不能直接添加到地图上显示，只可关联到地图标点覆盖物上，用户点击标点时弹出显示。

构造：

方法：

  • setIcon: 设置气泡上显示的图标
  • setLabel: 设置气泡上显示的文字内容
  • getLabel: 获取气泡上显示的文字内容
  • belongMarker: 获取气泡所属的标点对象

事件：

  • onclick: 用户点击气泡事件

Circle

地图上显示的圆圈对象

说明：

从Overlay对象继承而来，可通过Map对象的addOverlay()方法将对象添加地图中。

构造：

方法：

Polyline

地图上显示的折线对象

说明：

从Overlay对象继承而来，可通过Map对象的addOverlay()方法将对象添加地图中。

构造：

方法：

Polygon

地图上显示的多边形对象

说明：

从Overlay对象继承而来，可通过Map对象的addOverlay()方法将对象添加地图中。

构造：

方法：

Search

地图检索对象

说明：

Search对象用于管理地图上的检索功能，包括位置检索、周边检索和范围检索。

构造：

方法：

事件：

SearchPolicy

检索策略类型

说明：

在线路检索时设置检索策略时使用。

常量：

  • TRANSIT_TIME_FIRST: (Number 类型 )时间优先

    检索策略类型常量，用于公交检索策略

  • TRANSIT_TRANSFER_FIRST: (Number 类型 )最少换乘优先

    检索策略类型常量，用于公交检索策略

  • TRANSIT_WALK_FIRST: (Number 类型 )最少步行距离优先

    检索策略类型常量，用于公交检索策略

  • TRANSIT_FEE_FIRST: (Number 类型 )选择车票花销最少优先

    检索策略类型常量，用于公交检索策略

  • DRIVING_DIS_FIRST: (Number 类型 )最短距离优先

    检索策略类型常量，用于驾车检索策略

  • DRIVING_NO_EXPRESSWAY: (Number 类型 )无高速公路线路

    检索策略类型常量，用于驾车检索策略

  • DRIVING_FEE_FIRST: (Number 类型 )最少费用优先

    检索策略类型常量，用于驾车检索策略

SearchPoiResult

保存位置检索、周边检索和范围检索返回的结果

属性：

方法：

SearchRouteResult

保存位置检索、周边检索和范围检索返回的结果

说明：

不可通过new操作符创建SearchRouteResult对象，在触发onRouteSearchComplete()时自动创建。

属性：

方法：

  • getRoute: 获取指定索引的线路方案

Position

检索结果的位置点

构造：

属性：

  • point: 位置点的经纬度坐标
  • address: 位置点的地址信息
  • city: 位置点的所属城市信息
  • name: 位置点的名称
  • phone: 位置点的电话信息
  • postcode: 位置点的邮编信息

Route

地图中的路线对象

说明：

从Overlay对象继承而来，可通过Map对象的addOverlay()方法将对象添加地图中。

构造：

属性：

UserLocationCallback

获取用户当前位置信息成功回调 

void onSuccess( state, point ) {
	// Get location code
}

参数：

  • state: ( Number ) 必选 获取用户位置操作状态码，0表示成功，其它为错误码
  • point: ( Point ) 必选 位置经纬度坐标，如果获取操作失败则为null对象

返回值：

void : 无

ClickEventHandler

用户点击地图回调事件 

void onClick( point ) {
	// Click code
}

参数：

  • point: ( Point ) 必选 用户在地图上点击的坐标点

返回值：

void : 无

OverlayClickEventHandler

用户点击地图覆盖物回调事件 

void onClick( overlay ) {
	// Click code
}

参数：

  • overlay: ( Overlay ) 必选 用户在地图上点击的覆盖物对象
    overlay可以是Marker、Bubble、Circle、Polyline、Polygon对象的引用。

返回值：

void : 无

PoiSearchCallback

兴趣点检索完成事件 

void onPoiSearchComplete( state, result ) {
	// JS code.
}

说明：

在兴趣点检索完成时触发，并返回检索结果。

参数：

  • state: ( Number ) 必选 检索结果状态号
    0表示检索正确并返回结果，其它表示检索错误。
  • result: ( SearchPoiResult ) 必选 POI检索结果
    若检索错误，则为null对象。

返回值：

void : 无

RouteSearchCallback

线路检索完成事件 

void onRouteSearchComplete( state, result ) {
	// JS code.
}

说明：

在线路检索完成时触发，并返回检索结果。

参数：

  • state: ( Number ) 必选 检索结果状态号
    0表示检索正确并返回结果，其它表示检索错误。
  • result: ( SearchRouteResult ) 必选 线路检索结果
    若检索错误，则为null对象。

返回值：

void : 无

相关文章

最新发布

阅读排行

热门文章

猜你喜欢

学到老在线代码浏览器 关闭浏览
友情链接: hao123 360导航 搜狗网址导航 114啦网址导航 博客大全
Copyright © 1999-2014, WEBKFA.COM, All Rights Reserved  京ICP备14034497号-1