GuidesAPI Reference
Guides

HRN

A HRN (HERE Resource Name) is a string that identifies a resource across different HERE services and accounts. HRNs use the following format:

hrn:{partition}:{service}::{account}:{resource}

The HERE Tracking API uses HRNs to identify projects and catalogs. For more information, see HERE resource names.

HERE Tracking API project HRNs

A Project HRN refers to a project. It uses the following format:

hrn:here:authorization::{realm}:project/{project-id}

In a project HRN, {realm} is your customer realm, and {project-id} is your project ID.

This HRN is required as part of an authorization process to the HERE Tracking REST API. The HRN identifies which project is receiving the authorized HTTP requests.

To see your project HRN, visit the HERE platform and navigate to Launcher -> Projects Manager.

Catalog HRN

A Catalog HRN refers to a HERE Catalog. The HERE Tracking API supports the following catalogs:

hrn:here:data::{realm}:tc-input-{project-id}
hrn:here:data::{realm}:tc-output-{project-id}

In a Catalog HRN,{realm} is your customer realm, and {project-id} is your project Id. A Catalog HRN with tc-input- in the resource name is an input stream catalog, while an HRN with tc-output- is an output stream catalog.

This HRN is used for accessing catalog streams from HERE Tracking. For more information, see Input streams, Events output streams, and Traces output streams.

To see the catalog HRNs for a given project, visit Platform portal and navigate to Launcher -> Projects Manager. Open your project, and then go to Resources -> Catalogs to see your available catalogs. You can see the catalog HRNs for any project by opening its associated catalog. If you do not see any stream catalogs, contact us.