Java SE引路蜂地圖開發示例

作者：mapdigit 2012-07-13 14:36:07

引路蜂開發包License分兩部分，一個為License文件guidebee.lic ,另一部分為License文件對應的注冊碼，需在程序運行前初始化。

引路蜂地圖也提供對Java SE平臺的支持，可以開發桌面地圖應用，由于Java SE的跨平臺特性，使用Java SE引路蜂地圖開發包開發的地圖應用可以運行于Windows ，Lunix，Unix，Mac OS等平臺。開發桌面應用比開發移動應用要容易的多，屏幕，內存等方面都比移動平臺要寬裕的多。

下面使用一個簡單的應用來介紹一下Java SE引路蜂地圖開發。示例截圖如下

設置引路蜂地圖開發包License

引路蜂開發包License分兩部分，一個為License文件guidebee.lic ,另一部分為License文件對應的注冊碼，需在程序運行前初始化

LicenceManager licenceManager = LicenceManager.getInstance();  
ong keys[]= {0x41c0df1c118b1831L,0x21884a37bde642bcL,0x15c4d489531ac173L,  
  0x5f9e69136c1e3268L,-0x3adaa84e455c5acL,0x2095f679b184dbdfL,};  
icenceManager.addLicence("GuidebeeMap_JavaSE", keys);

設置Java SE平臺相關圖形系統實現

引路蜂地圖開發包，在設計時盡量做到平臺無關性，將一些平臺相關的部分，如圖形系統以接口形式定義，如IFont，IGraphics，AbstractGraphicsFactory，IImage。這樣在應用到具體平臺時，加上平臺相關的實現，可以實現同一個庫應用到不同的平臺。這些平臺實現是以源碼提供的，如在Java SE平臺，提供了JavaSEFont，JavaSEGraphics，JavaSEGraphicsFactory和JavaSEImage類定義，可以參見引路蜂地圖API概述。

初始化地圖對象及設置服務回調函數

MapConfiguration.setParameter(MapConfiguration.WORKER_THREAD_NUMBER, 16);  
mapTileDownloadManager = new MapTileDownloadManager(this);  
map = new RasterMap(2048, 2048, mapTileDownloadManager);  
map.setScreenSize(mapLabel.getWidth(), mapLabel.getHeight());  
mapTileDownloadManager.start();  
map.setMapDrawingListener(this);  
GeoLatLng center = new GeoLatLng(32.0616667, 118.7777778);  
map.setCenter(center, 4, MapType.MICROSOFTCHINA);  
map.setRoutingListener(this);  
map.setGeocodingListener(this);  
map.setReverseGeocodingListener(this);

上述代碼設置地圖工作線程數為16，一般來說增加工資線程數可以提高地圖下載及響應速度。
創建地圖對象，設置顯示區域（屏幕）大小。此外地圖服務如查詢地址，獲取路徑都是采用異步方式，通過設置回調函數如setRoutingListener，setGeocodingListener，setReverseGeocodingListener等來通知應用。

設置地圖中心和地圖類型

GeoLatLng center = new GeoLatLng(32.0616667, 118.7777778);  
map.setCenter(center, 4, MapType.MICROSOFTCHINA);

地圖縮放

RasterMap的 ZoomIn，ZoomOut用來放大和縮小地圖，setZoom可以設置地圖級別。

地圖平移

RasterMap 有兩個方法可以用于平移地圖，panTo 將地圖移動到指定經緯度坐標，panDirection(dx,dy)　將地圖從當前位置平移dx,dy 個象素。下列示例可以上，下，左，右平移地圖。

地址查詢

地址查詢（或稱為地址編碼）是將輸入的地名（如南京林業大學）轉換成對應的經緯度坐標然后將其顯示在地圖上。

所有的地圖服務都是采用異步方式調用，在調用RasterMap.getLocation(address)前，需要設置好返回結果時的回調函數RasterMap.setGeocodingListener，回調函數接口定義為IGeocodingListener。回調方法為public void done(String query,MapPoint[] result) ，如果查詢結果不為空，則reusult 為查詢結果的數組。示例中將地圖轉到第一個查詢結果。

對于MapAbc 地圖服務，還可以指定城市編碼，如南京編碼為２５。public void getLocation(int citycode,String query, IGeocodingListener listener);

路徑查詢

可以通過RasterMap的getDirection()方法來查詢路徑，和查詢地址類似，路徑查詢的結果也是通過回調函數的方式來通知應用程序的，下面的例子返回南京到北京的路徑。返回結果存放在MapDirection中，MapDirection包含了路徑的詳細信息，包括路徑的每個步驟，長度，時間，方向等。

地圖服務可以選擇使用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);

本地查詢

本地查詢可以查詢指定區域內諸如賓館，郵局等用戶感興趣的地方。其使用方法和地址查詢非常類似。

本地查詢方法public void getLocations(String address,int start,GeoLatLng center,GeoBounds bound, IGeocodingListener listener);
指定中心點和查詢區域。本地查詢可以多次返回結果，start為查詢結果起始順序，每次返回結果在SearchOptions 中定義，缺省每次返回４個。

選擇地圖服務

引路蜂地圖服務缺省使用Google地圖服務，但你也可以選擇其它地圖服務，比方說當Google服務離線時，您可以選擇MapAbc的地圖服務，另外要注意的是中國地圖是有偏移的。如果想使用無偏移的中國地圖，一是采用地圖偏移校正算法，另外一個是使用CloudMade地圖服務。

所前所述，引路蜂地圖開發包在設計時將地圖圖片顯示和地圖服務兩部分設計成相對獨立的兩部分，Google中國地圖圖片，Bing中國地圖圖片，MapAbc中國地圖圖片是有偏移的地圖圖片，CloudMade（OpenStreet）中國地圖圖片是無偏移的。而Google中國地圖服務，MapAbc中國地圖服務是有偏移，CloudMade地圖服務是無偏移的。所以在選擇地圖類型和地圖服務類型時，要么都選擇有偏移，要么都選擇無偏移。否則地圖在顯示路徑時或地址時就不匹配。

下面列表是合法的組合: