51ditu Nav API 类参考文档2008-6-10 [更新到1.1]

本文档是灵图提供的51ditu Nav api的类参考文档,用来实现驾驶导航的功能,更多详细的使用范例和说明请访问51ditu API开发文档页面,API使用交流清访问51ditu产品论坛

类列表:
LTNavigate  LTNavigateResult  LTNavigatePoint 

类 LTNavigate

51ditu Navigate API之中的驾驶导航类,这也是Navigate API的最主要的类,用来进行导航操作,需要注意的是,因为导航线路的搜索过程采用的是异步操作,因此运行搜索之后并不能立即得到导航结果,而是传递一个[导航结果处理函数]给LTNavigate,在导航结果得到后,LTNavigate会自动的运行该[搜索结果处理函数]并将搜索结果作为参数传递,这样用户就可以得到并处理搜索结果。
构造函数:
函数名称最后更新版本返回值类型说明
LTNavigate(handle) LTNavigate创建一个驾驶导航类,一个页面上可以根据需求创建多个驾驶导航类
  • 范例:使用驾驶导航接口
  • 范例:使用驾驶导航的途经点功能
  • 范例:使用驾驶导航的避让区域功能
  • 方法:
    函数名称最后更新版本返回值类型说明
    setFrom(city,name,point) 设置导航的起点
    setTo(city,name,point) 设置导航的终点
    setWayPoint(points) 1.1设置途经点,导航结果会顺次经过这些位置
    setAvoidDistrict(points) 1.1设置避让区域,导航结果会绕过这些区域
    navigate() 开始导航,在开始之前,必须已经设置起点和终点
    事件:
    事件名称最后更新版本参数说明
    loadend (result) 在每次获得导航结果时触发,将会把导航结果作为事件参数返回,使用此事件可以不必在LTNavigate的构造函数之中传递参数,而且可以实现多个搜索结果处理函数,因此具有更大的灵活性
    返回顶部

    类 LTNavigateResult

    驾驶导航结果对象,将返回给用户处理,包含所有的导航线路信息。
    方法:
    函数名称最后更新版本返回值类型说明
    getStartCity() String返回查询的起点城市的名称
    getEndCity() String返回查询的终点城市的名称
    getStartPlace() String返回查询的起点关键字
    getEndPlace() String返回查询的终点关键字
    getLength() Number得到路程的总长度,单位可以从getUnit()方法之中获得
    getUnit() String得到路程的总长度计算单位
    getTime() Number取得行程的预计使用时间,以分钟为单位
    getKeyPoints() LTNavigatePoint数组取得道路关键点的点集合和说明信息,方法返回一个LTNavigatePoint数组
    getRoadTrack() LTPoint数组取得线路详细的经由点列表
    返回顶部

    类 LTNavigatePoint

    导航结果的途经点对象
    方法:
    函数名称最后更新版本返回值类型说明
    getName() 1.1String返回该点的所在位置的名称
    getPoint() LTPoint返回该点的坐标
    getDescription() LTPoint返回在该点位置的行程描述
    返回顶部