引路蜂移动软件

Jave ME 平台Java ME地图应用开发环境Java ME引路蜂地图开发示例：第一个地图应用Java ME引路蜂地图开发示例：设置地图类型Java ME引路蜂地图开发示例：放大、缩小Java ME引路蜂地图开发示例：地图平移Java ME引路蜂地图开发示例：地址查询Java ME引路蜂地图开发示例：路径查询Java ME引路蜂地图开发示例：本地查询Java ME引路蜂地图开发示例：I

引路蜂地图开发包提供对大多数平台的支持，在不同平台编写应用时所用的工具和设计语言不尽相同，引路蜂地图开发包主要以Java 和 C# 支持各个平台，后面将以具体的各个平台介绍引路蜂地图开发包的使用方法，具体平台包括：Java ME,  LWUIT, Blackberry, Windows Mobile, Android ,iPhone , Mono , Java SE ,Winodws Phone

如前文所述，引路蜂地图开发包中Gis.Drawing 类定义了几个抽象类或接口，对不同平台的图形系统进行了抽象。以Java ME平台为例，可以使用Sun的LWUIT 或是MIDP 自带的javax.microedition.lcudi  来绘制几何图形或是图象。这些绘图的接口不同，如果在引路蜂地图开发包直接引用这些类方法，这样不同平台就会需要编译不同的开发包。通过抽象处理，引路蜂地图开发包并直接调

类的成员变量定义可以通过Class 的getFields()来取得Class aClass = ...//obtain class objectField[] methods = aClass.getFields();如果知道Field的名称，则可以通过getField() 取得对应的Field定义Class aClass = MyObject.classField fiel

Gis包中定义了一些通用的地图对象类:MapDirection定义路径查询结果，路径查询结果可以由多条路径组成。MapObject所有地图对象的基类.MapPoint地理几何图形点对象.MapRoute定义了单个路径对象.MapStep定义路径上单个步骤的详细信息，比如向左，向右等。DigitalM

过Class 的getMethods 可以取的类方法的定义Class aClass = ...//obtain class objectMethod[] methods = aClass.getMethods();如果知道类方法的参数类型，则可以使用getMethod 取的对应的方法定义,如：Class aClass = ...//obtain class objectMet

该包定义了地图对象中各种地理几何图形.GeoBounds定义地图对象的边界矩形。GeoLatLng点义一个经纬度坐标.以 latitude,longitude 表示。GeoLatLngBounds点义一个经纬度为单位的地图对象的边界柜形.GeoPoint定义平面坐标系中一个点，以x,y表示。GeoPolygon定义

如前文所述，该包对不同平台UI部分进行了抽象，定了图形系统的接口，在不同平台上使用地图名，只要实现这些接口，就可以在该平台上使用地图API，在发布的地图名包含了对这些接口的缺省实现，不同平台，这些接口的实现方法不尽相同.AbstractGraphcsFactory抽象图形类工厂，主要用于创建新的图象对象.IGraphicsGraphics接口定义，定义了用于

Java 的类常常带有setter 和getter 为类的成员变量赋值（类的属性）。setter 一般指以set开始的成员方法用于设置类的某个属性值，而getter 一般指一get开始的成员方法，用于去的类的某个属性值。setter 一般只带一个参数，而getter不带参数。下面的代码可以用来判断getter 和setter 方法： public static void printGe

前面描述的地图应用基本上都需要网络连接，每次更新地图都需要连接地图服务器。在编写地图客户端软件时，常常会想使用离线地图包，这样一来可以节省流量，同时也可以提高客户端响应能力。引路蜂软件在提供地图开发包的同时也提供了离线地图生成工具，可以用于地图开发包，可以做到显示地图时，先从本地地图包取出相应图片，如果本地没有，再从相应地图服务器上取图片。Guidebee 离线地图生成器的数据来源可以有三种。

引路蜂离线地图生成工具用于生成离线地图包，运行环境需要安装 .net framework 3.5.移动地图 加载文件 –> 读取离线文件 ，可以通过离线工具查看已生成的离线地图包，或者读取MapInfo矢量地图(不在免费版本中）上移，左移，右移，下移–>移动地图 ，也可以通过鼠标来拖动地图放大，缩小–>放大及缩小地图 服务器 –>在读取离线文件后，当时显示为离线地图包内

前文说过，引路蜂地图开发包除了支持自带的20多种地图类型外，还支持自定义地图类型。要支持自定义地图类型，首先要了解你需要支持的地图服务器的分片方法，目前几种主流的地图服务如Google地图，Bing地图，MapAbc地图地图分片方法基本类似，具体可以参考Bing地图地图分片方法。一般地图缩放级别为1-17级，每片图片为256X256大小的PNG图像。中国推出了天地图 http://www.ti

有了天地图地图图片的URL生成规则，就可以开始实行对自定义地图类型天地图的支持。引路蜂地图包中类MapType，接口ICustomMapType主要用来支持自定义地图。在类MapType中定义了 GENERIC_MAPTYPE_1 ，GENERIC_MAPTYPE_2 … GENERIC_MAPTYPE_7 用于支持自定义地图，其中类型 GENERIC_MAPTYPE_7 由两层组成（GENE

引路蜂地图也提供对Java SE平台的支持，可以开发桌面地图应用，由于Java SE的跨平台特性，使用Java SE引路蜂地图开发包开发的地图应用可以运行于Windows ，Lunix，Unix，Mac OS等平台。开发桌面应用比开发移动应用要容易的多，屏幕，内存等方面都比移动平台要宽裕的多。下面使用一个简单的应用来介绍一下Java SE引路蜂地图开发。示例截图如下设置引路蜂地图开发包

不管是在线地图，离线地图还是矢量地图，对于RasterMap来说最终都是一张张256×256大小的图象，在线地图是从地图服务器上下载图片，离线地图是从本地地图包中读取，而矢量地图是将矢量数据栅格化处理。RasterMap中含有一个MapTileDownloadManager实例，这个对象用于管理所用的地图图片下载，读取或是栅格化工作线程。这些线程都是MapTileAbstractReade

前面基本介绍了引路蜂地图在各个平台开发的基本方法。提起地图开发包，Google 地图和Bing 地图主要应用于Web应用，在离线方式和移动平台上它们并没有提供足够的支持，比如在Java ME平台上使用Google地图API或是在Android，iPhone平台上使用Bing地图。如在中国，想在Windows Mobile 平台上使用 MapABC地图API都不是很方便。引路蜂地图开发包提供

提起地图开发包，Google 地图和Bing 地图主要应用于Web应用，在离线方式和移动平台上它们并没有提供足够的支持，比如在Java ME平台上使用Google地图API或是在Android，iPhone平台上使用Bing地图。如在中国，想在Windows Mobile 平台上使用 MapABC地图API都不是很方便。引路蜂地图开发包提供了对几乎所有软件平台（桌面和移动平台）的支持，采用统一

DigitalMap类中带有对DigitalMapService类的一个引用, Digital Map Service 定义了地址编码，地址反编码，路径查询等地图服务。目前引路蜂地图包中实现了对Google地图服务 ,CloudMade地图服务, MapAbc地图服务的支持，缺省采用Google地图服务,对其它地图如 Bing地图也可以扩展实现。  注：您需要从不同地图服务提供商申请Map

下图为引路蜂地图开发包中关键的几个类定义及其关系图：上图中显示为绿色的三个类分别用于对不同平台UI,不同地图服务，不同地图图片的支持，引路蜂地图开发包设计时对地图图片和地图服务两部分进行了抽象，其中地图图片主要用于显示地图图片，地图图片可以来源于三个方面在线地图，可以连接包括Google Map， Bing Map 在内的二十多种地图，并支持自定义地图。离线地图，可以读取本地地图包

一般来说，不可以访问类的私有成员变量和调用类的私有方法。但通过Java Reflection API可以绕过这个限制，前面使用的getMethods, getFields,getConstructors 等方法都是返回的类的public 方法，类成员和构造函数。本篇介绍如何使用Java Reflection API来访问类的私有成员。1. 访问私有成员Class的getDeclared

该包定义了在线和离线地图对象相关的一些类.Map Type定义各种地图类型，如Google地图，Google卫星图，Bing 中国地图等。MapConfiguration定义地图的一些配置信息，如是否使用缓存，同时启动最大工作线程数目等.RasterMap显示在线地图和离线地图一个关键类.它是地图开发包最核心的一个类，实现地图平移，缩放，路径

这个包中定义了地址查询，地理反编码，路径查询，本地查询等地图服务的接口。DigitalMapServce各种地图服务（地址查询，路径）的实现。开发人员可以选择使用地图服务的类型，如使用Google 地图或是CloudMade地图服务，在中国的用户还可以选择使用MapAbc 地图服务。IDirectionQuery路径查询接口定义.IGeocode

前面Java  标注(Annotations)介绍 介绍了Java代码中Annotation的用法，使用Java Reflection API 也可以用来方法类，类成员或类方法的Annotation定义。1.类Annotations可以通过Class 的getAnnotations 来方法类的标注定义：Class aClass = TheClass.class;Annotation[

该包定义了矢量地图所用一些类.SutherlandHodgman实现 Sutherland-Hodgman剪裁算法.VectorMap矢量地图类，它是RasterMap的一个子类。矢量地图可以由多个图层组成。GeoSet多个地图图层的集合，并定义了图层之间的层次关系。MapFeatureLayer单个地图图层，一个图层可由地图

本包提供了路口到路口实时导航API，从地图服务器返回的路径信息含有文字和路径的地理坐标信息，类NavigationEngine根据路径和当前坐标实现实时导航。它内部含用三个工作线程：Location Monitor 实时监视当前位置坐标是否偏离路径，如果偏移，决定是否需要重新计算路径。语音命令生成　根据当前路径和位置预先生成语音命令列表。语音命令处理　从预先生成语音命令列表选取一个命令

本包定义了GPS接收器一个通用接口，并提供对NMEA 2.0数据的解码方法。在Java ME平台上对JSR179 进行了封装.Coordinates定义地址经纬度坐标。Location定义地址信息，如名称等。LocationProvider地理信息提供者，是所有GPS 设备的基类。Orientation提供当前GPS坐标中的方

定义平台无关二维图形库类定义。其功能和Java SE 中 Graphics2D或是 .Net 中System.Drawing 功能类似。提供Drawing包的的主要原因是部分移动平台自带的二维图形库功能比较弱。比如Java ME 平台上不支持线宽大于１的画笔等等。Brush画刷类。Color颜色类。Graphics2DGraphics2D

本包中定义了各种二维几何图形。基本上是参照Java SE 中相应类来定义实现的。PathIterator路径元素枚举类。IShapeShape接口定义了二维图形的一些基本方法。AffineTransform仿射变换类。Arc圆弧类。Area二维区域类。CubicCurve三次曲线类。

Decompiler下载用法：命令行运行：usagedecompiler  xxx.class  反编译单个class文件decompiler  directoryname   反编译该目录下所有.class文件，包括子目录。log.txt 为日志文件

下图是基于地图的应用一个典型软件构架图.

Java Reflection API 使得在运行时能够查看类，接口，类成员，方法的定义及描述。也可以使用Reflection API 动态创建类的实例，设置获取类成员的值（甚至类的私有成员）。很多工具包，如JUnit，RoboGuice，Guice等都依赖于Java Reflection API来访问类的定义。Java 的Reflection 相关的类java.lang.reflect

MapLayer 定义了通用的地图操作，如设置地图中心点，放大，缩小，移动，以及坐标变换（从屏幕到地图坐标或反向）， 它也是所有地图类的基类。MapLayerContainer 为一个集合类，它定义了一组MapLayer的集合及它们的上下层次关系，并且使这些MapLayer一起移动，放大或缩小等。DigitalMap 定义了地图服务，如地址查询，路径查询，它包含了对不地图服务的支持

使用Java Reflection (有翻译成反射的)API可以在程序运行时动态查询类的定义，查询类的定义是使用Java Reflection API 所要作的第一件事.也就是说所有反射操作的入口点为java.lang.Class 类。有下面几种方法可以取得某个数据类型对应的Class类：Object.getClass()当可以访问一个类型的实例对象时，一个简单的方法使用通过Objec

通过Class的getConstructors 可以取得类的所有构造函数定义。Class aClass = ...//obtain class objectConstructor[] constructors = aClass.getConstructors();如果知道构造函数的参数定义，可以直接取得对应的构造函数，如：Class aClass = ...//obtain cl

由于时间上的问题，已经有很长时间没有对引路蜂地图开发添加功能，因此决定对引路蜂地图开发包，此外征召有兴趣的开发人员共同开发引路蜂地图包 (联系Email：james.shen@guidebee.com)开源代码经过整理，将逐步投放在github ，目前采用GPL 开源协议。GitHub 地址 为 https://github.com/guidebee/  下引路蜂地图包分为Java和.Net版本，