UbiMap Demo

UbiMap矢量图引擎是由识途团队研发的矢量地图引擎，可用来显示商场、博物馆、景区等特定场所的精细地图。

特点：

操作流畅、体验良好；

轻量级的SDK；

轻量级的矢量地图：一般地图仅不到300KB。

支持导航；

跨平台格式，iOS\Android\HTML5

与识途室内定位SDK完美配合，为室内定位解决方案中不可获取一环；

#1 准备工作

ubimaplib_v1.3.jar

libubimap.so

若您使用eclipse ADT，项目下新建libs文件夹，将其按如下方式放置：

若为Android Studio，此略。

编辑AndroidMenifest.xml，添加权限：

添加Key：

android:name="ShituKey"

android:value="YourKey" />

#2 SDK调用 - 下载资源包

识途矢量地图SDK，在使用前，需预先下载一个资源包，该资源包包含所有地图所需渲染素材；该资源包只需下载一次。

调用：

mMapDownloader = new UbiMapDownloader();

mMapDownloader.tryDownloadRes(new UbiMapDownloadListener() {

// If no resource file should be downloaded.

@Override

public void onNoNeedDownload() {

// Usually do nothing here

}

// Downloading failed, may caused by network problem.

@Override

public void onFailed(final String arg0) {

Toast.makeText(MainActivity.this, "download failed because of " + arg0, Toast.LENGTH_LONG).show();

if (mDownloadDialog != null)

mDownloadDialog.dismiss();

}

// On downloading, and 'percent' indicates the process of

// downloading.

@Override

public void onDownloading(final float percent) {

mDownloadDialog.setMessage("downloading resource.." + (int) (percent * 100) + "%");

}

// On download succeeds.

@Override

public void onDownloadSuccess() {

mDownloadDialog.dismiss();

}

// On download starts.

@Override

public void onDownloadStart() {

if (mDownloadDialog != null)

mDownloadDialog.dismiss();

mDownloadDialog = new ProgressDialog(MainActivity.this);

mDownloadDialog.setMessage("downloading resource..");

mDownloadDialog.setCancelable(false);

mDownloadDialog.show();

}

});

#3 下载地图

获取您所拥有的地图，必须事先获取MapId.

根据MapId下载地图：

final long mapId = 1000361;

mMapDownloader.tryDownloadMap(mapId, new UbiMapDownloadListener() {

@Override

public void onNoNeedDownload() {

// Usually do nothing

Intent i = new Intent();

i.putExtra("mapId", mapId);

i.setClass(MainActivity.this, MapActivity.class);

MainActivity.this.startActivity(i);

}

@Override

public void onFailed(String arg0) {

// Must check the NULL situation of mDownloadDialog, because

// the

// onDownloadStart() is

// only invoked when there is a new version of map to be

// downloading.

if (mDownloadDialog != null)

mDownloadDialog.dismiss();

Toast.makeText(MainActivity.this, "download failed because of " + arg0, Toast.LENGTH_LONG).show();

}

@Override

public void onDownloading(float percent) {

mDownloadDialog.setMessage("downloading map.." + (int) (percent * 100) + "%");

}

@Override

public void onDownloadSuccess() {

mDownloadDialog.dismiss();

Intent i = new Intent();

i.putExtra("mapId", mapId);

i.setClass(MainActivity.this, MapActivity.class);

MainActivity.this.startActivity(i);

}

@Override

public void onDownloadStart() {

if (mDownloadDialog != null)

mDownloadDialog.dismiss();

mDownloadDialog = new ProgressDialog(MainActivity.this);

mDownloadDialog.setMessage("downloading map..");

mDownloadDialog.setCancelable(false);

mDownloadDialog.show();

}

});

#3 加载地图

UbiMapView mMap = (UbiMapView) findViewById(R.id.mapview);

mMap.load(mapId);

#4 定位点

UbiMap能通过传入一系列坐标，显示当前位置。但定位本身并不属于UbiMap SDK的功能范畴，您可下载识途定位SDK实现室内定位的功能，也可通过其他室内定位SDK来传入坐标。。

##4.1 坐标

// 坐标为该矢量地图的相对像素坐标

mMap.position(x, y);

##4.2 角度

// 刷新定位点角度

mMap.angle(mDegree);

##4.3 跟随模式

跟随模式，即为所有坐标的更新，都将引起地图的移动，定位点此时固定在屏幕中央。在跟随模式下，用户能对周围地图有更好的直观体验。

跟随模式在手指触摸view后自动被破坏。

//设置为跟随模式

mMap.switchFollowMode();

#5 地图POI

识途矢量地图上包含2类POI。

Mark，无区域的POI, 即该POI在地图上仅显示为一个单独的图标，常用来表示电梯、ATM、厕所、问讯处等。此类POI在实际环境中占据的区域较少，所以往往用一个单独的图标来表示；

Area, 区域POI, 即该POI在地图上显示为一个多边形，并且带有店铺图标和文字。常用来表示店铺、停车位等比较大的区域。

上述2类POI均继承自MapModel。 通过地图点击事件、搜索可获取响应的POI。此外，也可在不加载地图的情况下获取数据内的相关信息。见获取地图内POI信息

#6 点击事件

设置UbiMapListener来获取点击事件。

mMap.setOnMapListener(new UbiMapListener() {

@Override

public void onSwitchFloor(int area) {

//当切换楼层时调用

}

// When map loading completed, the floor information will be

// returned by this method. You can access floors via 'floorList'.

// Each element in 'floorList' is a instance of

// com.ubirouting.ubimaplib.model.map.Floor class.

@Override

public void onLoadData(List floorList) {

//当加载完地图后调用，返回所有楼层信息。每一个楼层信息为com.ubirouting.ubimaplib.model.map.Floor的实例，其中包含该矢量地图的像素比例尺、像素长宽、与正北夹角等信息。

}

@Override

public void onFailedLoadData() {

// 地图加载失败

}

@Override

public void onClickMap(float x, float y) {

// 当点击地图时回调

}

@Override

public void onClickArea(Area area) {

// 当点击区域时回调。区域为大块区域，常用来表示店铺、停车位等有一定面积的POI。

}

@Override

public void onClickMark(Mark mark) {

//当点击Mark时回调。Mark为地图上的无区域的小图标，常用来表示厕所、电梯、ATM等单点POI

}

});

#7 导航

// 调用后，将在地图中规划最短路径。用于定点导航

mMap.navigate(startMapModel, endMapModel);

// 根据坐标来导航，用于实时导航

mMap.navigate(x, y, endModel);

// 清除路径

mMap.clearPath();

#8 搜索

// 根据关键字搜索

List models = mMap.search(keyword);

#9 获取地图内POI信息

您可在不加载地图的情况下，获取识途矢量地图中的楼层及POI信息。

// 获取楼层信息

List floors = UbiMapDataHelper.allFloor(mMapId);

// 获取某层POI

List pois = UbiMapDataHelper.allPoi(mMapId, floorNum);

// 获取所有POI

List pois = UbiMapDataHelper.allPoi(mMapId);