SitumWayfinding

描述

Situm Wayfinding Module 是用 Swift 编写的 iOS 设备室内定位的应用程序模块。它基于 Situm SDK 构建，允许用户在建筑物内定位，查看楼层，查看建筑物的 POI（兴趣点），创建通向建筑物任何地方的路线，接收到达指定地点的指令等。如果您对使用 Situm SDK 构建应用程序感兴趣，请参阅 Situm iOS SDK 示例应用程序。

提交贡献

在提交之前，您需要签署一份贡献者许可协议（CLA）。在此处了解更多信息。

免责声明

此代码处于 alpha 版本。目前不推荐修改 SitumWayfinding 代码。要使用 SitumWayfinding，请使用提供的公开方法。

需求

1. MacOS。
2. Xcode。更多关于此 IDE 的信息[这里] (https://developer.apple.com/xcode/)。
3. Cocoapods。有关安装过程的说明[这里] (https://guides.cocoapods.org.cn/using/getting-started.html)。

示例

要运行示例项目，首先从仓库中克隆，然后在 Example 目录中运行 pod install。

之后，您需要提供自己的 apikeys。您可以从 WayfindingController 中完成此操作，用您的 Situm Dashboard、Google Maps 凭据和适当的建筑 ID 替换指示性文本。

安装

SitumWayfinding через CocoaPods 提供使用。要安装它，只需将以下行添加到您的 Podfile 中

pod 'SitumWayfinding'

要提供用户位置，SitumWayfinding 需要一些系统权限。

前往应用程序设置中的信息标签页。我们需要为系统权限添加描述符，并附上您喜欢的标签。这些键的描述值可以是您想要的任何内容，例如，只需键入“位置和蓝牙是确定你所在位置所必需的”。使用我们SDK所需的键如下所示

• NSLocationAlwaysUsageDescription（在XCode中，“隐私 - 始终使用位置描述”）。
• NSLocationWhenInUseUsageDescription（在XCode中，“隐私 - 在使用时使用位置描述”）。
• NSBluetoothPeripheralUsageDescription（在XCode中，“隐私 - 蓝牙外围设备使用描述”）。
• 仅当您针对iOS 13.0或更高版本时： NSBluetoothAlwaysUsageDescription（在XCode中，“隐私 - 始终使用蓝牙描述”）

验证和加载导航模块

为了使用SitumSDK和GoogleMaps的能力，您需要验证自己。这可以通过在Credentials对象中存储证书来完成，该对象稍后将转发给SitumMapsLibrary初始化器。您还应该向SitumMapsLibrary提供包含导航UI的UIView，UIViewController以及一些模块行为的调整设置。最后，只需调用load()方法。以下示例展示了这个过程

let credentials = Credentials(user: "YOUR SITUM USER", password:  "YOUR SITUM PASSWORD", googleMapsApiKey: "YOUR GOOGLE MAPS API KEY")
let buildingId = "YOUR_BUILDING_ID"
let settings = LibrarySettings.Builder()
    .setCredentials(credentials: credentials)
    .setBuildingId(buildingId: buildingId)
    .build()

let library = SitumMapsLibrary(containedBy: containerView, controlledBy: containerViewController, withSettings: settings)
do{
    try library.load()
}catch{
    // PROPERLY MANAGE ERROR
}

许可证

Situm导航模块适用于MIT许可证。有关更多信息，请参阅LICENSE文件。