Explore Data

The HERE portal is where you can start exploring data. The portal helps business analysts, data scientists, and developers to explore data by browsing, filtering, and searching for catalogs and layers.

Hint

It's a good idea to learn core concepts before exploring data, especially the concepts of catalogs, layers, and partitions, so that you understand what you see in the portal.

Click Data in the navigation bar to see a list of catalogs and layers that you have permission to access.

Explore Data with APIs

After you have taken a look at the catalogs available to you using the portal, you may be interested in using the HERE Data SDK for Java & Scala or the REST APIs to get the list of catalogs available to you.

HERE Data SDK for Java & Scala

See Verify Your Credentials and Access a Catalog for a code snippet that queries the HERE Map Content catalog (the catalog with all the traditional HERE map data) to get the latest available version, and some metadata associated with the catalog such as issue date, available layers, and the list of direct dependencies with the input catalogs you used to create this catalog). For more information on using the Data SDK for Java & Scala, see Get Started with the HERE Data SDK for Java & Scala.

REST

Here's a request that returns a list of the catalogs you have access to.

HTTP
curl
GET /config/v1/catalogs HTTP/1.1
Host: <Hostname for config>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache
curl -X GET
     -H "Authorization: Bearer <Authorization Token>"
     -H "Cache-Control: no-cache"
     https://<Hostname for config>/config/v1/catalogs

The response is a listing the catalogs you have access to.

{
    "results": {
        "items": [
            {
                "title": "HERE Archived Weather North America",
                "hrn": "<Catalog HRN>",
                "href": "https://config.data.api.platform.here.com/config/v1/catalogs/<Catalog HRN>",
                "type": "urn:olp-types:catalog"
            },
            {
                "title": "HERE Archived Weather Western Europe",
                "hrn": "<Catalog HRN>",
                "href": "https://config.data.api.platform.here.com/config/v1/catalogs/<Catalog HRN>",
                "type": "urn:olp-types:catalog"
            },
            {
                "title": "HERE Live Weather North America",
                "hrn": "<Catalog HRN>",
                "href": "https://config.data.api.platform.here.com/config/v1/catalogs/<Catalog HRN>",
                "type": "urn:olp-types:catalog"
            },
            {
                "title": "HERE Live Weather Western Europe",
                "hrn": "<Catalog HRN>",
                "href": "https://config.data.api.platform.here.com/config/v1/catalogs/<Catalog HRN>",
                "type": "urn:olp-types:catalog"
            },
            {
                "title": "HERE Map Content",
                "hrn": "<Catalog HRN>",
                "href": "https://config.data.api.platform.here.com/config/v1/catalogs/<Catalog HRN>",
                "type": "urn:olp-types:catalog"
            },
            {
                "title": "HERE Real Time Traffic",
                "hrn": "<Catalog HRN>",
                "href": "https://config.data.api.platform.here.com/config/v1/catalogs/<Catalog HRN>",
                "type": "urn:olp-types:catalog"
            },
            {
                "title": "HERE Weather Forecast",
                "hrn": "<Catalog HRN>",
                "href": "https://config.data.api.platform.here.com/config/v1/catalogs/<Catalog HRN>",
                "type": "urn:olp-types:catalog"
            }
        ]
    }
}

Using the catalog's HERE Resource Name (HRN), you can get the details about a catalog. In this example, the HRN is here:here:data:::olp-traffic-1.

HTTP
curl
GET /config/v1/catalogs/hrn:here:data:::olp-traffic-1 HTTP/1.1
Host: config.data.api.platform.here.com
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache
curl -X GET
     -H "Authorization: Bearer <Authorization Token>"
     -H "Cache-Control: no-cache"
     https://<Hostname for config>/config/v1/catalogs/hrn:here:data:::olp-traffic-1

The body of the response contains the details about the catalog:

{
    "id": "olp-traffic-1",
    "hrn": "hrn:here:data:::olp-traffic-1",
    "name": "HERE Real Time Traffic",
    "summary": "HERE Real Time Traffic provides live information on traffic conditions on roadways.",
    "description": "HERE Real Time Traffic provides a live depiction of conditions on the road. It identifies where, when and why traffic congestion occurs, and delivers up-to-the-minute information on the road conditions and incidents that could set a driver back.\n\nReal-time traffic data is produced by a sophisticated model that aggregates and analyzes a mix of sources, including high-quality rich vehicle sensor data.\n\nThe result: best-in-class accuracy in depicting real-world traffic conditions.\n\nHERE Real Time Traffic consists of two layers. The Traffic Flow layer provides the speed at which traffic is currently flowing, by road. The Traffic Incident layer contains records for incidents that are currently affecting traffic flow.",
    "contacts": {},
    "coverage": {
        "adminAreas": [
            "VN",
            "IN",
            "KW",
            "ID",
            "BG",
            "SG",
            "TH",
            "AT",
            "TR",
            "MY",
            "RU",
            "GI",
            "PR",
            "TW",
            "PH",
            "ES",
            "SM",
            "NZ",
            "US",
            "SI",
            "BH",
            "AD",
            "RO",
            "LU",
            "IE",
            "BE",
            "AU",
            "SA",
            "HU",
            "FI",
            "NO",
            "EE",
            "LT",
            "PL",
            "CH",
            "LV",
            "SE",
            "AE",
            "AR",
            "HR",
            "GB",
            "FR",
            "PT",
            "MC",
            "UA",
            "LI",
            "BR",
            "IT",
            "CZ",
            "GR",
            "ZA",
            "OM",
            "MX",
            "SK",
            "QA",
            "DK",
            "NL",
            "CA",
            "IM",
            "VA",
            "DE"
        ]
    },
    "owner": {
        "creator": {
            "id": "HERE-383016a9-fa93-44c0-8294-a156a9df650d"
        },
        "organisation": {
            "id": "olp-here"
        }
    },
    "tags": [
        "TRAFFIC"
    ],
    "billingTags": [],
    "created": "2018-01-24T22:20:07.462Z",
    "layers": [
        {
            "id": "traffic-flow",
            "hrn": "hrn:here:data:::olp-traffic-1:traffic-flow",
            "name": "Traffic Flow",
            "summary": "Current traffic speeds",
            "description": "The traffic flow layer provides the current speed of traffic on roads. Powered by HERE Traffic, the speeds are updated every minute.\n\nEach tile contains Protobuf data, which is a list of all the current traffic flow messages based on the Traffic schema. Any message which spans across multiple tiles will be reported in all tiles where it exists, with the same ID.",
            "coverage": {
                "adminAreas": [
                    "VN",
                    "IN",
                    "KW",
                    "ID",
                    "BG",
                    "SG",
                    "TH",
                    "AT",
                    "TR",
                    "MY",
                    "RU",
                    "GI",
                    "PR",
                    "TW",
                    "PH",
                    "ES",
                    "SM",
                    "NZ",
                    "US",
                    "SI",
                    "BH",
                    "AD",
                    "RO",
                    "LU",
                    "IE",
                    "BE",
                    "AU",
                    "SA",
                    "HU",
                    "FI",
                    "NO",
                    "EE",
                    "LT",
                    "PL",
                    "CH",
                    "LV",
                    "SE",
                    "AE",
                    "AR",
                    "HR",
                    "GB",
                    "FR",
                    "PT",
                    "MC",
                    "UA",
                    "LI",
                    "BR",
                    "IT",
                    "CZ",
                    "GR",
                    "ZA",
                    "OM",
                    "MX",
                    "SK",
                    "QA",
                    "DK",
                    "NL",
                    "CA",
                    "IM",
                    "VA",
                    "DE"
                ]
            },
            "owner": {
                "creator": {
                    "id": "HERE-383016a9-fa93-44c0-8294-a156a9df650d"
                },
                "organisation": {
                    "id": "olp-here"
                }
            },
            "schema": {
                "hrn": "hrn:here:schema:::com.here.traffic.realtime:traffic_v1:1.1.0"
            },
            "ttlHours": 1,
            "ttl": 3600000,
            "partitioningScheme": "heretile",
            "partitioning": {
                "tileLevels": [
                    12
                ],
                "scheme": "heretile"
            },
            "contentType": "application/x-protobuf",
            "volume": {
                "maxMemoryPolicy": "failOnWrite",
                "packageType": "large",
                "volumeType": "volatile"
            },
            "tags": [
                "TRAFFIC",
                "FLOW",
                "SPEED",
                "REAL-TIME",
                "CURRENT"
            ],
            "billingTags": [],
            "created": "2018-01-24T22:23:02.543Z",
            "layerType": "volatile"
        },
        {
            "id": "traffic-incident",
            "hrn": "hrn:here:data:::olp-traffic-1:traffic-incident",
            "name": "Traffic Incident",
            "summary": "Current traffic incidents",
            "description": "The traffic incident layer provides a set of incidents affecting traffic, associated with the road segments they affect. Powered by HERE Traffic, the layer is updated every minute with fresh information. Examples of traffic incidents include accidents, construction, and road closures.\n\nEach tile contains Protobuf data, which is a list of all the current traffic incident messages based on the Traffic schema. Any message which spans multiple tiles will be reported in all tiles where it exists, with the same ID.",
            "coverage": {
                "adminAreas": [
                    "BG",
                    "AT",
                    "TR",
                    "RU",
                    "PR",
                    "ES",
                    "NZ",
                    "US",
                    "SI",
                    "RO",
                    "IE",
                    "BE",
                    "AU",
                    "HU",
                    "FI",
                    "NO",
                    "PL",
                    "CH",
                    "SE",
                    "HR",
                    "GB",
                    "FR",
                    "BR",
                    "IT",
                    "CZ",
                    "GR",
                    "ZA",
                    "DK",
                    "NL",
                    "CA",
                    "DE"
                ]
            },
            "owner": {
                "creator": {
                    "id": "HERE-383016a9-fa93-44c0-8294-a156a9df650d"
                },
                "organisation": {
                    "id": "olp-here"
                }
            },
            "schema": {
                "hrn": "hrn:here:schema:::com.here.traffic.realtime:traffic_v1:1.1.0"
            },
            "ttlHours": 1,
            "ttl": 3600000,
            "partitioningScheme": "heretile",
            "partitioning": {
                "tileLevels": [
                    12
                ],
                "scheme": "heretile"
            },
            "contentType": "application/x-protobuf",
            "volume": {
                "maxMemoryPolicy": "failOnWrite",
                "packageType": "large",
                "volumeType": "volatile"
            },
            "tags": [
                "TRAFFIC",
                "INCIDENTS",
                "EVENTS",
                "CONGESTION",
                "REAL-TIME",
                "CURRENT"
            ],
            "billingTags": [],
            "created": "2018-01-24T22:40:44.168Z",
            "layerType": "volatile"
        }
    ],
    "version": 18
}

For more information on using the REST API, see Get Started with the REST API.

results matching ""

    No results matching ""