Java ME引路蜂地图开发示例：路径查询

可以通过RasterMap的getDirection()方法来查询路径，和查询地址类似，路径查询的结果也是通过回调函数的方式来通知应用程序的，下面的例子返回南京到北京的路径。返回结果存放在MapDirection中，MapDirection包含了路径的详细信息，包括路径的每个步骤，长度，时间，方向等。

//------------------------------------------------------------------------------
//                         COPYRIGHT 2011 GUIDEBEE
//                           ALL RIGHTS RESERVED.
//                     GUIDEBEE CONFIDENTIAL PROPRIETARY
///////////////////////////////////// REVISIONS ////////////////////////////////
// Date       Name                 Tracking #         Description
// ---------  -------------------  ----------         --------------------------
// 28JAN2011  James Shen                              Initial Creation
////////////////////////////////////////////////////////////////////////////////
//--------------------------------- PACKAGE ------------------------------------
package com.pstreets.gisengine.demo.midp;
 
 
//--------------------------------- IMPORTS ------------------------------------
import com.mapdigit.gis.MapDirection;
import com.mapdigit.gis.geometry.GeoLatLng;
import com.mapdigit.gis.raster.MapType;
import com.mapdigit.gis.service.IRoutingListener;
import com.pstreets.gisengine.demo.MapDemoMIDP;
import javax.microedition.lcdui.Command;
import javax.microedition.lcdui.CommandListener;
import javax.microedition.lcdui.Display;
import javax.microedition.lcdui.Displayable;
 
 
//[------------------------------ MAIN CLASS ----------------------------------]
//--------------------------------- REVISIONS ----------------------------------
// Date       Name                 Tracking #         Description
// --------   -------------------  -------------      --------------------------
// 28JAN2011  James Shen                              Initial Creation
////////////////////////////////////////////////////////////////////////////////
/**
 *  Map routing demo for Guidebee Map API on MIDP platform.
 * <hr><b>&copy; Copyright 2011 Guidebee, Inc. All Rights Reserved.</b>
 * @version     1.00, 28/01/11
 * @author      Guidebee Pty Ltd.
 */
public class MapRoutingMIDP extends MapDemoMIDP implements CommandListener,
        IRoutingListener {
 
 
    private Command mapGetDirectionCommand = new Command("Get Direction",
            Command.OK, 1);
 
 
    public void startApp() {
 
 
        init();
        canvas.addCommand(mapGetDirectionCommand);
        map.setRoutingListener(this);
        canvas.setCommandListener(this);
        GeoLatLng center = new GeoLatLng(-31.948275, 115.857562);
        map.setCenter(center, 13, MapType.GOOGLEMAP);
 
 
        Display.getDisplay(this).setCurrent(canvas);
    }
 
 
    public void commandAction(Command c, Displayable d) {
        if (c == mapGetDirectionCommand) {
            String name1 = "南京";
            String name2 = "北京";
            map.getDirections("from: " + name1 + " to: " + name2);
 
 
        }
    }
 
 
    public void done(String query, MapDirection result) {
        if (result != null) {
            map.setMapDirection(result);
            map.resize(result.getBound());
            map.setZoom(3);
 
 
        }
    }
}

地图服务可以选择使用Google 地图服务，CloudMade地图服务，在中国还可能选择MapAbc地图服务，缺省使用Google 地图服务。
getDirections()具有三个重载函数，例子中是采用的文字描述方式。上述示例采用了from: address1 to: address2 的格式， CloudMade地图服务和MapAbc地图服务则必需采用 经度１，纬度１，经度２，纬度２和格式。
为避免混淆，可以使用下述格式。
public void getDirection(GeoLatLng[] waypoints, IRoutingListener listener);
其中 waypoints 为途径点坐标数组经纬值，可以支持多点路径查询。
此外对于MapAbc 地图服务，还可以指定城市编码，如南京编码为２５。
public void getDirection(int citycode,String query, IRoutingListener listener);