App

An app is a layer we add to the map with your custom data.

An app can have many features, and a feature can have many feature properties.

UML

Due to Mapbox, our map provider, there is a maximum limit of 11 apps per organization.

Integration Type

The integration type of an app describes the source of its data, and when it retrieves the data. The following integration types are supported:

• GOOGLE_SHEET: Applications for you to import data into Troop from a Google Sheet. Use this integration type to create map layers from datasets that you store in a Google Sheet (e.g. risk layers, office locations, etc).

  • Documentation: Google Sheets Reference.

• API_IMPORT: Applications for you to import data into Troop using our Graphql API and the API key for your app. Use this integration type as an alternative to the previous in case you want to code your own scripts to create map layers, instead of having a Google Sheet as source.

  • Documentation: API Reference.

• API_FETCH: Applications for Troop to fetch data from your APIs. Use this integration type to fetch data from your API in real-time (e.g. availability services such as transport rentals or meeting spaces, event data, etc).

  • Documentation: Fetch Applications.

The app type and subtype depend on the integration type. Check the supported type/subtype combinations for your integration type in the section below.

Type and Subtype

An app type describes the kind of information it serves. Currently we support the following types of apps:

SUSTAINABILITY

Applications that provide data around Hotels spesifically around their sustainability scores. SUSTAINABILITY apps support the following subtypes:

Name	App Subtype	Integration Type	Description	Examples
Green Accommodation	SUSTAINABILITY_GREEN_ACCOMMODATION	GOOGLE_SHEET	A dataset of hotels with their sustainability scores and metadata, to use during the destination analysis.	A list of hotels with green scores, based on different metrics.

LOCAL_TRANSPORT

Applications that provide information for local transport. LOCAL_TRANSPORT supports the following subtypes:

Name	App Subtype	Integration Type	Description	Examples
Local Transport Rentals	LOCAL_TRANSPORT_RENTALS	API_FETCH	API that fetches local transport options from the airport to your selected hotel.	Transfers from Airport to Hotel.

EMISSIONS

Applications that handle information around emissions. EMISSIONS supports the following subtypes:

Name	App Subtype	Integration Type	Description	Examples
Emissions Calculation	EMISSIONS_CALCULATION	API_FETCH	API that calculates emissions given a transport mode, distance, origin and destination.	Aircraft emissions.

PLACE_DATA

Applications that contain generic information about places that might be countries, regions, cities, or custom polygons/points you define, such as fixed points with longitude and latitude. PLACE_DATA supports the following subtypes:

Name	App Subtype	Integration Type	Description	Examples
Geographic Area	PLACE_DATA_GEOGRAPHIC_AREA	API_IMPORT or GOOGLE_SHEET	Known geographic areas to be printed in your map (no need to provide coordinates). For example, countries or states.	Country risk, COVID restrictions by country, LGTBQ+ risk...
Geographic Location	PLACE_DATA_GEOGRAPHIC_LOCATION	API_IMPORT or GOOGLE_SHEET	Raw geographic data to be printed in your map, where you need to provide coordinates.	Meeting spaces, office locations, restaurant locations...
Place Events	PLACE_DATA_EVENTS	API_FETCH	API that fetches event data for a given city like sport events.	Sporting Events.

App Subtype: Geographic Area

These apps are used to represent known geographic areas in your map: countries, regions/states and/or cities, without the need to provide coordinates. When creating features for apps of this subtype, you need to provide one of country, region or city in order to represent them on the map.

This is how apps of this kind look like in Troop:

App Subtype: Geographic Location

These apps are used to draw raw geographic data in your map by providing the coordinates. When creating features for apps of this subtype, you need to provide both type and coordinates to represent them on the map.

This is how apps of this kind look like in Troop: