This section outlines basic concepts, terminology, and components to help you familiarize yourself with HERE Indoor Map.
Using 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:
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.
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/.
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.
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.
HERE allocates the UUID for your indoor map.
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