CatalogIdentifier (API Reference)
Class CatalogIdentifier
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
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
-
Field Details
-
hrn
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(com.here.sdk.core.engine.CatalogType)to get the default HRN value for use with the HERE platform. -
version
A version number for a catalog. When accessing a catalog, this version must be specified. Set
nullto automatically get the latest version for a catalog. The field defaults tonull. Since the data inside a catalog can be updated, each published modification needs to correlate to a specific version number. Note: whenCatalogIdentifiercreated withDesiredCatalogthen:- numerical
-1corresponds toCatalogVersionHint.latest(boolean)withignoreCachedDataset totrue; nullcorresponds toCatalogVersionHint.latest(boolean)withignoreCachedDataset tofalse;- other numerical values correspond to
versionpassed toCatalogVersionHint.specific(long).
- numerical
-
-
Constructor Details
-
CatalogIdentifier
public CatalogIdentifier()Creates a new instance.
-
-
Method Details