引路蜂移动软件

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

打开Visual studio 创建一个新项目WM6GISEngineTutorial。把Form1改名为MainForm，添加对引路蜂类库的引用，并把guidebee.lic做为Content添加到项目中。我们将使用MainForm来显示地图，下面的例子显示南京地图，缩放级别为13级，地图类型为Bing中国地图。using System;using System.Windows.For

创建RasterMap实例之后，可以对其进行放大，缩小，平移，设置地图类型等操作。在第一个地图应用中，在调用RasterMap.setCenter 时可以指定地图类型，另外也可以使用RasterMap.setMapType来更改地图类型，地图开发包中定义了Google 地图，Google 中国地图，Bing 地图，Bing 卫星图等２０多种地图类型，也就可设置自已定义地图类型。在MainF

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

在正式介绍Windows Mobile引路蜂地图开发示例前，先说明一下开发环境和要些准备工作。Windows Mobile 6.x引路蜂地图开发示例采用Visual Studio 2008为开发环境，为了达到类库最大兼容性，引路蜂地图开发包是基于.Net Framework 2.0开发的，所以类库可以用于2.0以上.Net Framework (包括Desktop 和 Compact Framew

引路蜂地图开发包以.Net Framework类库形式支持Windows Mobile 6.x ,Windows Phone 7 , iPhone (MonoTouch) 以及Windows ,Mono (Linux GTK 等）。首先先介绍在Windows Mobile 6.x平台上开发的示例。引路蜂地图开发包在Windows Mobile平台中除了提供地图开发API外，还包含了一个二维图形

Windows Mobile引路蜂地图开发包带有一个高效二维图形库，这是因为诸如LineCap, LineJoin, Brush, TextBrush, Path 等方法在Windows .Net Compact Framework 平台上不支持。Windows Mobile引路蜂地图开发包中的二维图形库弥补了这些缺陷，它提供了在桌面平台System.Drawing.Drawing2D中相应功能。

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

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

RasterMap的 zoomIn,zoomOut 用来放大缩小地图。在MainForm中添加两个菜单项mnuZoomIn，mnuZoomOut.private void mnuZoomIn_Click(object sender, EventArgs e) { _rasterMap.ZoomIn(); } private void mnuZoomOut_Click(objec

Windows Mobile引路蜂地图开发示例：放大、缩小RasterMap 有两个方法可以用于平移地图，panTo 将地图移动到指定经纬度坐标，panDirection(dx,dy)　将地图从当前位置平移dx,dy 个象素。在第一个例子中通过响应MouseDown，MouseMove，MouseUp,可以通过触摸屏来平移地图。下面代码可以向四个方向平移地图（移动32个像素)_rast

引路蜂地图API中同样提供了地址查询，路径查询，本地搜索，IP地址查询，地址反编码（通过经纬度查地名）等。地址查询（或称为地址编码）是将输入的地名（如南京林业大学）转换成对应的经纬度坐标然后将其显示在地图上。在MainForm上增加一个菜单项mnu_FindAddress, 同时MainForm需要实现IGeocodingListener接口。 private void mnuFind

前面基本介绍了引路蜂地图在各个平台开发的基本方法。提起地图开发包，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

可以通过RasterMap的getDirection()方法来查询路径，和查询地址类似，路径查询的结果也是通过回调函数的方式来通知应用程序的，下面的例子返回南京到北京的路径。返回结果存放在MapDirection中，MapDirection包含了路径的详细信息，包括路径的每个步骤，长度，时间，方向等。在MainFrom上添加一个mnuGetDirection菜单项，并让MainForm实现IR

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

引路蜂地图服务缺省使用Google地图服务，但你也可以选择其它地图服务，比方说当Google服务离线时，您可以选择MapAbc的地图服务，另外要注意的是中国地图是有偏移的。如果想使用无偏移的中国地图，一是采用地图偏移校正算法，另外一个是使用CloudMade地图服务。所前所述，引路蜂地图开发包在设计时将地图图片显示和地图服务两部分设计成相对独立的两部分，Google中国地图图片，Bing中国地

地址反编码是通过经纬度查询对应的地名，下面示例是查询经纬度为118.777802,　32.061699对应的地名，结果为”中国江苏省南京市鼓楼区渊声巷41号”。在MainFrom上添加mnuReverseGeocoding菜单项，并且MainForm实现IReverseGeocodingListener接口public void Done(string query, MapPoint[]

IP地址查询，可以根据IP地址查询到该IP所在的地理经纬度坐标，比如下述例子查询IP 地址58.192.32.1，所在经纬度为118.777802,32.061699，为南京大学所在地。在MainForm上添加mnuIPSearch菜单。并在MainForm中实现IIpAddressGeocodingListener接口用于响应查询结果public void Done(string que

本地查询可以查询指定区域内诸如宾馆，邮局等用户感兴趣的地方。其使用方法和地址查询非常类似。下面示例查询32.0616667, 118.7777778为中心点一定区域内宾馆的信息。在MainForm上添加mnuLocalSearch菜单项public void Done(string query, MapPoint[] result){ if (result != null) {

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

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

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

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

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

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

定义平台无关二维图形库类定义。其功能和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单个地图图层，一个图层可由地图

同样在移植的过程中，发现 .Net compact Framework 不支持透明图像。原本具有透明属性的Png (含有 alpha通道），通过 Graphics.DrawImage 显示之后，不再具有透明特性。这对于地图分层显示带了麻烦。举例来说。带地名卫星地图一般是由两层图片叠加而成。两个图片叠加形成最后的图片当由于.Net Compact Framework缺省不支持透明图像

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

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