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

引路蜂地图API中同样提供了地址查询，路径查询，本地搜索，IP地址查询，地址反编码（通过经纬度查地名）等。 

地址查询（或称为地址编码）是将输入的地名（如南京林业大学）转换成对应的经纬度坐标然后将其显示在地图上。 

//------------------------------------------------------------------------------
//                         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.MapPoint;
import com.mapdigit.gis.geometry.GeoLatLng;
import com.mapdigit.gis.raster.MapType;
import com.mapdigit.gis.service.IGeocodingListener;
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 pan 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 MapGeocodingMIDP extends MapDemoMIDP implements CommandListener,
        IGeocodingListener { 
 
    private Command mapFindAddressCommand = new Command("Find Address",
            Command.OK, 1); 
 
    public void startApp() { 
 
        init();
        canvas.addCommand(mapFindAddressCommand);
        map.setGeocodingListener(this);
        canvas.setCommandListener(this);
        GeoLatLng center = new GeoLatLng(32.0616667, 118.7777778);
        map.setCenter(center, 13, MapType.MICROSOFTCHINA);
        Display.getDisplay(this).setCurrent(canvas);
    } 
 
    public void commandAction(Command c, Displayable d) {
        if (c == mapFindAddressCommand) {
            String name = "南京林业大学";
            map.getLocations(name);
        }
    } 
 
    public void done(String query, MapPoint[] result) {
        if (result != null) {
            map.panTo(result[0].getPoint());
        }
    }
}

所有的地图服务都是采用异步方式调用，在调用RasterMap.getLocation(address)前，需要设置好返回结果时的回调函数RasterMap.setGeocodingListener，回调函数接口定义为IGeocodingListener。 回调方法为public void done(String query,MapPoint[] result) ，如果查询结果不为空，则reusult 为查询结果的数组。示例中将地图转到第一个查询结果。

对于MapAbc 地图服务，还可以指定城市编码，如南京编码为２５。
public void getLocation(int citycode,String query, IGeocodingListener listener);