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返回在该点位置的行程描述
    返回顶部