ArcGIS Indoors

Apple Indoor Positioning for ArcGIS Indoors

Indoor positioning adds location awareness to your indoor GIS. It enables real-time indoor navigation for visitors and building occupants to improve efficiency and reduce frustration of finding places and points of interest. It also supports facilities and IT workers in reducing services times, helping them navigate to work order locations and assets in complex campuses. Indoor positioning unlocks other capabilities like location sharing and providing insights related to occupancy patterns and trends in your indoor environment.

An Indoor Positioning System (IPS) is needed to get the familiar “blue dot” on an indoor map. The blue dot in common outdoor navigation apps is powered by Global Positioning System (GPS) which requires an unobstructed view of the sky hence it does not work inside buildings.

An increasing number of options for enabling IPS are available and your choice depends on various factors including existing hardware infrastructure like Bluetooth beacons and WiFi access points, accuracy requirements, and mobile device types amongst others.

ArcGIS Indoors mobile apps provide support for ArcGIS IPS, which uses Bluetooth beacons for positioning and works on both iOS and Android devices. ArcGIS IPS can also support WiFi-based positioning on Android devices, if the device is configured to allow WiFi sensor probing. WiFi positioning uses wireless access point (WAP) signal strengths to trilaterate the user’s location.

WiFi-based positioning on iOS is provided by Apple’s IPS and is supported by the ArcGIS Indoors mobile app for iOS.

Configure Apple IPS for ArcGIS Indoors

In this blog, we will discuss how to set up Apple IPS. Apple requires floor plan data in Indoor Mapping Data Format (IMDF) which can be created using floor plan data from ArcGIS Indoors. Safe Software provides an FME (Feature Manipulation Engine) workbench that converts an Indoors model geodatabase to IMDF using the ArcGIS Data Interoperability Extension. The following steps are required to convert data to IMDF and configure Apple Indoor Positioning:

After completing the above, you can make the IPS available for use in mobile apps such as Indoors Mobile.

Prerequisites

In order to complete the steps detailed in the blog, you should be familiar with the following:

Prepare indoor data for IMDF

Apple has certain data requirements for floor plans and will validate the IMDF file to ensure that requirements are met. Completing the following data configuration in ArcGIS Pro before running the Data Interoperability workbench can help ensure a more seamless validation process once you upload the IMDF file to Apple.

Run the Indoors to IMDF workbench

Once you have validated and cleaned up your floor plan data, you can convert the Indoors model to an IMDF file to use for Apple indoor positioning. To convert the Indoors model to IMDF, use the ArcGIS Data Interoperability extension to run the ArcGIS Indoors Model to IMDF workbenches, available for download on FME Hub. 

FME workbench converts an Indoors dataset to IMDF
The FME Workbench converts an Indoors dataset to IMDF

After downloading the workbenches from FME Hub, complete the following steps to convert your floor plan data to IMDF:

  1. Run the Make Indoors To IMDF Mapping Table workbench using the Data Interoperability extension. The workbench will create a Category_Address_Map XLSX spreadhseet.
  2. After running the Make Indoors To IMDF Mapping Table workbench, update the Category_Address_Map spreadsheet based on your data. At a minimum, update the following:
    • On the Sites sheet, update the location information (Address, Locality, State, County, Postal Code) from the default values to the correct values for your venue.
    • On the Units_Use sheet, update the IMDF_Category use types. At a minimum, define the use types that correspond to Walkways, Stairs, and Elevators to avoid errors when submitting the IMDF to Apple. Additional categorization can aid in visualization when reviewing the IMDF in the IMDF Sandbox and conducting a survey of your buildings.
  3. Run the Indoors To IMDF workbench using the Data Interoperability extension. This tool uses the spreadsheet from the first workbench as input.

At the end of this process, you will have a zip file that includes a GeoJSON for each of the following: Footprint, Venue, Openings, Units. This is the IMDF file that you will use to configure Apple Indoor Positioning. 

Inspect the output in the Apple IMDF Sandbox

Once you have created the IMDF, you can upload it to the Apple IMDF Sandbox for initial validation. You can fix some types of errors, like units that extend beyond levels, in the IMDF Sandbox, while for other types of errors, such as self-intersection, you must make modifications in the indoor data and re-run the workbenches. 

In addition to validation errors, the IMDF Sandbox provides a list of warnings. These are not necessarily data problems but should be inspected to ensure that the floor plan data is accurate. For example, a donut-shaped level in a building due to a central courtyard.

IMDF Sandbox provides a list of errors and warnings for your indoor data
Validate floor plan data in the Apple IMDF Sandbox

Once you have an IMDF that is error free and have confirmed that the warnings are acceptable data conditions, you can download your updated IMDF file. 

Submit IMDF to Apple for verification and approval

Once you have registered with Apple Indoor Maps, you must create a venue associated to the address of your building and submit it for approval. After Apple approves the venue, you can upload the IMDF for further validation. 

Apple validates the IMDF and provide a list of all the data conditions flagged as errors or warnings. If there are any errors you must fix them in your data before proceeding to the next step. 

After Apple has validated and accepted the IMDF it goes through a georeferencing process. This involves a second set of validations for data positioning and accuracy. At the end of georeferencing, Apple provides a detailed list of any data conditions flagged as errors or warnings. 

Apple validates and georeferences floor plan data

Once Apple has georeferenced the IMDF file, you can survey your building and configure indoor positioning. 

Perform indoor surveys

Just like GPS requires an unobstructed view of the sky to locate satellites, IPS must know the fixed location WiFi access points inside your buildings. Conducting an indoor survey using the Indoor Survey app from Apple collects this information.

Get the Apple Indoor Survey app from the App Store and sign in to see your Venues.

At its simplest, an indoor survey requires walking through hallways in your building and tapping on the indoor map to record your location at regular intervals in the Indoor Survey app. There are several strategies to follow if you require indoor positioning inside large rooms or open areas. Apple provides examples of sample surveys and answers to common questions.

You should upload the survey once it is complete and test the indoor positioning. While testing, the app displays a red dot to indicate areas in which indoor positioning is not available. Surveyed areas that are processed appear with a green shade and the blue dot should be visible and follow you as you walk around.

Upload your surveys and test indoor positioning.

Best practices when conducting a survey

Before conducting an Apple IPS survey, it is benefitial to understand the distribution of WiFi access points in the building, in order to efficiently plan survey paths. WiFi access points are mounted in way where they are not easily visible. In some cases, there may be only a few of them in a large area. You can work with your IT department to get additional access points installed if necessary.

Use Apple IPS in Indoors

Once you are satisfied with the indoor positioning results from your survey, you can make the indoor positioning live so it is available for use in ArcGIS Indoors mobile app for iOS. Location awareness unlocks many capabilities in the Indoors mobile app, including automatically detecting the floor you are on, searching for nearby amenities like first aid kits, travel time, and estimated time of arrival when navigating indoors amongst others. You can also choose to share your location with a selected group of colleagues so they can easily find you.

Apple IPS in Indoors mobile app
Apple IPS in ArcGIS Indoors iOS mobile app

As your floor plan layouts change, you may need to periodically re-export the Indoors model to IMDF, upload to Apple, and conduct a new survey. Additionally, as your wireless network changes (for example, wireless access points move or are added) you may need to re-survey your buildings to keep the indoor positioning accurate in your organizational apps.

About the authors

Sophie Frank

Sophie Frank is a Product Engineer on the ArcGIS Indoors product team and the Product Owner for ArcGIS Indoors Pro.

Gaurav Jobanputra

Gaurav Jobanputra is the lead Product Engineer for ArcGIS Indoors and Product Owner of Indoors web and mobile apps. He also works on integration of indoor positioning systems (IPS), workspace reservation systems, workorder management systems and other Esri mobile apps like FieldMaps and Survey123 with Indoors apps.

Connect:
0 Comments
Inline Feedbacks
View all comments

Next Article

When are expert sources right for your story?

Read this article