Create Catalogs
- Last UpdatedMar 27, 2025
- 9 minute read
To manage catalogs, add the data-client
module as a dependency to your project.
Configure Catalogs
Catalog configurations include the properties listed in the following table. Mandatory properties are in bold.
Note
Catalog IDs
Catalog IDs are publicly visible since they are part of the catalog HRN. Do not include private or company confidential information when you specify a catalog ID. Catalog names are private by default, which means you can add your private or confidential information in this field.
Layer configurations include the properties listed in the table below.
Versioned layer configuration
Versioned layers have the following additional configuration fields.
Property | Description |
---|---|
secureHandles | A boolean flag which indicates if the layer metadata and blob are in mode of secure data handles support. It requires catalog area scheme to be set and supports only heretile partitioning of the layer. |
subsetRestrictions | A boolean flag which indicates if the subsetRestrictions for a layer is enabled or not. subsetRestrictions can only be enabled for layers of catalogs that are defined within projects. It requires area scheme of the catalog being set. Supported layer subsetRestrictions are enabled by default when subsetRestrictions is enabled for the catalog. Layer subsetRestrictions requires catalog subsetRestrictions to be enabled. If catalog subsetRestrictions are disabled, supported layer's subsetRestrictions will be disabled by default. Supported only for layers with heretile partitioning. |
Volatile layer configuration
Volatile layers have the following additional configuration fields.
Index layer configuration
Index layers have the following additional configuration fields.
Property | Description |
---|---|
indexDefinitions | The collection of index key definitions to index published partitions. |
ttl | Time to Live of indexed data in index layer. If not specified it defaults to 7 days. |
Each index key definition contains the following configuration fields:
Supported index key types:
The TimeWindow index key is required. Index layers can have at most a single TimeWindow and a single HereTile index key. This means that Index layers can have exactly one TimeWindow index key and only one optional HereTile index key.
Below are the possible TTL values:
Stream layer configuration
Stream layers have the following additional configuration fields.
Note
General recommendation for stream layer properties
(dataInThroughputKbps
anddataOutThroughputKbps
andparallelization
) is to provide all of them in the request.To preserve backward compatibility, there are few corner cases:
- User should provide either
dataInThroughputKbps
anddataOutThroughputKbps
orparallelization
.- If all 3 fields are provided, then we use them as is.
- If all stream properties are missing, then default values
dataInThroughputKbps = 1000, dataOutThroughputKbps = 4000, parallelization = 4
will be set
Interactive Map layer configuration
Interactive Map layers have the following additional configuration fields.
Property | Description |
---|---|
Searchable Properties | Interactive map layers can be configured with 'Searchable Properties'. This is a list of strings containing the properties you want to index for faster searching. Searchable properties can be updated at any time. A maximum of eight searchable properties can be added. |
Automatic Version Deletion Configuration
Warning
Data loss
Deleting Catalog versions will delete partition metadata AND data associated with those versions, impacting all versioned layers in the catalog. The partition metadata and data will be irrecoverable. Any partition metadata and data from deleted versions that is still used in current, non-deleted versions will not be deleted so that non-deleted versions remain functional.
Supported automaticVersionDeletion types:
Property | Description |
---|---|
numberOfVersionsToKeep | If set and once the max number of versions is reached, every time a new version is created, the oldest version will be deleted. |
Note
For instructions on how to disable automatic version deletion, see Disable an Automatic Version Deletion
Create Catalogs
To configure and create catalogs, add the following:
Note
It may take several minutes for a new catalog to appear in the list of catalogs returned by the Data Client Library, CLI, REST API, and the list displayed on the HERE platform portal.