Concepts

This section outlines basic concepts, terminology, and components to help you familiarize yourself with HERE Indoor Map.

Using indoor maps

You can use your indoor maps on your own applications, services, or solutions with HERE Maps API for JavaScript, HERE SDK (Navigate Edition), and the Data API. These are all HERE platform services, and provide other content along with your indoor maps.

Credentials and authentication

Your indoor maps are private maps and by default, are accessible only by you. To get access to your indoor maps on your application or service, you need to have credentials from the HERE platform for authentication. For more information on getting credentials from the HERE platform, see the Identity and Access Management Guide.

For more information on credentials for HERE Indoor Maps, see the following tutorials:

• Add indoor maps to your web application
• Add indoor maps to your mobile application
• Use the Data API to fetch indoor maps

Indoor portal

The Indoor portal shows basic information about your indoor maps, such as the indoor map's name and properties, such as address and last update time. You can order new indoor maps and changes or updates to indoor maps from the Indoor portal.

Indoor maps on Map Object Model (MOM)

Map Object Model (MOM) is a HERE-wide used GeoJSON map format for (indoor) map data. All indoor maps on the HERE platform are represented in the MOM format. For more information, see the HERE Indoor Map Data Specification.

For more information about the GeoJSON specification, see https://geojson.org/.

Organization

For information on access right management of your organizational resources, and instructions on how to add new users see the Identity and Access Management Guide.

Indoor Map catalog

The HERE platform stores data in catalogs. Within a catalog, layers hold the actual data.

Your indoor maps data is stored in a dedicated catalog named Indoor Maps which has a versioned layer Indoor Map Models for the MOM data. Within the Indoor Map Models layer, the data for each map is stored in a separate partition, using the Indoor Map UUID as the partition name.

Indoor Map collection catalog

Besides the indoor map catalog, a default indoor map collection named Default Collection contains your indoor maps to be used with a mobile or web application. A collection is a catalog, which has at least one interactive map layer (IML) which contains a copy of the combined MOM-formatted GeoJSON data of all your indoor maps. The collection also contains the map rendering rules and the collection metadata.

It is not necessary for you to manage these collections. HERE will manage these on your behalf.

Projects

Your data will be stored within the indoor project within your organization. You can add other users to the project to grant them full access to all project resources. It is important to keep the project structure intact and to not delete the project itself or remove data from the project, as the system relies on it.

A project contains at least two resources:

• The main maps catalog with your map data.
• A default collection for web and mobile applications.

The project will also have two platform applications:

• The Indoor Project Management App which can be used to access and manage all data within the project
• The Default Map Collection App which can only read from both catalogs and is primarily used for web and mobile use cases

Indoor Map UUID

An Indoor Map UUID is a unique identifier for a HERE Indoor Map. For example, an Indoor Map UUID could be indoormap-00000000-0000-4000-a000-000000012345. The part indoormap-00000000-0000-4000-a000- is always the same.

Indoor Map ID

An Indoor Map ID is the short identifier for an indoor map and the last part of the Indoor Map UUID without the leading zeros. In the example above, this would be 12345.