Customer needs to create a stream layer in HERE Platform Portal for real-time data publishing

Symptoms / Triggers
-------------------

Use this article if you are trying to create a stream layer in HERE Platform Portal and your question or issue sounds like one of the following:

"How do I create a stream layer in HERE Platform Portal?"
"Where is the Add new layer button in my catalog?"
"Which layer type should I select for real-time or streaming data?"
"What values should I enter for Throughput In, Throughput Out, Retention, Partitioning, Content Type, Content Encoding, Schema, or Coverage?"
"I need to publish data continuously to a HERE Platform catalog."
"I created a catalog, but I do not know how to add a stream layer."
"My catalog shows Updating Catalog or Creating Layer after saving."
"What is the required Platform structure: catalog, layer, partition, and data?"

Quick Answer
------------

To create a stream layer: sign in to HERE Platform Portal → open your catalog → click Add new layer (top right) → select stream as the layer type → fill in the required fields → click Save Layer. After saving, the catalog will show Updating Catalog and the layer will show Creating Layer until provisioning completes.

Applies To
----------

| | |
| --- | --- |
| Product | HERE Platform |
| Tool | HERE Platform Portal |
| Layer type | Stream layer |
| Use case | Real-time / continuously published data |

Background
----------

Data in HERE Platform is organized as: Catalog → Layer → Partition → Actual data

A stream layer is used when data is published and consumed continuously — such as near real-time location, sensor, telemetry, or event data. Before creating a stream layer, you must have access to a HERE Platform realm and an existing catalog.

Prerequisites
-------------

You can sign in to your HERE Platform realm via Platform Portal.
You have permission to create or edit catalogs and layers.
You already have a catalog (or can create one).
You know your expected data format and streaming requirements (content type, retention, throughput).

Note: If you need to create a catalog first, refer to Create a catalog or search the Knowledge Base for Create catalog using Platform Portal.

---

Step-by-Step Instructions
-------------------------

### Step 1 — Sign in to HERE Platform Portal

1. Go to HERE Platform Portal and sign in to the correct realm.
2. Open the Data tab.

### Step 2 — Open your catalog

1. Search for and click your catalog in the Data tab.
2. The catalog details page opens.

### Step 3 — Add a new stream layer

1. Click Add new layer in the upper-right corner.
2. In the form, enter your layer details (see table below).
3. For Select Layer Type, choose stream.
4. Click Save Layer at the bottom.

Example Layer Configuration
---------------------------

| Field | Description | Required / Optional | Example Value |
| --- | --- | --- | --- |
| Layer Name | Display name of the layer | Required | sample-stream-layer-name |
| Layer ID | Unique ID within the catalog | Required | sample-stream-layer-id |
| Layer Summary | Short summary shown in catalog layer list | Required | This is a sample stream layer |
| Layer Description | Longer description on layer details page | Required | This is a sample stream layer |
| Tags | Keywords to find this layer later | Optional (recommended) | sample-layers |
| Cost Allocation Tags | Billing grouping tags (alphanumeric only) | Optional (recommended) | samplestream |
| Select Layer Type | Type of layer | Required | stream |
| Throughput In | Max publish speed | Default: 4 MBPS | 4 MBPS |
| Throughput Out | Max consume speed | Default: 8 MBPS | 8 MBPS |
| Retention | How long data remains available | Default: 60 minutes | 60 |
| Partitioning | Partitioning type | Required | Generic |
| Content Type | Format of your data | Required | text or csv |
| Content Encoding | Whether data is compressed | Default: uncompressed | uncompressed |
| Schema | Structure definition for your data | Default: None | None |
| Coverage | Geographic area covered by data | Optional | Europe → Germany |

Save and Verify
---------------

After clicking Save Layer, layer creation may take some time. You will see:

Updating Catalog on the catalog details page
Creating Layer next to the layer name

Refresh the page periodically. When both statuses clear and the layer is visible, the stream layer has been created successfully.

Common Questions
----------------

Why do I see "Updating Catalog" or "Creating Layer"?
These are expected provisioning statuses. Wait for the operation to complete, then refresh the page.

Which layer type should I choose for continuously published data?
Choose stream for near real-time or continuous data publishing and consumption.

Do I need a catalog before creating a stream layer?
Yes. The data hierarchy is: Catalog → Layer → Partition → Actual data. A layer must belong to a catalog.

Next Step
---------

After creating the stream layer, you can publish data to it. Search the Knowledge Base for: Upload data to stream layer

Search Tags / Keywords
----------------------

create stream layer · stream layer · HERE Platform Portal · Add new layer · Creating Layer · Updating Catalog · real-time data · streaming data · publish data · consume data · Throughput In · Throughput Out · retention · partitioning · content type · content encoding · schema · coverage · catalog layer partition data · Data tab