Introduction

Effective data visualization is crucial for informed decision-making. AirHub® Portal’s ArcGIS Online web map integration empowers organizations to tailor their AirHub Portal map to satisfy their organization’s unique data needs. Integrating your organization's unique data alongside AirHub® Portal’s regulatory and risk-focused data gives you a comprehensive and unified view of your airspace, ground risks, and operational activities, enabling informed decisions, optimized operations, and enhanced safety and compliance.

Our web map integration empowers you to retain complete control over your data. Creating a custom web map within your ArcGIS Online organization and adding your organization’s public or private data, ensures that your information remains secure. Once you've created your web map, simply share its link with Airspace Link. We'll register it with your AirHub® Portal organization, making your data instantly accessible to your users without compromising your data's integrity.

NOTE: Integrating your custom web map into AirHub Portal does not replace the existing AirHub Portal map. Instead, it adds new layers of data to your map, enhancing your overall situational awareness.

Prerequisites

• An ArcGIS Online organizational account

• Basic understanding of ArcGIS Online and web maps

Step-by-Step Guide

Create a Web Map in ArcGIS Online (Optional)

Note: If you don't already have a web map that contains your organization's data, follow these steps to create one in ArcGIS Online:

1. Log in: Sign in to your ArcGIS Online organizational account with a user type

2. Create a New Map: Navigate to the Map tab

3. Add Your Data:

   1. Feature Layers:

NOTE: Public map sharing is preferred as it’s the easiest to configure within AirHub Portal. If you have sensitive data that cannot be shared publicly, Airspace Link can assist your organization with configuring advanced authentication, which reduces the frequency of ArcGIS Online login prompts your users will receive.

Integrate the Web Map into AirHub Portal

1. Obtain the Sharing URL: With your ArcGIS Online map open, copy the web map URL from the browser.

2. Configure AirHub Portal with the Custom Web Map: Send the Web Map URL to [email protected] along with the name of your AirHub Portal Organization. The configuration is typically completed within 24 hours.

Support for Secured Services (Optional)

If your web map is secure or it contains secured services, you may encounter a login prompt when accessing it in AirHub Portal. Consider creating an OAuth2.0 authentication application within your ArcGIS Online instance. Send the Client ID to [email protected] and we’ll configure a long-standing token for your AirHub Portal organization, minimizing the number of ArcGIS online login prompts for your users.

The Result

All data added to your web map will be overlaid on the AirHub Portal web map for all your organization’s Portal users. If you wish to update your map at any time, simply access the web map through ArcGIS online, make modifications, and save the map. When you refresh AirHub Portal next, your changes will be reflected.

This guide outlines the steps for integrating Esri Survey123 custom forms with AirHub® Portal to enhance data collection for various data entities, including Operations, Users, Aircraft, and Flight Logs. Integrating Survey123 with AirHub® Portal empowers users to customize data collection for their specific needs, streamlining workflows, enhancing data quality, and providing deeper operational insights.

Note: This guide focuses on integrating Survey123 for custom data gathering slots, which is distinct from the Survey123 Work Order Requests functionality.

Prerequisites:

• An ArcGIS Online account with Survey123 capabilities

Integration Steps

The integration process involves creating your Survey123 form and then coordinating with AirSpace Link support for its configuration within AirHub® Portal.

1. Decide Form Location: Determine where your Survey123 form will be embedded within AirHub® Portal in terms of workflow:

   • Supplemental Operation Creation Information (Plan Tab): Ideal for capturing pre-flight information (e.g., weather conditions, pilot certifications, equipment checks) when creating a new operation.

   • Supplemental Flight Log Information (Manage Tab): Suitable for capturing post-flight information related to flight logs (e.g., anomalies encountered, maintenance requirements).

AirSpace Link will then configure your Survey123 form within AirHub® Portal, typically completing this process within 24 hours.

Please note: While AirSpace Link support can assist with initial configuration, ongoing management of your Survey123 forms remains your responsibility.

Customization

Work Intake & Request

Custom Tags give managers with and AirHub Portal Organization the ability to standardize categories and identifiers, ensuring consistency when tracking operational attributes across the team. This guide covers the initial configuration of Tag Groups and individual Tags for use across the platform.

Prerequisites:

• Licensing: An Airhub Portal Team License or Higher is required.

Steps to Configure Tag Groups and Tags:

1. Navigate to Admin on the left-hand menu to access Tags Management.

2. Select an existing tag group to edit and add tags, or click "+ Create Tag Group" to create a new tag group and tags.

3. Define the Tag Group:

   • Title: Enter a descriptive name for the group (e.g., Project Name or Team Name).

Tagging Inspiration

When building your organization's custom tag groups, consider the data points that are most critical for filtering, reporting, and operational efficiency:

• Operation Purpose: Survey, Mapping, Delivery, Security-Patrol

• Project: ProjectABC, Project123

• Regulatory Environment: Part-107, Waiver-12345, Restricted-Airspace

• Categories/Classification: Training, Emergency Response, Inspection, R&D

Learn how to integrate AirHub Portal with Skydio Cloud to automatically sync flight data and display live telemetry from your Skydio fleet.

Step 1: Log in

Log into cloud.skydio.com

Step 2: Enable Data Capture

1. Select Settings

2. Enable "GPS & Telemetry"

Step 3: Create Webhook

1. Select Settings

2. Under the "Developer" section select "Webhooks"

3. In the top right corner, select "Create Webhook"

4. Name the Webhook "AirHub Portal"

Step 4: Create the Alerts

Live Flight Alert:

1. Select Settings

2. Under the "Settings" section select "Alerts"

3. In the top right corner select "Add Alert"

4. Enter the following:

Post-Flight Sync Alert:

1. Select Settings

2. Under the "Settings" section select "Alerts"

3. In the top right corner select "Add Alert"

4. Enter the following:

Step 5: Generate Integration API Key

1. Select the "Integrations" tab in the main navigation

2. Select "+ Add Custom Integration"

3. Under "Token Name" enter "AirHub Portal"

4. Select the desired group(s) this integration is intended for. If you would like all aircraft to be included, select "(Entire Organization)"

1. URL Customization: Understanding the Components & Syntax

The Live Flight Viewer's functionality and display are controlled by specific URL parameters. These dictate what data is shown and how the map initially appears.

Base URL Structure:

https://flysafe.airspacelink.com/?mode=live-flight&apiKey={YOUR_API_KEY}&orgId={YOUR_ORG_ID}&loc={LATITUDE},{LONGITUDE},{ZOOM_LEVEL}z&programId={YOUR_PROGRAM_ID}

Compatibility

• Supported AirHub Portal Organizations: Your Organization must have a ‘Team’ or “Advanced’ license.

• Supported Controllers: DJI RC Pro controllers running DJI Pilot 2 app.

• Supported DJI Ground Control Station (GCS) Apps: DJI GO/GO 4 and DJI Pilot/Pilot 2.

• Unsupported: iOS devices and the DJI Fly GCS application.

Step 1: Download the AirHub Sync App APK

(Before you begin, ensure your DJI controller has an active internet connection (Wi-Fi or cellular data)).

The AirHub Sync App is provided as an Android Package Kit (APK) file for direct installation on DJI enterprise controllers.

• On your DJI controller's web browser, navigate to the following URL to download the APK file: https://tinyurl.com/airhubsync

• The download should begin automatically. Once complete, you may see a notification in your device's notification bar.

Step 2: Enable Installation from Unknown Sources

For security reasons, Android devices (including DJI controllers which run a custom version of Android) typically block installations from sources other than official app stores. You will need to temporarily enable this setting.

• Go to your DJI controller's Settings menu.

• Look for options like Security, Apps & notifications, or Privacy.

• Find a setting related to Install unknown apps or Unknown sources.

Step 3: Locate and Install the APK

• Open the File Manager or Downloads app on your DJI controller.

• Navigate to the folder where you downloaded the APK file

• Locate the AirHub Sync App APK file (e.g., airhub-sync-v0.0.4.APK).

• Tap on the APK file to begin the installation process.

Step 4: Login to AirHub Portal

After the initial app setup and permissions are granted, you will be directed to the login process.

• The app will present a login screen.

• Enter your Email Address associated with your existing AirHub Portal organizational account.

• Tap Continue.

• Next, enter your password for your AirHub Portal account.

Step 5: First-Time App Launch and Permissions Setup

Upon first launch, the AirHub Sync App will guide you through necessary permissions and folder selection.

• After logging in, the app will request Required Permissions. These are essential for the app to access flight logs. Tap Allow or the appropriate option to grant permissions.

Step 6: Syncing Your Flight Logs

Once you have successfully logged into the AirHub Sync App, the app is configured to handle your flight log syncing. There are two primary methods: manual syncing and automatic background syncing.

Manual Syncing:

• To manually sync, click the icon next to the flight log in the list (the cloud with an arrow).

Automatic Background Syncing:

The AirHub Sync App supports seamless automation, operating in the background to simplify your workflow.

• To activate automatic background syncing, navigate to “Settings” and toggle on automatic file sync. Now, once a flight concludes, the app intelligently detects the newly generated DJI flight record file on your device. It then securely and automatically transmits this file to your AirHub Portal account without requiring any further manual intervention.

Step 7: Confirm Flight Log Syncing

Once files are synced (either manually or automatically), flight logs are created in your AirHub Portal account. Navigate to to confirm files are syncing properly.

HexGen is the geospatial aggregation and modeling engine developed by Airspace Link. It enables the transformation of complex and distributed geospatial data into a common, unified data surface. This capability allows users to turn data into insights and insights into action.

One way to leverage the power of HexGen is with Automated Operation Risk Assessments. This digital risk assessment tool enables rapid, repeatable, and reliable risk insights for your planned operations. Use the generated surface and associated metrics to determine if your planned operation exceeds any risk thresholds for your organization, and capture metrics for waiver or COA requirements.

Prerequisites:

• An AirHub Portal Team, Advanced, or Enterprise Bundle

• [For Advanced and Enterprise] A user assigned the Planner user type

How to use:

1. Select HexGen widget at the top left corner of the map view

   1. This widget is visible in the operation creation form when a valid operation volume has been drawn, and in the operation details view after the operation has been created.

2. Click the “Select Surface Profile” button

   1. For

Best Practices

The HexGen risk assessment is best used as part of an organization operation planning policy. The HexGen risk assessment can provide a common, repeatable method to consistently analyze operation risks based on geospatial features in the operation area. For Advanced or Enterprise users, it is best practice to create specific HexGen Surface Profiles for common operation types or categories that require unique operation risk assessment parameters. This enables all operations of that type or category to have consistent risk exposure metrics.

Upgrade today!

For more information on upgrading to the Team or Advanced bundle, !

Other HexGen Details

Basic Risk Profile: Contains the following features and associated risk scores

• Prisons: 10

• Schools: 10

• Helipads: 10

• Hospitals: 8

1. Introduction

This guide outlines the process for integrating Survey123, an external data collection tool, with the AirHub® Portal. The goal is to enable a seamless two-way flow of work order data: allowing work orders to be created in the Portal from Survey123 and reflecting Portal status updates back into the original Survey123 feature layer.

2. Overview of the Integration Flow

The integration involves a two-way communication setup:

• Inbound Flow (Survey123 to AirHub® Portal - Work Order Creation):

  1. A user submits a Survey123 form.

  2. This triggers an event (e.g., a webhook associated with the Survey123 form submission) to send data.

  3. A Power Automate Flow (Inbound) receives this data, transforms the Survey123 format into Airspace Link's standard work order schema.

3. Pre-Integration Steps & Information Gathering (From Customer)

Before configuring the integration, essential information and access are required from the customer:

3.1. Understand the Customer's Survey123 Usage

• Familiarize yourself with how they intend to use Survey123 for work order intake.

• Understand the design of their proposed Survey123 form and the fields they plan to use.

3.2. Gather Key Information & Access from the Customer

• Customer's Survey123 Form URL: The URL of the specific Survey123 form that will be used for work order creation.

• Customer's ArcGIS Online Credentials (Optional): If Airspace Link will be setting up the Power Automate flows on their behalf, these credentials may be needed (decision pending on who creates/manages the PAFs).

• Schema & Field Mapping:

4. Airspace Link Portal Configuration

This section covers the configuration steps on the Airspace Link side.

4.1. Create Power Automate Flows (By Airspace Link)

• Draft Inbound Power Automate Flow: Create a Power Automate flow designed to trigger upon a Survey123 form submission and receive its data. This flow will generate a unique URL (if triggered by HTTP request).

• Draft Outbound Power Automate Flow: Create a Power Automate flow designed to receive updates from the Airspace Link Portal and publish them back to the Survey123 feature layer.

• Obtain Outbound URL (If applicable): If the Survey123 form isn't directly triggering the Power Automate flow, but rather a webhook that then calls an HTTP request, note the unique HTTP request URL generated by Power Automate. This will be used in Airspace Link's org.json configuration.

4.2. Update Airspace Link Configuration File

• Navigate to the org.json configuration file in the Airspace Link GitHub repository (specific location to be provided by engineering).

• For each environment (e.g., Development, Staging, Production), add a new entry for the customer's organization.

• Required Data for Each Organization Entry:

5. Survey123 System-Specific Configuration (By Airspace Link and Customer)

5.1. Customer's Survey123 Form Creation

• Objective: The customer creates their Survey123 form to collect work order requests.

• Action: The customer will design and publish their Survey123 form.

  • Best Practice: Encourage the customer to use a provided Airspace Link schema template to simplify subsequent field mapping.

5.2. Power Automate Flow (Inbound - Simpler Mapping)

• Objective: To receive Survey123 data and create a work order in AirHub® Portal.

• Action: Configure the Power Automate flow:

  • Trigger: Set to "When a new survey response is submitted" (or "When an HTTP request is received" if using webhooks).

  • Field Definition:

5.3. Power Automate Flow (Outbound - Update Feature Layer)

• Objective: To receive work order updates from AirHub® Portal and apply them back to the original Survey123 record.

• Action: Configure the Power Automate flow:

  • Trigger: Set to "When an HTTP request is received" (from AirHub® Portal).

  • Action:

6. Testing & Validation

Thorough testing is crucial to ensure the two-way integration works as expected.

• Test Inbound Flow: Submit a Survey123 form and verify the new work order appears correctly in the AirHub® Portal with all mapped fields.

• Test Outbound Flow: Update a work order's status (or other allowed fields) in the AirHub® Portal and verify these changes are reflected accurately in the original Survey123 record's feature layer.

• Edge Cases: Test various scenarios, including different field values and potential error conditions.

7. Important Considerations & Best Practices

• Power Automate Flow Ownership: A clear decision is needed on whether customers manage their own Power Automate flows (requiring detailed instructions from Airspace Link) or if Airspace Link creates/manages them using customer ArcGIS Online credentials.

• Survey123 Form Customization: While customization is supported, a standardized schema (e.g., via a template provided by Airspace Link) will significantly reduce integration complexity.

• Documentation: Capture detailed documentation as you go for each integration, particularly for unique customer configurations, to build repeatable processes.

This functionality empowers users with organization accounts to easily upload drone telemetry data and link it to their flight logs, capturing true flight activity, and providing precise and accurate data for compliance, asset monitoring, and pilot currency.

Supported Platforms

• AirHub® Portal supports importing flight record data from various platforms, making it easy to integrate with your existing systems: DJI Flight Records: [“.txt”]

• Pixhawk Aircraft: [“.bin”]

• Other generic file types: [“.csv” and “.kml”]

How to Use

Suggestion on how to summarize the above below.

Using the flight record upload feature is straightforward:

1. Select or Create a Flight Log: Start by choosing an existing flight log or creating a new one in AirHub Portal.

2. Upload Your Flight Record: Upload your telemetry file directly to the selected flight log.

3. Link the Data: In the Summary tab, find the Telemetry section, select your uploaded file, and click the button to parse and link the telemetry data.

Once completed, your flight path and other key metrics will be automatically updated in your flight log.

How to Download Telemetry Files from Your Aircraft, Controller, or Ground Control System.

For DJI Aircraft

You can obtain telemetry files directly from the aircraft controller or through the DJI app:

Method 1: Downloading from the DJI App (DJI GO 4 or DJI Fly)

iOS device & Mac computer:

1. Connect phone to computer: You may need to have your phone “trust” the computer

2. In Finder, select the device: The phone should show up as a drive under “Locations”

3. Select “Files,” expand the DJI GO 4 or Fly folder, and click on “FlightRecords.”: This folder contains the DJI flight record files

1. Copy the FlightRecords folder to your desktop: Click and drag the “FlightRecords” folder from the finder window onto your desktop to create a copy of the FlightRecords folder on your computer.

2. Find the FlightRecord file associated with the desired Flight Log in AirHub® Portal. This file will be uploaded and parsed in the Flight Log.

iOS device & Windows computer:

1. Open iTunes and Connect phone to computer: You may need to have your phone “trust” the computer

2. Select device view: Click the phone icon to access file sharing

1. Download a copy of the DJI FlightRecords folder: Select “File Sharing,” select the correct DJI app, select the “FlightRecords” folder, scroll to the bottom of the screen, and select the “Save…” button to save a copy of the folder on your computer.

1. Find the FlightRecord file associated with the desired Flight Log in the AirHub Portal. This file will be uploaded and parsed in the Flight Log.

Android device

1. Connect phone to computer: You may need to have your phone “trust” the computer

   • For Mac computers, you may need to install an Android file transfer utility program.

2. Find the DJI app file folder for the desired DJI app. The specific path may depend on your device, app version, and desired DJI app. An example folder path would be: “…/internal storage/DJI/dji.go.v4/”

Method 2: Downloading from the DJI Controller (Smart Controller, RC Pro, CrystalSky)

1. Connect the Controller to Your Computer: Use a USB cable to connect your DJI controller to your computer. Ensure device-specific file transfer is enabled.

2. Access the Internal Storage: Once connected, the controller’s internal storage should appear on your computer as an external drive.

3. Navigate to the FlightRecord Folder: Open the drive and navigate to the folder where the telemetry files are stored. This is usually under the DJI/dji.go.v4/FlightRecord directory (for DJI Go devices) or DJI/com.dji.industry.pilot (for DJI Pilot devices).

For Pixhawk Aircraft

Access telemetry files from your Pixhawk flight controller in the following ways.

Method 1: SD Card (For flight controllers with removable SD card)

1. Remove SD Card from flight controller: Connect to computer

2. Download binary (.bin) log file: Log files located at /APM/LOGS

Method 2: Mission Planner

1. Connect vehicle to Mission Planner: Can connect via USB or radio

2. Access DataFlash Logs: Select “FLIGHT DATA” and beneath the primary flight display, select “DataFlagh Logs” and “Download DataFlash Log via Mavlink”

3. Select and download selected logs: Select desired log(s) for associated Portal flight logs

Method 3: QGroundControl

1. Connect vehicle to QGC: Can connect via USB or radio

2. Access DataFlash Logs: Select the main menu (“Q” icon in the top left), “Analyze Tools”, and will load “Log Download”, and may need to press “Refresh”

3. Select and download selected logs: Select desired log(s) for associated Portal flight logs

For Other File Types:

CSV File

• Ensure the first record in the CSV file contains the field names, two of which must be “latitude” and “longitude”.

KML/KMZ File

• Ensure the path flown is represented using the “LineString” data type.

1. Introduction

This guide outlines the process for integrating ServiceNow, an external work order management system, with the AirHub® Portal. The goal is to establish a seamless two-way flow of work order data: creating work orders in the Portal from ServiceNow and reflecting Portal status updates back into ServiceNow.

2. Overview of the Integration Flow

The integration involves a two-way communication setup:

• Inbound Flow (ServiceNow to AirHub® Portal - Work Order Creation):

  1. A record is created or updated in ServiceNow.

  2. This triggers a ServiceNow Business Rule to send an HTTP request containing work order data.

  3. A Power Automate Flow (Inbound) receives this request, transforms the ServiceNow data format into Airspace Link's standard work order schema.

3. Pre-Integration Steps & Information Gathering (From Customer)

Before configuring the integration, essential information and access are required from the customer:

3.1. Understand the Customer's ServiceNow Configuration

• Familiarize yourself with their specific ServiceNow instance and how they use it for work orders.

• Understand their existing intake forms and the fields they use.

3.2. Gather Key Information & Access from the Customer

• ServiceNow Instance URL: The base URL of their ServiceNow instance.

• User Credentials: A dedicated user account within their ServiceNow instance for integration purposes.

  • Required Permissions: This user needs permissions to:

4. Airspace Link Portal Configuration (By Airspace Link)

4.1. Create Power Automate Flows

• Draft Inbound Power Automate Flow: Create a Power Automate flow designed to receive HTTP requests from the customer's ServiceNow Business Rule. This flow will generate a unique URL.

• Draft Outbound Power Automate Flow: Create a Power Automate flow designed to receive updates from the Airspace Link Portal and publish them back to ServiceNow.

• Obtain Outbound URL: For the outbound flow (Airspace Link to ServiceNow), note the unique HTTP request URL generated by Power Automate. This will be used in Airspace Link's org.json configuration.

4.2. Update Airspace Link Configuration File

• Navigate to the org.json configuration file in the Airspace Link GitHub repository (specific location to be provided by engineering).

• For each environment (e.g., Development, Staging, Production), add a new entry for the customer's organization.

• Required Data for Each Organization Entry:

5. ServiceNow System-Specific Configuration (By Airspace Link)

5.1. Business Rule (Inbound Trigger - ServiceNow to AirHub® Portal)

• Objective: To trigger a send of ServiceNow work order data to Airspace Link's inbound Power Automate flow.

• Action: Configure a new Business Rule within ServiceNow.

  • Table: Tie this rule to the specific ServiceNow table where work orders are managed.

5.2. Power Automate Flow (Inbound - Field Transformation)

• Objective: To receive ServiceNow data, transform it, and send it to the Airspace Link API.

• Action: Configure the Power Automate flow:

  • Trigger: Set to "When an HTTP request is received".

  • Field Definition: Define the expected fields from the ServiceNow request.

5.3. Scripted REST API (Outbound Reception - AirHub® Portal to ServiceNow)

• Objective: To receive work order updates from AirHub® Portal and apply them to ServiceNow records.

• Action: Create a Scripted REST API in ServiceNow.

  • Endpoint: Define a unique, external endpoint that can accept calls from outside ServiceNow.

6. Testing & Validation

Thorough testing is crucial to ensure the two-way integration works as expected.

• Test Inbound Flow: Create/update a work order in ServiceNow and verify it appears correctly in the AirHub® Portal with all mapped fields.

• Test Outbound Flow: Update a work order's status, notes, or deliverable URL in the AirHub® Portal and verify these changes are reflected accurately in the original ServiceNow record.

7. Important Considerations & Best Practices

• Field Mapping Complexity: Be prepared for detailed conversations with customers about their field definitions and values, especially for custom fields that may require specific handling.

• Power Automate Flow Ownership: A clear decision is needed on whether the customer or Airspace Link will own and manage these Power Automate flows. This impacts necessary access and instruction levels.

• Documentation: Capture detailed documentation as you go for each integration, particularly for unique customer configurations, to build repeatable processes.