Blackberry引路蜂地图开发示例：第一个地图应用
使用BlackBerry JDE 6.0.0创建一个新的Workspace, RIMGISEngineTutorial. 首先添加一个新的Lib项目libGISEngine, 在其中添加引路蜂开发库。然后添加HelloWorldRIM Blackberry应用，将libGISEngine设为项目HelloWorldRIM的依赖库（Project Dependencies).
同样为简单起见，设计一个共用类MapDemoRIM作为后续例子的基类。
//--------------------------------- PACKAGE ------------------------------------package com.pstreets.gisengine.demo; //--------------------------------- IMPORTS ------------------------------------import com.mapdigit.gis.MapLayer;import com.mapdigit.gis.drawing.IGraphics;import com.mapdigit.gis.drawing.IImage;import com.mapdigit.gis.raster.IMapDrawingListener;import com.mapdigit.gis.raster.IReaderListener;import com.mapdigit.gis.raster.MapTileDownloadManager;import com.mapdigit.gis.raster.RasterMap;import com.mapdigit.licence.LicenceManager;import com.pstreets.gisengine.demo.rim.drawing.RIMGraphicsFactory;import net.rim.device.api.ui.UiApplication;import net.rim.device.api.system.Bitmap;import net.rim.device.api.ui.Graphics;import net.rim.device.api.ui.container.MainScreen;import net.rim.device.api.system.Display;import net.rim.device.api.ui.component.Menu;import net.rim.device.api.ui.TouchEvent; //[------------------------------ MAIN CLASS ----------------------------------]/** * Base class for all Map Demos. * <hr><b>© Copyright 2011 Guidebee, Inc. All Rights Reserved.</b> * @version 1.00, 06/02/11 * @author Guidebee Pty Ltd. */public abstract class MapDemoRIM extends UiApplication implements IReaderListener, IMapDrawingListener { protected RasterMap map; protected MapTileDownloadManager mapTileDownloadManager; protected IImage mapImage; protected IGraphics mapGraphics; protected MapCanvas canvas; public MapDemoRIM() { try { LicenceManager licenceManager = LicenceManager.getInstance(); //expires on Tue Mar 15 20:54:42 CST 2011 long keys[] = {0x34ba283b8daeb659L, -0x53c811f9da86e998L, -0x34ba25c3c581521eL, 0xf15df9fc7e45628L, 0x6a4ece44296c0287L, 0x4ab0cff532902b1cL,}; licenceManager.addLicence("GuidebeeMap_JavaME", keys); } catch (Exception ex) { ex.printStackTrace(); } } public void init() { canvas = new MapCanvas(); //set the graphics factory MapLayer.setAbstractGraphicsFactory(RIMGraphicsFactory.getInstance()); mapImage = MapLayer.getAbstractGraphicsFactory() .createImage(Display.getWidth(), Display.getHeight()); mapGraphics = mapImage.getGraphics(); //Create the Digital Map objects. mapTileDownloadManager = new MapTileDownloadManager(this); try{ map = new RasterMap(1024, 1024, mapTileDownloadManager); }catch(Exception e){} map.setScreenSize(Display.getWidth(), Display.getHeight()); mapTileDownloadManager.start(); map.setMapDrawingListener(this); } protected void createMenu(Menu menu, int instance){ } public void closeApp() { mapTileDownloadManager.stop(); } public void readProgress(int arg0, int arg1) { System.out.println(arg0 + "/" + arg1); } public void done() { if (canvas != null) { canvas.invalidate(); } } protected class MapCanvas extends MainScreen { private void panMap(float x, float y) { float dx = x - oldX; float dy = y - oldY; if(!(dx==0 && dy==0)) map.panDirection((int)dx, (int)dy); } boolean isPan=false; private float oldX = -1; private float oldY = -1; protected void paint(Graphics g) { map.paint(mapGraphics); Bitmap bitmap=(Bitmap) mapImage.getNativeImage(); g.drawBitmap(0,0,bitmap.getWidth(),bitmap.getHeight(),bitmap,0,0); } public void close(){ closeApp(); } protected boolean touchEvent(TouchEvent event){ int action=event.getEvent(); switch(action){ case TouchEvent.DOWN: oldX = event.getGlobalX(1); oldY = event.getGlobalY(1); isPan=true; break; case TouchEvent.UP: oldX = event.getGlobalX(1); oldY = event.getGlobalY(1); isPan=false; break; case TouchEvent.MOVE : if(isPan) { panMap(event.getGlobalX(1), event.getGlobalY(1)); oldX = event.getGlobalX(1); oldY = event.getGlobalY(1); } break; } return true; } protected void makeMenu(Menu menu, int instance){ createMenu(menu,instance); } }}类MapDemoRIM派生于UiApplication，为Blackberry应用对象。MapCanvas派生于MainScreen，用于显示地图，并响应TouchEvent，可以平移地图。
有了这个基类，HelloWorldRIM就比较简单，下面的例子显示南京地图，缩放级别为13级，地图类型为Bing中国地图。
//--------------------------------- PACKAGE ------------------------------------package com.pstreets.gisengine.demo.rim; //--------------------------------- IMPORTS ------------------------------------import com.mapdigit.gis.geometry.GeoLatLng;import com.mapdigit.gis.raster.MapType;import com.pstreets.gisengine.demo.MapDemoRIM; //[------------------------------ MAIN CLASS ----------------------------------]/** * Hello world demo for Guidebee Map API on RIM platform. * <hr><b>© Copyright 2011 Guidebee, Inc. All Rights Reserved.</b> * @version 1.00, 06/02/11 * @author Guidebee Pty Ltd. */public class HelloWorldRIM extends MapDemoRIM { /** * Entry point for application * @param args Command line arguments (not used) */ public static void main(String[] args) { // Create a new instance of the application and make the currently // running thread the application's event dispatch thread. HelloWorldRIM theApp = new HelloWorldRIM(); theApp.enterEventDispatcher(); } public HelloWorldRIM() { init(); pushScreen(canvas); GeoLatLng center = new GeoLatLng(32.0616667, 118.7777778); map.setCenter(center, 13, MapType.MICROSOFTCHINA); } }
Blackberry引路蜂地图开发包Ver2.1下载