CatalogIdentifier Structure Reference
- Last UpdatedJun 10, 2025
- 2 minute read
public struct CatalogIdentifier : Hashable
This class is used to identify any catalog in the HERE platform.
A catalog is a storage-representation to store map data on the HERE platform.
The data inside a catalog is divided into layers, where each layer consists
of datasets with similar functional attributes in the physical world.
For example, there can be a layer for road-topology, a layer for
road-attributes (such as speed limits) and a layer for places and business
addresses. All these layers, in different geographic regions, can be grouped together into a
catalog to create a representation of the world we live in, called HERE map.
It can be also used to render a MapView
. Each geographic region is cut into geospatial
tiles for efficient search, map display, routing, map matching, and driver warnings.
Each tile partitions the map data (in one or more layers, depending on the product)
in the geolocation of that specific tile.
The data inside a catalog is logically managed and access controlled
as a single set. If you have any data that you want to bring to the HERE
platform, you need a catalog to contain it.
For additional information about catalogs, and related concepts of data representation
on the HERE platform, refer to
the Data API
and Introduction to Mapping Concepts
-
A HERE Resource Name (HRN) for this catalog. This is a unique string returned by the HERE platform when you add a new catalog to your project. For information about catalog creation process refer to the Data API By default, this field points to a default catalog on HERE platform, which contains data for the whole world excluding the region of Japan. Use
CatalogConfiguration.getDefault(...)
to get the default HRN value for use with the HERE platform.Declaration
Swift
public var hrn: String
-
A version number for a catalog. When accessing a catalog, this version must be specified. Set
nil
to automatically get the latest version for a catalog. The field defaults tonil
. Since the data inside a catalog can be updated, each published modification needs to correlate to a specific version number. Note: whenCatalogIdentifier
created withDesiredCatalog
then:- numerical
-1
corresponds toCatalogVersionHint.latest(...)
withignoreCachedData
set totrue
; nil
corresponds toCatalogVersionHint.latest(...)
withignoreCachedData
set tofalse
;- other numerical values correspond to
version
passed toCatalogVersionHint.specific(...)
.
Declaration
Swift
public var version: Int64?
- numerical
-
Creates a new instance.
Declaration
Swift
public init(hrn: String = "hrn:here:data::olp-here:ocm", version: Int64? = nil)