Concepts - HERE Indoor Map

This section describes basic concepts, terminology, and components of HERE Indoor Maps.

Using indoor maps

You can use your indoor maps on your own applications, services, or solutions with the 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 only accessible by you. To get access to your indoor maps on your application or service, you must 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:

🚧
Caution
There are two preferred authentication methods:

For mobile applications and the Data API, the default authentication method is an OAuth token.

For web applications, the default authentication method is an API key.

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.

Organization management

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

In addition to the indoor map catalog, a default indoor map collection named Default Collection contains your indoor maps for use with a mobile or web application. A collection is a catalog which has at least one interactive map layer (IML) that 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.

Projects

Your data is 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 always keep the project structure intact and to never delete the project itself or remove data from the project, as projects are the building block of the Indoor Maps system.

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-e8030e1d-c48f-4545-9cc4-1a6aebef4e3m or indoormap-00000000-0000-4000-a000-000000012345 (legacy format).

📘
Note
The HERE platform allocates the UUID for your indoor map.