引路蜂移动软件

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

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

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

尽管前面引路蜂二维图形库的例子是以Silverlight为例，但引路蜂二维图形库可以用于Java ME,BlackBerry, LWUIT, Windows Mobile ,Windows Phone, Android, iPhone, Java SE ,Mono 等各个平台，以Silverlight为例是因为Silverlight可以实现在线演示。 在线演示

引路蜂二维图形库支持矢量字体，包括中文和英文。对于Silverlight应用，由于访问权限的问题，字库一般需作为资源文件包含在应用中，对于英文字体不是个大问题，而对于中文字库，GB2312字库文件最小也要4M以上，所以尽量是用同一字体。引路蜂二维图形库绘制文字时是采用的矢量字库。也可以对文字内部进行填充。文字方向可以从左到右，从上到下，从右到左。字体下载链接如下表：字体

Graphics2D提供了FillPolygon ，drawPolyline来填充和绘制多边形和多义线private void Polys(){ AffineTransform mat1; /** Colors */ Color redColor = new Color(0x96ff0000, true); Color greenColor = new Color(0xff00ff0

FillOval 和DrawOval 用来填充和绘制椭圆。下面例子显示椭圆的用法。private void Ovals(){ Color redColor = new Color(0x96ff0000, true); Color greenColor = new Color(0x00ff00); AffineTransform mat1; mat1 = new AffineTrans

在Window Mobile 和Java　ME中画线只支持线宽为1,引路蜂二维图形库允许指定Pen的宽度。下例显示了多条不同宽度的线段。 private void Lines(){ Color greenColor = new Color(0x00ff00,false); //Clear the canvas with white color. graphics2D.Clear

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

引路蜂二维图形库也提供了对一般路径的支持，可以同过线段，二次曲线，三次曲线组成路径，也可以根据SVG指令来定义路径。private void Paths() { AffineTransform mat1; /* The path. */ Path path; /** Colors */ Color redColor = new Color(0x96ff0000,

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

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

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

类Path为一条几何路径，可以通过直线，二次曲线，三次曲线来构成任意路径。Path提供了moveTo, lineTo, curveTo, curveToCubic, closePath方法来构成路径。下面的例子动态显示一条Bezier曲线。/*** The animation thread.*/Thread _thread;bool _drawn;/** * The rando

类Graphics2D同样提供了绘制位图的方法，drawImage(). 下面的例子显示卫星地图。卫星地图有卫星照片和道路名称组合而成，所选的原始图像，可以参见http://www.mapdigit.com/guidebeemap/maptile.php?type=MICROSOFTSATELLITE&x=7&y=4&z=14 maptile_7_4.jpghttp

除了单色，渐变画刷外，也可以使用图像作为模式（Pattern）画刷来填充图形。下面的例子使用两个PNG图像来填充图形。private void Patterns(){ TextureBrush brush1; TextureBrush brush2; TextureBrush brush3; AffineTransform matrix1 = new

颜色渐变(Gradient)定义了颜色从一种颜色到另一种颜色的平滑过渡，引路蜂二维图形库支持线性和圆形渐变private void Gradients(){ /* The linear gradient color */ LinearGradientBrush brush1; /* The radial gradient color */ RadialGradientBrush br

类AffineTransform用于二维平面上坐标变换。可以对坐标进行平移，缩放，旋转等变换。下面例子显示了坐标变换的用法。private void Transform(){ Path path; /* The first matrix */ AffineTransform matrix1 = new AffineTransform(); /* The second matrix

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

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

线段连接类型(LineJoin)指定了线段了连接的方式，有三种不同的连接类型JOIN_MITER, JOIN_ROUND和OIN_BEVEL。下面类型显示了三种不同的LineJoin类型。 private void LineJoin(){ Color blackColor = new Color(0x000000); Color whiteColor = new Color(0x

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

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

引路蜂二维图形库中的颜色值是个32位整数，采用0xAARRGGBB格式。Alpha通道指定了颜色的透明度，0×00表示全透明，0xFF表示完全不透明。下面的代码显示了如何创建不透明和半透明的颜色。private void Colors(){ /** * The solid (full opaque) red color in the ARGB space */ Color

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

这个例子说明如何使用Graphics2D对象来绘制各种几何图形。引路蜂二维图形库中定义里多种基本几何图形，如，点，线段，曲线和矩形等。接口PathIterator定义了从Path中获取路径元素的方法。接口IShape定义了描述几何图形公用的方法。点类Point定义了二维空间位置在(x,y)一个点。Point point = new Point (x, y); 创建一个点对象。此外Point

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

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

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

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

直线的虚线摸板(DashArray)指出了虚线的模式和间隔。下面的例子使用了不同的Dash Pattern来显示同一条线段。private void Dashes(){ Color blackColor = new Color(0x000000); int[] dashArray1 = { 2, 2 }; int[] dashArray2 = { 6, 6 }; int[] dash

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

引路蜂地图开发包提供对大多数平台的支持，在不同平台编写应用时所用的工具和设计语言不尽相同，引路蜂地图开发包主要以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  来绘制几何图形或是图象。这些绘图的接口不同，如果在引路蜂地图开发包直接引用这些类方法，这样不同平台就会需要编译不同的开发包。通过抽象处理，引路蜂地图开发包并直接调

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

LineCap 指定了开放路径端点的形状。有三种不同的类型：CAP_BUTT, CAP_ROUND和CAP_SQUARE。下面代码显示了三种不同的LineCap类型。 private void LineCap(){ Color blackColor = new Color(0x000000); Color whiteColor = new Color(0xffffff); gr

Windows Phone 7 并不是Windows Mobile 6.x 的升级版，也就是说 Windows Phone 7 SDK 没有提供对 Windows Mobile .Net Compact Version的向下兼容。“它所带来的后果之一就是，之前的Windows Moible应用程序无法在Windows Phone 7系列上运行。” Windows Phone 7 SDK 是基于Si

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

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

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