Geovisualization Developer's Guide

Materialize Query

The materialize query response body is a JSON object returned by the Geovisualization REST API in response to a request to create a new dataset using an arbitrary query ("query materialization").

Table 1. Materialize Query Response Elements
Element Data Type Description
created_at ISO Datetime Date and time the dataset was created by materializing the query, in ISO 8601 format with the Z indicating that the time is in UTC
dataset String Unique ID of the new dataset
id String Unique ID of the query materialization job
kind String Type of response: the value is datalens#job when the request is successful
updated_at ISO Datetime Date and time the dataset was last modified, in ISO 8601 format with the Z indicating that the time is in UTC
status String Status of the query materialization job.
Possible values include:
  • canceling
  • failed
  • canceled
  • pending

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

{
        "status": "pending",
      "kind": "datalens#job",
      "created_at": "2016-06-25T13:30:30Z",
      "updated_at": "2016-06-25T13:30:30Z",
      "dataset": "47457f667deb41b5976abca716a08bf3",
      "id": "1d4bd5ac72ea4c2fb6226bdb4261c518"
}