keith 最新主题

ibeacon定位推进物联网化建设，打造智慧校园

ibeacon室内定位技术是智能家居的黄金搭档

ibeacon拉近你和室内定位之间的距离

推荐阅读

社区论坛 > 开发者服务
智石科技室内定位SDK集成步骤指南
1 2693 2016-10-18
keith 我是BrightBeacon
本帖最后由 keith 于 2016-10-18编辑

一、简介

室内定位开发包是基于ArcGIS框架（关于ArcGIS）和GEOS几何计算开源库，为开发者提供了的室内地图显示、路径规划、室内定位等相关GIS功能。

开发包最低兼容IOS7及其以上系统。

二、集成开发包

请①安装AGSRuntimeSDKiOSv10.2.5.pkg开发包和②编译libgeos.a库。 

集成前准备:

如果CocoaPods能直接集成可以跳过①和②。

手动下载库文件①：

  • 安装AGSRuntimeSDKiOSv10.2.5.pkg文件

  • 设置引用路径Target->Building Setting->Framework Search Paths: $HOME/Library/SDKs/ArcGIS/iOS 或 前往~/Library/SDKs/ArcGIS/iOS拖入ArcGIS.framework到项目。

手动编译库文件②：

  • 打开终端，

cd 本项目文件夹/geos-3.5.0

前往下载的geos-3.5.0目录下，执行

. geos.sh

(可以按需要配置支持的架构，默认支持目前所有架构，编译大约耗时3～5分钟；若手动下载了geos源码

  • 编译完成后，最终合成的libgeos.a文件在目录/geos-3.5.0/geos/platform/mixd

  • 请先使用lipo -info libgeos.a确认是否包含项目运行所需的构架(ios真机:armv7 armv7s arm64;模拟器:i386 x86_64)；

引入资源文件③(可自定义图标)

  • 添加resource相关图标文件，到你的工程imageSets

直接参考下载开发示例工程

注：工程使用了CocoaPods集成，但未包含①和②文件，请按以上要求引入文件。

1、使用CocoaPods集成

如果你已经使用了 Cocoapods，集成方法非常简单： 
注：导入C库需要编译，因此需要安装GNU编译环境。GNU资料: 
注：请先确认已安装brew，需要获取管理员权限

sudo chown $(whoami):admin /usr/local && sudo chown -R $(whoami):admin /usr/local
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)")
brew install automake autoconf libtool

  • 添加依赖到Podfile

pod 'BrightIndoorSDK'
#以下库文件较大并需要编译，如无法使用pod集成。请手动引入①和②文件。
#pod 'ArcGIS-Runtime-SDK-iOS'
#pod 'geos'

  • 在Profile文件夹，终端运行

pod install

  • 请检查Building Setting的Other Linker Flags、Framework Search Paths、Header Search Paths是否包含：$(inherited)

  • 打开项目工程集（*.xcworkspace file），根据需求添加地图框架TYMapSDK/TYMapSDK.h和定位引擎TYLocationEngine/TYLocationEngine.h到对应的类文件中。

2、手动集成

  • 将整个libs文件夹引入并选择拷贝到项目目录。请单独将libs/MapResource引入并选择Create folder references

  • *添加Building Setting的Other Linker Flags：-ObjC -framework ArcGIS -lc++ -l"geos" -l"sqlite3" -framework "TYLocationEngine" -framework "TYMapData" -framework "TYMapSDK"

  • 最后根据需求添加TYMapSDK/TYMapSDK.h和TYLocationEngine/TYLocationEngine.h到对应的类文件中。

三、常用功能API介绍

1、添加地图

请添加你的地图资源文件到工程中，或使用示例工程资源。 目前绘制自定义地图需要联系客服洽谈，电话：400-023-3883

设置地图资源路径

使用地图前，请先初始化地图资源路径。请确保rootDir能获得路径。（也可以将地图数据文件夹放置到自定义的目录，请保持MapResource内文件结构即可，如0010/00100018/*.db，默认路径为MapResource）

    #import <TYMapSDK/TYMapSDK.h>   
    NSString *rootDir = [[NSBundle mainBundle] pathForResource:@"MapResource" ofType:nil];
    [TYMapEnvironment setRootDirectoryForMapFiles:rootDir];
    [TYMapEnvironment initMapEnvironment];

构造地图数据结构并显示地图

在xib或storyBoard界面上添加一个UIView，并修改类为TYMapview，关联到IBOutlet mapView

@property (weak, nonatomic) IBOutlet TYMapView *mapView;

设置数据城市、建筑ID，并传人授权OpenId和License以验证地图使用权限

TYCity *city = [TYCityManager parseCity:@"0021"];
    TYBuilding *build = [TYBuildingManager parseBuilding:@"00210018" InCity:city];
    self.allMapInfos = [TYMapInfo parseAllMapInfo:build];
    TYMapInfo *mapInfo = self.allMapInfos.firstObject;
    [self.mapView initMapViewWithBuilding:build UserID:@"ty4e13f85911a44a75" License:@"26db2af1g0772n53`dd9`666101ec55a"];
    self.mapView.mapDelegate = self;
    [self.mapView setFloorWithInfo:mapInfo];

2、常用地图功能

MapView是地图最基本的容器，它提供了一系列接口叠加不同的空间数据、漫游地图、显示信息等。 地图继承于AGSMapView，你也可以自行参考ArcGIS相关文档

使用图层AGSLayer

MapView支持很多类型的图层，用于叠加在地图上展示动态、静态的Service数据。 其中AGSGraphicsLayer比较特殊，它是完全由客户端创建、更新和销毁，用来处理用户输入，展示位置标识、导航路径的利器。 AGSGraphicsLayer（图形图层）相当于一张画纸，AGSGraphics（空间要素）相当于画面上的房子、花园、马路什么的并可以用不同颜色。

    //新建一个图形图层
    AGSGraphicsLayer *poiLayer = [AGSGraphicsLayer graphicsLayer];
    [self.mapView addMapLayer:poiLayer];

AGSGraphics（空间要素）必须要有几何形状（AGSGeometry），表现符号（AGSSymbol）默认是简单样式，而属性（Attributes）是可选的。

    //创建点状符号（符号有多种：点状、图片型、线状、面状、文字型、复合型）
    AGSSimpleMarkerSymbol *markerSymbol = [AGSSimpleMarkerSymbol simpleMarkerSymbolWithColor:[UIColor greenColor]];
    markerSymbol.size = CGSizeMake(5, 5);
    //创建点形状（形状有多种：点、多点、线、面、包络矩形）
    //我们测试先使用可见区域的中点（mapView加载完毕自后才能获取成功）
    //AGSPoint *poiCoord = [AGSPoint pointWithX:x y:y spatialReference:self.mapView.spatialReference];
    AGSPoint *poiCoord = self.mapView.visibleAreaEnvelope.center;
    //组装点要素
    AGSGraphic *myGraphic = [AGSGraphic graphicWithGeometry:poiCoord symbol:poiSymbol attributes:nil];
    //添加要素到图形图层
    [poiLayer addGraphic:myGraphic];

显示弹窗AGSCallout

使用自带默认弹窗，你也可以通过callout.customView自定义弹窗样式

[self.mapView.callout showCalloutAt:(AGSPoint*) screenOffset:CGPointMake(0, 0) animated:YES];
//配置默认弹窗样式
- (BOOL)TYMapView:(TYMapView *)mapView willShowForGraphic:(TYGraphic *)graphic layer:(TYGraphicsLayer *)layer mapPoint:(TYPoint *)mappoint {
    mapView.callout.image = [UIImage imageNamed:@"start"];
    mapView.callout.title = @"标题";
    mapView.callout.detail = @"副标题";
    mapView.callout.titleColor = [UIColor blackColor];
    mapView.callout.detailColor = [UIColor blackColor];
    mapView.callout.delegate = self;
    return NO;
}
//处理弹窗按钮点击回调
- (void)didClickAccessoryButtonForCallout:(AGSCallout *)callout {
}

3、路径规划

路径规划使用了开源库GEOS，SDK中已经集成在TYOfflineRouteManager路径管理器类里边

    //路径规划需要自定义：路径起点、路径终点、路径楼梯出入口的表现符号（AGSSymbol）
    AGSPictureMarkerSymbol *startSymbol = [AGSPictureMarkerSymbol pictureMarkerSymbolWithImageNamed:@"start"];
    startSymbol.offset = CGPointMake(0, 22);
    //
    AGSPictureMarkerSymbol *endSymbol = [AGSPictureMarkerSymbol pictureMarkerSymbolWithImageNamed:@"end"];
    endSymbol.offset = CGPointMake(0, 22);
    //
    AGSPictureMarkerSymbol *switchSymbol = [AGSPictureMarkerSymbol pictureMarkerSymbolWithImageNamed:@"nav_exit"];
    //
    markerSymbol = [AGSSimpleMarkerSymbol simpleMarkerSymbolWithColor:[UIColor greenColor]];
    markerSymbol.size = CGSizeMake(5, 5);
    //
    [self.mapView setRouteStartSymbol:startSymbol];
    [self.mapView setRouteEndSymbol:endSymbol];
    [self.mapView setRouteSwitchSymbol:switchSymbol];
    //初始化路径管理器
    TYOfflineRouteManager *cppOfflineRouteManager = [TYOfflineRouteManager routeManagerWithBuilding:self.currentBuilding MapInfos:self.allMapInfos];
    cppOfflineRouteManager.delegate = self;
    //开始规划路径
    [cppOfflineRouteManager requestRouteWithStart:self.startLocalPoint End:self.endLocalPoint];
//路径规划结果
- (void)offlineRouteManager:(TYOfflineRouteManager *)routeManager didFailSolveRouteWithError:(NSError *)error
{
    NSLog(@"%@", NSStringFromSelector(_cmd));
}
- (void)offlineRouteManager:(TYOfflineRouteManager *)routeManager didSolveRouteWithResult:(TYRouteResult *)rs
{
    [self.mapView setRouteResult:rs];
    [self.mapView setRouteStart:self.startLocalPoint];
    [self.mapView setRouteEnd:self.endLocalPoint];
    [self.mapView showRouteResultOnCurrentFloor];
}

4、iBeacon室内定位

使用与地图数据配套的iBeacon设备部署方案，可以使用TYLocationEngine实现室内地图定位。示例地图资源，需要准备5个iBeacon设备；配置参数列表如下：

No.UUIDMajorMinor
区域1FDA50693-A4E2-4FB1-AFCF-C6EB076478251004611048
区域2FDA50693-A4E2-4FB1-AFCF-C6EB076478251004611049
区域3FDA50693-A4E2-4FB1-AFCF-C6EB076478251004611050
区域4FDA50693-A4E2-4FB1-AFCF-C6EB076478251004611053
区域5FDA50693-A4E2-4FB1-AFCF-C6EB076478251004611055
    //设置定位符号
    AGSPictureMarkerSymbol *locSymbol = [AGSPictureMarkerSymbol pictureMarkerSymbolWithImage:[UIImage imageNamed:@"locationArrow"]];
    [self.mapView setLocationSymbol:locSymbol];
    //初始化，传人配置的iBeacon使用的UUID，并开启定位
    TYLocationManager *loc = [[TYLocationManager alloc] initWithBuilding:build];
    [loc setBeaconRegion:[[CLBeaconRegion alloc] initWithProximityUUID:[[NSUUID alloc] initWithUUIDString:@"FDA50693-A4E2-4FB1-AFCF-C6EB07647825"] identifier:@"testforloc"]];
    [loc startUpdateLocation];
    loc.delegate = self;
//显示定位
- (void)TYLocationManagerdidFailUpdateLocation:(TYLocationManager *)manager {
}
- (void)TYLocationManager:(TYLocationManager *)manager didUpdateLocation:(TYLocalPoint *)newLocation{
    [self.mapView showLocation:newLocation];
    self.startLocalPoint = newLocation;
}
//处理方位变化，旋转模式设置[self.mapView setMapMode:TYMapViewModeFollowing]
- (void)TYLocationManager:(TYLocationManager *)manager didUpdateDeviceHeading:(double)newHeading {
    [self.mapView processDeviceRotation:newHeading];
}
4 分
回复 反对 支持

0条回复

返回列表
1