Data Lens Developer's Guide

Datasets Summary

The datasets summary response body is a JSON object returned by the Data Lens REST API in response to a request for a list of existing datasets.

Table 1. Datasets Summary Response Elements
Element Data Type Description
datasets Array List of dataset descriptions, empty if no datasets are present. Each description contains the following fields:
  • created_at – date and time when the dataset was created, in ISO 8601 format with the Z indicating that the time is in UTC
  • description – description of the dataset, based on the value provided when the dataset was created
  • files – a list containing the following fields:
    • size – the size of the file in bytes
    • uploaded_at – date and time when the file was uploaded, in ISO 8601 format with the Z indicating that the time is in UTC
    • filename – name of the file
  • id – unique ID that identifies the dataset
  • name – name of the dataset
  • origin – source of the dataset; possible values include:
    • user - the dataset was uploaded by a user logged into Data Lens
    • starter_pack - the dataset was part of the standard set of datasets preloaded into user accounts for demonstration purposes
    • geocoding - the dataset was generated by a geocoding job
  • row_count – number of rows in the dataset
  • updated_at – last date and time the dataset was updated, in ISO 8601 format with the Z indicating that the time is in UTC
kind String Type of response: the value is datalens#datasets_summary when the request is successful

The code example below illustrates a typical response to a successful request.

{
  "kind": "datalens#datasets_summary",
  "datasets": [
    {
      "files": [],
      "row_count": 0,
      "name": "test dataset two",
      "updated_at": "2015-06-23T15:38:06Z",
      "created_at": "2015-06-23T15:38:06Z",
      "id": "7238af9870754323bbe6fbed6796c3d9",
      "origin": "user",
      "description": "this is a test dataset"
    },
    {
      "files": [],
      "row_count": 0,
      "name": "test dataset",
      "updated_at": "2015-06-22T15:11:00Z",
      "created_at": "2015-06-22T15:11:00Z",
      "id": "b485eda18e3a49e3ba7642ed23c72d94",
      "origin": "user",
      "description": "this is a test dataset"
    }
  ]
}

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.