Geovisualization Developer's Guide

Sign In

The query result response body is a JSON object returned by the Geovisualization REST API in response to a request to sign in to Geovisualization and get an access token.

Table 1. Sign In Response Elements
Element Data Type Description
access_token String Temporary access token for Geovisualization, valid for one hour from its creation. The number of seconds remaining in its validity is expressed in the expires_in element.
countryCode* String ISO 3166-3 alpha-3 compliant code for the country registered in the HERE Account
createdTime* Integer The Unix time of the HERE Account creation
dob* String Date of birth of the person associated with the HERE Account
email* String Email account of the person associated with the HERE Account
expires_in Integer Remaining time in seconds of the token's validity
firstname* String First name of the person associated with the HERE Account
kind String Type of response: the value is datalens#access_token when requests to the endpoint sign_in are successful and datalens#refresh_token when requests to the endpoint sign_in/refresh are successful
language* String The ISO 639-1 compliant language code registered in the HERE Account
lastname* String Last name of the person associated with the HERE Account
refresh_token String Unique ID for refreshing the access token
token_type String Token type: the value is bearer
updatedTime* Integer The Unix time of the HERE Account last change
userId* String Unique user ID for the HERE Account

*Elements included in the response to requests to the endpoint sign_in only; all the others are included in the response to both sign_in and sign_in/refresh

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

{
  "updatedTime": 1424794318292,
  "kind": "datalens#access_token",
  "language": "en",
  "firstname": "Frank",
  "access_token": "token_string",
  "lastname": "Developer",
  "countryCode": "DEU",
  "expires_in": 3599,
  "userId": "HERE_token",
  "token_type": "bearer",
  "dob": "29/03/1978",
  "createdTime": 1424794318340,
  "email": "developer_email",
  "refresh_token": "token_string"
}