引路蜂移动软件

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

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

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

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

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

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

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

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

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

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

不管是在线地图，离线地图还是矢量地图，对于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都不是很方便。引路蜂地图开发包提供了对几乎所有软件平台（桌面和移动平台）的支持，采用统一

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

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

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

从.Net C#到 Cocoa Touch Objective C的移植工作进行得比较缓慢，完成了二维图形库内部类大约２０多个类的移植，工作量太量，最终决定放弃，这里对移植工作作个小结，以作为以后移植工作参考。１.　Name space   Objective C 不支持命令空间，而是采用前缀的方式来避免命名冲突。在C#库有外部类和内部类之分，开发包中内部类一般有internal 或是不想

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

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

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

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

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

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

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

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

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