CocoaPods trunk is moving to be read-only. Read more on the blog, there are 18 months to go.

IpsmapSDK 1.3.9

IpsmapSDK 1.3.9

×

License MIT
ReleasedLast Release Jan 2019

Maintained by zhangty.

IpsmapSDK 1.3.9

  • By
  • ipsmap

IpsmapSDK-iOS

IpsmapSDK-iOS 是一套基于 iOS 8.0 及以上版本的室内地图应用程序开发接口，供开发者在自己的iOS应用中加入室内地图相关的功能，包括：地图显示（多楼层、多栋楼）、室内导航、模拟导航、语音播报等功能。

获取AppKey

请填写 申请表 给[email protected]邮件联系获取appKey、mapId、scheme（分享用）

使用CocoaPods部署

在Podfile中使用命令如下：

pod 'IpsmapSDK', '~> 1.3.9'

然后运行以下命令

$ pod install

手动集成

  1. 将SDK文件中包含的IpsmapSDK.framework、IpsmapSDK.xcassets两个文件添加到工程中。
  2. 开发者需要在工程中链接上：CoreTelephony.framework、SystemConfiguration.framework、CFNetwork.framework、libz.tbd、libc++.tbd、libsqlite3.tbd。
  3. 同时需要在Embedded Binaries 中链接上IpsmapSDK.framework(动态链接库）如下图所示

IpsmapSDK

  1. 接入微信分享SDK可 点击 查看

注意

导入IpsmapSDK后需要

  • Build Settings中将Enable Bitcode 改成 NO。
  • 在Info.plist中添加授权申明
	<key>NSBluetoothPeripheralUsageDescription</key>
	<string>App需要您的同意,才能访问蓝牙</string>
	<key>NSContactsUsageDescription</key>
	<string>App需要您的同意,才能访问通讯录</string>
	<key>NSLocationWhenInUseUsageDescription</key>
	<string>App需要您的同意,才能在使用期间访问位置 </string>
	<key>NSMicrophoneUsageDescription</key>
	<string>App需要您的同意,才能访问麦克风</string>

使用说明  

SDK初始化

在 didFinishLaunchingWithOptions里面添加以下代码即可，appKey为邮件中获取的

    //初始化Ipsmap
    [IpsmapServices setAppKey:appKey];
    [[IpsmapServices sharedInstance] application:application didFinishLaunchingWithOptions:launchOptions];

显示室内地图

    IpsMapViewController *vc = [[IpsMapViewController alloc] initWithMapId:@"lGaWCUtqoj"];
    [self.navigationController pushViewController:vc animated:YES];
    //self.navigationController为空的话，用presentViewController也可以显示。
    //UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:vc];
    //[self presentViewController:nav animated:YES completion:nil];

导航至具体地址

    IpsMapViewController *vc = [[IpsMapViewController alloc] initWithMapId:@"lGaWCUtqoj" targetName:@"成人中医(珠)" targetId:@"200191"];
    [self.navigationController pushViewController:vc animated:YES];

是否在地图范围内的接口

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view.
    self.view.backgroundColor = [UIColor whiteColor];
    
    self.manger = [IpsmapLocationManger new];
    self.manger.locationTimeOut = 20;
    self.manger.delegate = self;
    
    [self.manger startLocationEngine:@"lGaWCUtqoj"];
}

- (void)ipsmapLocationManager:(IpsmapLocationManger *_Nullable)manager didUpdateLocation:(IpsLocation *_Nullable)location 
{
    if (location.inThisMap) {
        NSLog(@"在医院里面");
    }
}

位置共享功能

使用粘贴板实现（SDK1.1.6未启用该实现方案）

1、在 didFinishLaunchingWithOptions里面创建好window之后添加

    //检测位置共享口令是否存在
    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(ipsReceiveShareInfo:) name:IpsReceiveShareInfoNotification object:nil];
    [[IpsmapServices sharedInstance] application:application didFinishLaunchingWithOptions:launchOptions];

2、在applicationWillEnterForeground里添加

 [[IpsmapServices sharedInstance] applicationWillEnterForeground:application];

3、通知响应处理

- (void)ipsReceiveShareInfo:(NSNotification *)noti {
    if (noti.object == nil || ![noti.object isKindOfClass:[UIView class]]) {
        return;
    }
    
    UIView *viewJoin = (UIView *)noti.object;
    //有分享口令
    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
        [viewJoin performSelector:@selector(showInView:) withObject:[UIApplication sharedApplication].keyWindow];
    });
}

使用微信分享SDK实现（SDK1.1.6开始使用）

1、开发者可在自己的工程中接入微信SDK并完成register

   //例如在didFinishLaunchingWithOptions实现register
   [WXApi registerApp:wxAppID];

2、将获取到的scheme配置到自己的工程中

IpsmapSDK

3、在每个IpsMapViewController创建完之后加上locationShareDelegate处理分享按钮点击的回调

    //设置需要分享的平台
    [IpsShareConfig showSharePlatforms:@[@(IpsShareTypeWeChat), @(IpsShareTypeQQ), @(IpsShareTypeSMS)]];

    IpsMapViewController *vc = [[IpsMapViewController alloc] initWithMapId:@"lGaWCUtqoj"];
    vc.locationShareDelegate = [IpsLocationShareHandle sharedInstance];
    [self.navigationController pushViewController:vc animated:YES];

4、分享按钮点击的回调处理可以用demo中的IpsLocationShareHandle也可以自己写

5、点击分享链接App的处理在Appdelegate中的handleOpenURL方法加处理事件,delegate 需要支持IpsLocationShareProtocol协议

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    if ([url.scheme isEqualToString:wxAppID]) {
        return [WXApi handleOpenURL:url delegate:self];
    } else if ([url.scheme isEqualToString:IpsScheme])
        return [[IpsmapServices sharedInstance] application:application openURL:url delegate:[IpsLocationShareHandle sharedInstance]];
    return YES;
}

6、为了方便位置共享可以默认填写用户昵称，可在登录成功或者切换用户等获取到用户信息后传递用户信息

    IpsUserInfo *userInfo = [IpsUserInfo new];
    userInfo.name = @"张三";
    userInfo.phoneNumber = @"13888888888";
    [IpsmapServices sharedInstance].userInfo = userInfo;