引路蜂移动软件

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

IP地址查询，可以根据IP地址查询到该IP所在的地理经纬度坐标，比如下述例子查询IP 地址58.192.32.1，所在经纬度为118.777802,32.061699，为南京大学所在地.注：目前IP查询结果总是以英文返回，如上述结果详细内容。ISP：”China Education and Research Network”Organization: “Nan Jing University”

在开发应用的过程中，常常需要在地图上需绘制一点自定义的兴趣点或是自定义的几何图形。引路蜂地图包中RasterMap最终提供的基实就是一张图片。protected void paint(Graphics g) { map.paint(mapGraphics); g.drawImage((Image) mapImage.getNativeImage(

本地查询可以查询指定区域内诸如宾馆，邮局等用户感兴趣的地方。其使用方法和地址查询非常类似。下面示例查询32.0616667, 118.7777778为中心点一定区域内宾馆的信息。//--------------------------------- PACKAGE ------------------------------------package com.pstreets.gisen

可以通过RasterMap的getDirection()方法来查询路径，和查询地址类似，路径查询的结果也是通过回调函数的方式来通知应用程序的，下面的例子返回南京到北京的路径。返回结果存放在MapDirection中，MapDirection包含了路径的详细信息，包括路径的每个步骤，长度，时间，方向等。//--------------------------------- PACKAGE ---

引路蜂地图API中同样提供了地址查询，路径查询，本地搜索，IP地址查询，地址反编码（通过经纬度查地名）等。 地址查询（或称为地址编码）是将输入的地名（如南京林业大学）转换成对应的经纬度坐标然后将其显示在地图上。 package com.pstreets.gisengine.demo.midp; //--------------------------------- IMPORTS -

RasterMap的 zoomIn,zoomOut 用来放大缩小地图。//--------------------------------- PACKAGE ------------------------------------package com.pstreets.gisengine.demo.midp; //--------------------------------- I

RasterMap 有两个方法可以用于平移地图，panTo 将地图移动到指定经纬度坐标，panDirection(dx,dy)　将地图从当前位置平移dx,dy 个象素。下列示例可以上，下，左，右平移地图。package com.pstreets.gisengine.demo.midp; //--------------------------------- IMPORTS ------

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

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

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

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

引路蜂地图开包中也提供了对ＧＰＳ定位信息处理的支持，由于各种移动设备上对GPS支持的不同，比如在 Java ME 上有 ＪＳＲ１７９，iphone 上有　Core Location。您可以使用平台自带的定位ＡＰＩ配合引路蜂地图开包使用。也可以使用引路蜂地图开包中定位ＡＰＩ。引路蜂地图开包定位ＡＰＩ提供了对ＮＭＥＡ２．０数据的处理，可以获取当前经纬度，卫星位置，方向，速度等。这是使用引路蜂定位Ａ

在手机上，离线地图包一般放在SD卡上，然后通过文件读取。这里为简单起见，将离线放在例子的资源目录中和应用编译在一起。实际应用中请单独存放这些地图包。引路蜂地图开发包支持同时读取多个地图包，这是通过MapTiledZone类和MapTileStreamReader类来完成的。每个地图包对应于一个MapTiledZone，地图包对每张地图建立的索引以加速图片检索将记录地图包存放的区域和缩放级别。而类M

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

前文说过，引路蜂地图开发包除了支持自带的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

地址反编码是通过经纬度查询对应的地名，下面示例是查询经纬度为118.777802,　32.061699对应的地名，结果为”中国江苏省南京市鼓楼区渊声巷41号”。注意使用字符串经纬度格式时，纬度在前，经度在后，如果反了，则返回的地名或能为空或都跑到外国去了。结果也是一个数组，一般到第一个结果，后面结果是更大的区域或是距离相对较远的地名。//--------------------------

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

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

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

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

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

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

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

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

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

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

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

下面的代码显示中国南京地图//------------------------------------------------------------------------------// COPYRIGHT 2011 GUIDEBEE// ALL RIGHTS RESERVED.//

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

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

Java ME引路蜂地图开发实例基本上都是以Netbean 6.x 作为开发的IDE，这里先说明一下如何在Netbean 项目中添加引路蜂地图开发库。引路蜂Java ME开发库可以同时用于MIDP，LWUIT和Blackberry。其中MIDP，LWUIT应用都可以使用Netbean做为首选IDE。Blackberry应用使用RIM自己的BlackBerry JDE 6.0.0。在后面再做介绍

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

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

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

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