使用引路蜂地图开发包前的一些基本知识

引路蜂地图开发包提供对大多数平台的支持，在不同平台编写应用时所用的工具和设计语言不尽相同，引路蜂地图开发包主要以Java 和 C# 支持各个平台，后面将以具体的各个平台介绍引路蜂地图开发包的使用方法，具体平台包括：Java ME,  LWUIT, Blackberry, Windows Mobile, Android ,iPhone , Mono , Java SE ,Winodws Phone 7, .Net Framework Desktop 等。各个平台的使用方法大同小异，这对于开发多平台地图应用是很有帮助。在一个平台上的知识或是代码可以很容易的移植到另一个平台。

引路蜂地图开发包使用许可
使用引路蜂地图开发包需要合法的使用许可，使用许可（Licence）分为试用和商用两种，试用许可为免费。如果您需要发布你的地图应用软件，则需要商用许可。
开发包使用试用许可时，在地图会显示“Guidebee”水印，有些功能可能不提供。从版本２.１开始，试用版取消了时间上的限制。
商用许可需要付费后使用，具体可以参见我们的网站。http://www.guidebee.biz 或是发信到 james.shen@guidebee.biz询问。

Google, CloudMade,MapAbc 地图 Map Key
引路蜂地图开发包提供了对Google地图，CloudMade地图服务以及MapAbc地图服务的支持，这些地图服务提供商有自已的地图服务作用许可，您可能需要申请他们的Map Key来合法使用他们的服务。引路蜂地图开发包中的MapKey和 MapKeyRepository用来管理这些Map Key，但在开始时您可以使用开发包中自带的Map Key来开发调试您的地图应用。
例如：下面代码在MapKeyRepository增加你自已的Google Map Key。

MapKeyRepository.addMapKey(MapKey.MAPKEY_TYPE_GOOGLE,yourgoogleKey);

地图配置
地图配置主要是通过类MapConfiguration 和 SearchOptions来设置。
这里给出最常用的几个配置。
    工作线程数
    引路蜂地图开发包允许用户配置同时工作的最大工作线程数，这些工作线程主要用来从地图服务器上下载地图图片。缺省设置为４。
    这是通过MapConfiguration. WORKER_THREAD_NUMBER 来配置的。
     例：下面将工作线程数设置１６。

 

MapConfiguration.setParameter(MapConfiguration.WORKER_THREAD_NUMBER, 16);

使用缓存
    引路蜂地图开发包缺省是使用缓存来存放最近下载的图片以提高地图显示效率，但缓存的使用会占用一定的内存，大小可以通过配置，缺省大小为２５６K。如果设备内存比较小，也可以关闭缓存。
    大小是通过　MapConfiguration. MAP_CACHE_SIZE_IN_BYTES 来配置，开启关闭缓存是通过　MapConfiguration. IS_CACHE_ON 来设置。

    查询配置
    在使用地图服务查询地址，路径时的一些配置主要通过 SearchOptions 在设置，可以设置结果返回的语言，每次返回结果最大数等。
    指定语言时采用　语言编码来设置。
    例如：下面指定语言为繁体中文。

DigitalMapService.getSearchOptions().LanguageID="zh-tw";