LivingMap

Technology solutions for complex spaces. Digital mapping, wayfinding and positioning for people, assets and places.

Visit livingmap.com to learn more.

LivingMapSDK is a Swift binaries that provides mapping, routing, positioning and tracking in a multitude of indoor and outdoor environments.

• Features
• System
• Versions
• Installation
• Requirements
• Permissions

Features

Live Positioning

- No hardware dependency
• 1-5 metre location accuracy
• Real-time asset tracking
• Utilises existing infrastructure

Live Map

• Dynamic category overlays
• Customisable asset list
• Category and type search
• API integrations - track and visualise data from IoT devices and external databases
• Asset management

Live Routing

• Customise routing with business rules
• GDPR compliant
• Alerts via push notification based on time, location or both
• Accessible routing tailored to users’ needs
• Routing between and within indoor and outdoor spaces

Live Location

• Real-time information and intelligence
• Access to historic data and trends
• Advanced data visualisation charts and dashboards
• Real-time notifications based on customer parameters
• GDPR compliant

System

Installation

- iOS

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions.

In order to use the framework artefacts linked by this repo a slight modification to your podfile is necessary.

You must explicitly state that this repo is a source for the Cocopods integration system. Add this line of code under the platform declaration but above the project declaration in the podfile.

source '[email protected]:livingmap/LivingMap.git'

or

source 'https://github.com/livingmap/LivingMap.git'

Point to the latest version:-

    pod 'LivingMapSDK'
    pod 'AirlineAccelerator'

Point to the specific version (recommended):-

    pod 'LivingMapSDK', '11.3.3'
    pod 'AirlineAccelerator', '11.3.3'

To install or update your new dependencies, from terminal run:

    pod [install|update]

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate LivingMapSDKs into your Xcode project using Carthage, specify it in your Cartfile:

Point to the latest version:-

binary "https://raw.githubusercontent.com/livingmap/LivingMap/main/LivingMapSDK.json"
binary "https://raw.githubusercontent.com/livingmap/LivingMap/main/AviationAccelerator.json"

Point to the specific version (recommended):-

binary "https://raw.githubusercontent.com/livingmap/LivingMap/main/LivingMapSDK.json" == 11.3.3
binary "https://raw.githubusercontent.com/livingmap/LivingMap/main/AviationAccelerator.json" == 11.3.3

To download the dependencies use the following command in the project directory:

carthage update --use-xcframeworks --platform ios

To clear carthage cache before updating:

rm -rf ~/Library/Caches/org.carthage.CarthageKit

Attach the downloaded frameworks/xcFrameworks which are located in the <project>/Carthage/Build directory to the project through one of the following approaches:

• In the project tabs General --> Frameworks, Libraries, and Embedded Content
• In the project tabs Build Phases --> Embed Frameworks

Ensure the frameworks/xcFrameworks are embedded and signed.

Swift Package Manager

he Swift Package Manager is a tool for automating the distribution of Swift code. It is integrated into Xcode and thus dependencies can be managed via Xcode directly.

Adding LivingMapSDKs and its dependencies can be done through Xcode in the following way:

• In Xcode, navigate to File -> Add Packages
• Search using https://github.com/livingmap/LivingMap to find the LivingMap Package
• Select the LivingMap package, set the version to v11.3.3 and click Add Project

- Android

Maven Based Dependencies

Add a reference to the Living Map Maven repository

maven {
            url "https://maven.livingmap.com/artifactory/gradle-release"
        }

Include the Airline Accelerator library as a dependency:

dependencies {
    implementation 'livingmap.com:LivingMapAirlineAccelerator:10.2.1'
}

Local AAR Library Modules

Warning: Using AARs locally does not provide dynamic dependency tracking or updates. We do NOT recommend this approach.

This integration and download MUST be repeated with each new SDK release however Maven handles this automatically.

Download AAR and optional POM Files

Both AAR and the optional POM files (for dependency management in 3rd party build tools) can be found at the following urls. Navigate into the newest version and download the resources as required.

https://maven.livingmap.com/artifactory/gradle-release/livingmap/com/LivingMapAirlineAccelerator/<latest version (10.2.1)> https://maven.livingmap.com/artifactory/gradle-release/livingmap/com/LivingMapSDK/<latest version (10.2.0)>

- Android

Maven Based Dependencies

Add a reference to the Living Map Maven repository

maven {
            url "https://maven.livingmap.com/artifactory/gradle-release"
        }

Include the Airline Accelerator library as a dependency:

dependencies {
    implementation 'livingmap.com:LivingMapAirlineAccelerator:10.2.1'
}

Local AAR Library Modules

Warning: Using AARs locally does not provide dynamic dependency tracking or updates. We do NOT recommend this approach.

This integration and download MUST be repeated with each new SDK release however Maven handles this automatically.

Download AAR and optional POM Files

Both AAR and the optional POM files (for dependency management in 3rd party build tools) can be found at the following urls. Navigate into the newest version and download the resources as required.

https://maven.livingmap.com/artifactory/gradle-release/livingmap/com/LivingMapAirlineAccelerator/<latest version (10.2.1)> https://maven.livingmap.com/artifactory/gradle-release/livingmap/com/LivingMapLiveSDK/<latest version (10.1.2)> https://maven.livingmap.com/artifactory/gradle-release/livingmap/com/LivingMapSDK/<latest version (10.2.0)>

Permissions

- iOS

Ensure your app implements Location Updates capability and prompts the user for Location Permissions.

Attention: Screen Orientation and Mapping – Only portrait-mode is supported by LivingMapSDK when Mapping is used. Applications which integrate the SDK and use Mapping must ensure it is locked to Portrait-mode through its configuration.

Architectures Flags

Ensure your app avoided duplicated architecture through updateing the excluded archeitecture to include arm64 for Any ios simulator SDK.

- Android

In order to support Android APi 28 and above the SDKs have been compiled with the AndroidX support library flags. Enable the following in your gradle.properties file

android.useAndroidX=true
android.enableJetifier=true

- Instantiation and Use

Please refer to this document for iOS