ZillionInfo DataSphereX API (1.0.0)

Download OpenAPI specification:

ZillionInfo DataSphereX API

Data Management

Manage data resources

Upload data to the platform

upload

Authorizations:
bearerHttpAuth
query Parameters
codeType
string

Encoding type. Default is 'UTF-8'

Request Body schema: multipart/form-data
required
file
required
string <binary>

Responses

Response samples

Content type
application/json
{
  • "fileName": "string",
  • "recordid": 0,
  • "error": "string"
}

Import shapefile

Import shapefile

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
fileName
required
string

File name

recordid
required
integer

Record ID

codeType
required
string

Encoding type

name
required
string

The new data name

Responses

Request samples

Content type
application/json
{
  • "fileName": "string",
  • "recordid": 0,
  • "codeType": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "geomType": "string",
  • "dataName": "string",
  • "unitUrl": "string",
  • "bounds": "string",
  • "error": "string"
}

Import CSV

Import CSV

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
fileName
required
string

File name

recordid
required
integer

Record ID

codeType
required
string

Encoding type

name
required
string

The new data name

Responses

Request samples

Content type
application/json
{
  • "fileName": "string",
  • "recordid": 0,
  • "codeType": "string",
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "csv": {
    },
  • "dataName": "string",
  • "error": "string"
}

Get spatial data list

Get spatial data list

Authorizations:
bearerHttpAuth

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get attribute data list

Get attribute data list

Authorizations:
bearerHttpAuth

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get data by name

Get data by name

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
name
required
string

Data name

type
required
string
Enum: "SHP" "CSV"

Data type

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "type": "SHP"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "error": "string"
}

Get fields of spatial data

Get fields of spatial data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Data ID

getType
boolean
Default: false

Whether to get the type of the field

getStatistics
boolean
Default: false

Whether to get the statistics of the field

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "getType": false,
  • "getStatistics": false
}

Response samples

Content type
application/json
{
  • "unitFields": [
    ],
  • "fieldTypes": {
    },
  • "statistics": {
    },
  • "error": "string"
}

Get fields of attribute data

Get fields of attribute data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
csvId
required
string

The id of the attribute data

getType
boolean
Default: false

Whether to get the type of the field

getStatistics
boolean
Default: false

Whether to get the statistics of the field

Responses

Request samples

Content type
application/json
{
  • "csvId": "string",
  • "getType": false,
  • "getStatistics": false
}

Response samples

Content type
application/json
{
  • "fields": "string",
  • "fieldTypes": {
    },
  • "statistics": {
    },
  • "error": "string"
}

Update spatial data resource

Update spatial data resource

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
id
required
integer

Data ID

name
string

Data name

description
string

Data description

tags
string

Data tags

Responses

Request samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "tags": "string"
}

Response samples

Content type
application/json
{
  • "error": "string"
}

Update attribute data resource

Update attribute data resource

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
id
required
integer

Data ID

name
string

Data name

description
string

Data description

tags
string

Data tags

Responses

Request samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "tags": "string"
}

Response samples

Content type
application/json
{
  • "error": "string"
}

Delete data resource

Delete data resource

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Data ID

type
required
string

Data type

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "type": "string"
}

Response samples

Content type
application/json
{
  • "error": "string"
}

Toolbox

Toolbox

Get the status of a job

Get the status of a job

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
requestId
required
integer

Job ID

Responses

Request samples

Content type
application/json
{
  • "requestId": 0
}

Response samples

Content type
application/json
{
  • "status": 0,
  • "result": "string",
  • "error": "string"
}

Coordinate Transformation

Transform coordinate

Transform coordinate

Transform coordinate

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Source data id

epsgCode
required
integer

EPSG code of the target coordinate system

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "epsgCode": 0,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Get coordinate list

Get coordinate list

Authorizations:
bearerHttpAuth
query Parameters
type
required
string
Enum: 1 2 3

Coordinate category

  • 1: Common Coordinate Systems
  • 2: Geographic Coordinate Systems
  • 3: Projected Coordinate Systems

Responses

Response samples

Content type
application/json
{ }

Join

Join data

Join data

Join data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
targetDataType
required
string
Enum: "SHP" "CSV"

Target data type

  • SHP: Spatial data
  • CSV: Attribute data
targetDataId
required
integer

Target data ID

targetJoinField
required
string

Target join field

targetOutputFields
string

Target output fields separated by comma

joinType
required
string
Enum: "INNER" "LEFT"

Join type

  • INNER: Target units with joined data (Inner Join)
  • LEFT: All target units (Left Join)
required
Array of objects

Join data list

outputType
required
string
Enum: "SHP" "CSV"

Output data type

  • SHP: Spatial data
  • CSV: Attribute data

Responses

Request samples

Content type
application/json
{
  • "targetDataType": "SHP",
  • "targetDataId": 0,
  • "targetJoinField": "string",
  • "targetOutputFields": "string",
  • "joinType": "INNER",
  • "joinDataList": [
    ],
  • "outputType": "SHP"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Field Calculation

Field Calculation

Field Calculation

Field Calculation

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataType
required
string
Enum: "SHP" "CSV"

Data type

  • SHP: Spatial data
  • CSV: Attribute data
dataId
required
integer

Data ID

calcType
required
string
Enum: "new" "update"

Calculation type

  • new: Create a new field
  • update: Update existing fields
updateType
required
string
Enum: "new" "update"

Update type

  • new: Create a new data resource
  • update: Update the existing data resource
fieldName
string

The new field name

fieldType
string
Enum: "numeric" "text"

The new field type

expression
string

The SQL expression to calculate the new field

expressions
Array of strings[ items ]

The SQL expressions to update existing fields

outputType
required
string
Enum: "SHP" "CSV"

Output data type

  • SHP: Spatial data
  • CSV: Attribute data
outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataType": "SHP",
  • "dataId": 0,
  • "calcType": "new",
  • "updateType": "new",
  • "fieldName": "string",
  • "fieldType": "numeric",
  • "expression": "string",
  • "expressions": [
    ],
  • "outputType": "SHP",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Filtering

Filter data

Filter data

Filter data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataType
required
string
Enum: "SHP" "CSV"

Data type

  • SHP: Spatial data
  • CSV: Attribute data
dataId
required
integer

Data ID

expression
required
string

SQL expression to filter the data

outputSelected
boolean

Whether to output the selected data. Default is true

outputUnselected
boolean

Whether to output the unselected data. Default is false

outputType
string
Enum: "SHP" "CSV"

Output data type

  • SHP: Spatial data
  • CSV: Attribute data
outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataType": "SHP",
  • "dataId": 0,
  • "expression": "string",
  • "outputSelected": true,
  • "outputUnselected": true,
  • "outputType": "SHP",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Clip

Clip data

Clip data

Clip data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
dataId
required
integer

ID of the data to be clipped

boundaryDataId
required
integer

Boundary data ID

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "boundaryDataId": 0,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Intersect

Intersect data

Intersect data

Intersect data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
dataId
required
integer

Data ID

boundaryDataId
required
integer

Boundary data ID

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "boundaryDataId": 0,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Select by Location

Select by location

Select by location

Select by location

Authorizations:
bearerHttpAuth
Request Body schema: application/json
dataId
required
integer

Data ID

boundaryDataId
required
integer

Boundary data ID

spatialRelation
required
string
Enum: "intersect" "contains" "containsCenter" "within" "centerWithin" "touches"

Spatial relation

outputSelected
boolean
Default: true

Output selected

outputUnselected
boolean
Default: false

Output unselected

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "boundaryDataId": 0,
  • "spatialRelation": "intersect",
  • "outputSelected": true,
  • "outputUnselected": false,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Select by Attribute

Select by attribute

Select by attribute

Select by attribute

Authorizations:
bearerHttpAuth
Request Body schema: application/json
dataType
required
string
Enum: "SHP" "CSV"

Data type

  • SHP: Spatial data
  • CSV: Attribute Data
dataId
required
integer

Data ID

targetField
required
string

Target field

selectingDataType
required
string

Selecting data type

selectingDataId
required
integer

Selecting data ID

selectingField
required
string

Selecting field

outputSelected
boolean
Default: true

Whether to output the selected data

outputUnselected
boolean
Default: false

Whether to output the unselected data

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataType": "SHP",
  • "dataId": 0,
  • "targetField": "string",
  • "selectingDataType": "string",
  • "selectingDataId": 0,
  • "selectingField": "string",
  • "outputSelected": true,
  • "outputUnselected": false,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Difference

Difference

Difference

Difference

Authorizations:
bearerHttpAuth
Request Body schema: application/json
targetDataId
required
integer

The id of the data to be used as the target

eraseDataId
required
integer

The id of the data to be used as the eraser

outputDataName
string

The name of the output data

Responses

Request samples

Content type
application/json
{
  • "targetDataId": 0,
  • "eraseDataId": 0,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Merge

Merge data

Merge data

Merge data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataType
required
string
Enum: "SHP" "CSV"

Data type

outputType
required
string
Enum: "SHP" "CSV"

Output data type

required
Array of objects

Merge data list

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataType": "SHP",
  • "outputType": "SHP",
  • "mergeDataList": [
    ],
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Split

Split data

Split data

Split data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataType
required
string
Enum: "SHP" "CSV"

Data type

  • SHP: Spatial data
  • CSV: Attribute data
dataId
required
integer

Data ID

splitType
required
string
Enum: "location" "attribute"

Split type

outputType
required
string
Enum: "SHP" "CSV"

Output data type

  • SHP: Spatial data
  • CSV: Attribute data
boundaryDataId
integer

Boundary data ID for splitting by location

splitField
string

The field name for splitting by attribute

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataType": "SHP",
  • "dataId": 0,
  • "splitType": "location",
  • "outputType": "SHP",
  • "boundaryDataId": 0,
  • "splitField": "string",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Centroid

Get centroid

Get centroid

Get centroid

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
pointType
required
string
Enum: "center" "centroid"

Point type

outputType
required
string
Enum: "SHP" "CSV"

Output data type

  • SHP: Spatial data
  • CSV: Attribute data
outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "pointType": "center",
  • "outputType": "SHP",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Dissolve

Dissolve data

Dissolve data

Dissolve data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Data ID

fieldName
required
string

The name of the field to dissolve

createMultiGeometry
required
boolean

Whether to create multi-geometry

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "fieldName": "string",
  • "createMultiGeometry": true,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Data Cleaning

Data cleaning

Data cleaning

Data cleaning

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataType
required
string
Enum: "SHP" "CSV"

Data type

  • SHP: Spatial data
  • CSV: Attribute data
dataId
required
integer

Data ID

updateType
required
string
Enum: "new" "update"

Update type

  • new: Create a new data resource
  • update: Update the existing data resource
removeDuplicates
required
boolean

Whether to remove duplicates

trimString
required
boolean

Whether to trim string

replaceNullNumber
required
boolean

Whether to replace null number with 0

replaceNullNumericFields
Array of strings

The list of numeric fields to replace null number

replaceNullString
required
boolean

Whether to replace null string with empty string

replaceNullStringFields
Array of strings

The list of string fields to replace null string

replaceString
required
boolean

Whether to replace string

replaceStringFields
Array of strings

The list of string fields to replace string

replaceStringValues
Array of strings[ items ]

The list of old string value and new string value pairs

changeColumnNameCase
required
boolean

Whether to change column name case

columnNameCaseType
string
Enum: "UPPER" "LOWER" "TITLE"

Column name case type

  • UPPER: UPPER CASE
  • LOWER: lower case
  • TITLE: Title Case
changeStringValueCase
required
boolean

Whether to change string value case

changeStringCaseFields
Array of strings

The list of string fields to change string value case

stringValueCaseType
string
Enum: "UPPER" "LOWER" "TITLE"

String value case type

  • UPPER: UPPER CASE
  • LOWER: lower case
  • TITLE: Title Case
outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataType": "SHP",
  • "dataId": 0,
  • "updateType": "new",
  • "removeDuplicates": true,
  • "trimString": true,
  • "replaceNullNumber": true,
  • "replaceNullNumericFields": [
    ],
  • "replaceNullString": true,
  • "replaceNullStringFields": [
    ],
  • "replaceString": true,
  • "replaceStringFields": [
    ],
  • "replaceStringValues": [
    ],
  • "changeColumnNameCase": true,
  • "columnNameCaseType": "UPPER",
  • "changeStringValueCase": true,
  • "changeStringCaseFields": [
    ],
  • "stringValueCaseType": "UPPER",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Spatial Join and Aggregation

Spatial Join and Aggregation

Spatial Join and Aggregation

Spatial Join and Aggregation

Authorizations:
bearerHttpAuth
Request Body schema: application/json
targetDataId
required
string

The id of the target data

joinDataType
required
string

The type of the join data

joinDataId
required
string

The id of the join data

aggregationType
required
string
Enum: "statistics" "count"

The type of the aggregation

  • statistics
  • count
locationFields
string

The longitude and latitude fields of the join data separated by a semicolon

spatialRelation
string
Enum: "intersect" "contains" "containsCenter" "within" "centerWithin" "touches"

The spatial relation between the target data and the join data

targetJoinField
string

The field of the target data to join

joinJoinField
string

The field of the join data to join

object

The aggregation methods for selected fields in the join data

countFields
string

The fields to count separated by a comma

dateField
string

The date field of the join data

dateFormat
string

The date format of the date field

startDate
string

The start date of the date range in the 'MM-dd-yyyy' format

endDate
string

The end date of the date range in the 'MM-dd-yyyy' format

outputRange
string
Enum: "ALL" "WITH_DATA"

The spatial range of the output data. Default is 'ALL'

outputDataName
string

The output data name

Responses

Request samples

Content type
application/json
{
  • "targetDataId": "string",
  • "joinDataType": "string",
  • "joinDataId": "string",
  • "aggregationType": "statistics",
  • "locationFields": "string",
  • "spatialRelation": "intersect",
  • "targetJoinField": "string",
  • "joinJoinField": "string",
  • "sAggFieldMethods": {
    },
  • "countFields": "string",
  • "dateField": "string",
  • "dateFormat": "string",
  • "startDate": "string",
  • "endDate": "string",
  • "outputRange": "ALL",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Attribute Aggregation

Attribute Aggregation

Attribute Aggregation

Attribute Aggregation

Authorizations:
bearerHttpAuth
Request Body schema: application/json
dataId
required
integer

Data ID

groupFieldNames
required
string

Group field names

required
object

Aggregate field methods

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "groupFieldNames": "string",
  • "sAggFieldMethods": {
    },
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Space-Time Aggregation

Space-Time Aggregation

Space-Time Aggregation

Space-Time Aggregation

Authorizations:
bearerHttpAuth
Request Body schema: application/json
targetDataId
required
string

The id of the target data

joinDataType
required
string

The type of the join data

joinDataId
required
string

The id of the join data

aggregationType
required
string
Enum: "statistics" "count"

The type of the aggregation

  • statistics
  • count
joinIdField
string

The field of the target data to be the join id with the output data

locationFields
string

The longitude and latitude fields of the join data separated by a semicolon

targetJoinField
string

The field of the target data to join

joinJoinField
string

The field of the join data to join

object

The aggregation methods for selected fields in the join data

countFields
string

The fields to count separated by a comma

dateField
string

The date field of the join data

dateFormat
string

The date format of the date field

timeTypes
Array of strings
Items Enum: "hour" "day" "week" "week_hour" "weekday_weekend" "weeks" "month" "quarter" "year" "year_month"

The date time categories of the output data based on the date field.

outputDataName
string

The output data name

Responses

Request samples

Content type
application/json
{
  • "targetDataId": "string",
  • "joinDataType": "string",
  • "joinDataId": "string",
  • "aggregationType": "statistics",
  • "joinIdField": "string",
  • "locationFields": "string",
  • "targetJoinField": "string",
  • "joinJoinField": "string",
  • "sAggFieldMethods": {
    },
  • "countFields": "string",
  • "dateField": "string",
  • "dateFormat": "string",
  • "timeTypes": [
    ],
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Time Aggregation

Time Aggregation

Time Aggregation

Time Aggregation

Authorizations:
bearerHttpAuth
Request Body schema: application/json
joinDataId
required
string

The id of the input attribute data

aggregationType
required
string
Enum: "statistics" "count"

The type of the aggregation

  • statistics
  • count
object

The aggregation methods for selected fields in the join data

countFields
string

The fields to count separated by a comma

joinIdField
string

The field to be the id field of the output data

dateField
string

The date field of the join data

dateFormat
string

The date format of the date field

timeTypes
Array of strings
Items Enum: "hour" "day" "week" "week_hour" "weekday_weekend" "weeks" "month" "quarter" "year" "year_month"

The date time categories of the output data based on the date field.

outputDataName
string

The output data name

Responses

Request samples

Content type
application/json
{
  • "joinDataId": "string",
  • "aggregationType": "statistics",
  • "sAggFieldMethods": {
    },
  • "countFields": "string",
  • "joinIdField": "string",
  • "dateField": "string",
  • "dateFormat": "string",
  • "timeTypes": [
    ],
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Flow Aggregation

Flow Aggregation

Flow Aggregation

Flow Aggregation

Authorizations:
bearerHttpAuth
Request Body schema: application/json
unitDataId
required
integer

Unit Data ID

unitFlowDataId
required
integer

Unit Flow Data ID

unitIdField
required
string

Unit ID Field

boundaryDataId
required
integer

Boundary Data ID

boundaryIdField
required
string

Boundary ID Field

outputDataName
string

Output Data Name

Responses

Request samples

Content type
application/json
{
  • "unitDataId": 0,
  • "unitFlowDataId": 0,
  • "unitIdField": "string",
  • "boundaryDataId": 0,
  • "boundaryIdField": "string",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Apportion

Apportion

Apportion

Apportion

Authorizations:
bearerHttpAuth
Request Body schema: application/json
inputDataId
required
integer

Data ID

apportionFields
required
string

Apportion fields of the input data

targetDataId
required
integer

Target data ID

ratioField
required
string

Ratio field of the target data

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "inputDataId": 0,
  • "apportionFields": "string",
  • "targetDataId": 0,
  • "ratioField": "string",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Transpose Fields

Transpose data fields

Transpose Fields

Transpose Fields

Authorizations:
bearerHttpAuth
Request Body schema: application/json
dataId
required
integer

Data ID

transposeFieldNames
required
Array of strings

Field names to transpose

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "transposeFieldNames": [
    ],
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Pivot Table

Pivot data fields

Pivot Table

Pivot Table

Authorizations:
bearerHttpAuth
Request Body schema: application/json
dataId
required
integer

Data ID

pivotNameField
required
string

Field name to pivot by

pivotValueField
required
string

Field name to pivot values

groupFieldNames
required
Array of strings

Field names to group by

aggregateMethods
required
Array of strings
Items Enum: "sum" "avg" "count" "min" "max" "stddev"

Aggregation methods

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "pivotNameField": "string",
  • "pivotValueField": "string",
  • "groupFieldNames": [
    ],
  • "aggregateMethods": [
    ],
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Accessibility

Accessibility

Accessibility

Accessibility

Authorizations:
bearerHttpAuth
Request Body schema: application/json
dataId
required
integer

Data ID

facilities
required
string

Facilities separated by semicolon. Each facility is a string of the form "dataId,weightField, dataWeight".

inverseDistancePower
required
number

Power of the inverse distance

influenceRadius
number

Influence radius

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "facilities": "string",
  • "inverseDistancePower": 0,
  • "influenceRadius": 0,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Site Allocation

Site Allocation

Submit a site allocation job

Submit a site allocation job

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required

Site Allocation

demandDataId
required
integer

Demand data ID

demandFieldName
required
string

Demand field name

existingFacilityDataId
integer

Existing facility data ID

candidateFacilityDataId
required
integer

Candidate facility data ID

facilityNum
required
integer

Facility number

cutoff
required
number

Cutoff in degree

competitorDataId
integer

Competitor facility data ID

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "demandDataId": 0,
  • "demandFieldName": "string",
  • "existingFacilityDataId": 0,
  • "candidateFacilityDataId": 0,
  • "facilityNum": 0,
  • "cutoff": 0,
  • "competitorDataId": 0,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Gridding

Grid data

Grid data

Grid data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Data ID

cellSideLength
required
number

Cell side length in kilometers

gridType
required
string
Enum: "square" "hexagon"

Grid type

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "cellSideLength": 0,
  • "gridType": "square",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Isodistance

Isodistance

Isodistance

Isodistance

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
inputType
required
string
Enum: "LonLat" "pointData"

The type of the input data

centers
string

The centers separated by semicolon. Each center is a string of the form "longitude,latitude,distance".

pointDataDistance
number

The distance of the point data

dataId
integer

The data ID of the point data

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "inputType": "LonLat",
  • "centers": "string",
  • "pointDataDistance": 0,
  • "dataId": 0,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Thiessen Polygon

Thiessen Polygon

Thiessen Polygon

Thiessen Polygon

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Data ID

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Interpolation

Interpolation

Interpolation

Interpolation

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Data ID

interpolationField
required
string

The field name to interpolate

cellSize
required
string

The cell size in kilometers

range
number

The range

sill
number

The sill

nugget
number

The nugget

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "interpolationField": "string",
  • "cellSize": "string",
  • "range": 0,
  • "sill": 0,
  • "nugget": 0,
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Entropy

Entropy

Entropy

Entropy

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataType
required
string
Enum: "SHP" "CSV"

Data type

  • SHP: Spatial data
  • CSV: Attribute data
dataId
required
integer

Data ID

calculationField
required
string

The field names to calculate the entropy separated by comma

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataType": "SHP",
  • "dataId": 0,
  • "calculationField": "string",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

GWR

Geographically Weighted Regression

Geographically Weighted Regression

Geographically Weighted Regression

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
regressionType
required
string
Enum: "gwr" "linear"

Regression type

  • gwr: Geographically Weighted Regression
  • linear: Linear Regression
dataId
required
integer

Data ID

depVar
required
string

Dependent variable

variables
required
string

Explanatory variables

outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "regressionType": "gwr",
  • "dataId": 0,
  • "depVar": "string",
  • "variables": "string",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Geocoding

Geocoding

Geocoding

Geocoding

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Data ID

geocodeField
required
string

The field name to geocode

outputType
required
string
Enum: "SHP" "CSV"

Output data type

  • SHP: Spatial data
  • CSV: Attribute data
outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "geocodeField": "string",
  • "outputType": "SHP",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Distance Matrix

Distance Matrix

Distance Matrix

Distance Matrix

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Data ID

sortField
required
string

Sort field

distanceType
required
string

Distance type

  • straight-line: Straight line distance
  • path: Path distance
outputDataName
string

Output data name

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "sortField": "string",
  • "distanceType": "string",
  • "outputDataName": "string"
}

Response samples

Content type
application/json
{
  • "requestId": 0,
  • "error": "string"
}

Workspace

Manage workspaces

Create workspace

Create workspace

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
name
required
string

Workspace name

accessType
string

Sharing scope of the workspace. Default is 'private'

service
string

Service type

required
Array of objects

Parameters for each layer in the workspace

showAttributeTable
boolean

Whether to show the attribute table

showFieldTable
boolean

Whether to show the field table

showPcp
boolean

Whether to show the parallel coordinate plot (PCP)

showLineChart
boolean

Whether to show the line chart

showRightPanel
boolean

Whether to show the right panel

rightPanelContent
string
Enum: "stMatrix" "lineChart"

Default right panel content

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "accessType": "string",
  • "service": "string",
  • "params": [
    ],
  • "showAttributeTable": true,
  • "showFieldTable": true,
  • "showPcp": true,
  • "showLineChart": true,
  • "showRightPanel": true,
  • "rightPanelContent": "stMatrix"
}

Response samples

Content type
application/json
{
  • "jobID": 0,
  • "workspaceKey": "string",
  • "error": "string"
}

Update workspace

Update workspace

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dashboardKey
required
string

Workspace key

oldDataId
integer

Old spatial data ID

newDataId
integer

New spatial data ID

oldCsvDataId
integer

Old attribute data ID

newCsvDataId
integer

New attribute data ID

keepUrl
boolean

Whether to keep the URL of the workspace. Default is false

Responses

Request samples

Content type
application/json
{
  • "dashboardKey": "string",
  • "oldDataId": 0,
  • "newDataId": 0,
  • "oldCsvDataId": 0,
  • "newCsvDataId": 0,
  • "keepUrl": true
}

Response samples

Content type
application/json
{
  • "jobID": 0,
  • "workspaceKey": "string",
  • "error": "string"
}

Get the status of a workspace job

Get the status of the job to create or update a workspace

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
jobID
required
integer

Job ID

workspaceKey
required
string

Workspace key

Responses

Request samples

Content type
application/json
{
  • "jobID": 0,
  • "workspaceKey": "string"
}

Response samples

Content type
application/json
{
  • "status": 111,
  • "result": "string",
  • "error": "string"
}

Get data list in a workspace

Get data list in a workspace

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
workspaceKey
required
string

Workspace key

Responses

Request samples

Content type
application/json
{
  • "workspaceKey": "string"
}

Response samples

Content type
application/json
{
  • "spatialData": [
    ],
  • "attributeData": [
    ],
  • "error": "string"
}

Regionalization (REDCAP)

Regionalization (REDCAP)

Set data

Set data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
serviceId
required
integer
Value: 6

Service ID

dataId
required
integer

Data ID

Responses

Request samples

Content type
application/json
{
  • "serviceId": 6,
  • "dataId": 0
}

Response samples

Content type
application/json
{
  • "numericFields": {
    },
  • "error": "string"
}

Submit regionalization

Submit regionalization

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Data ID

required
object

Variables

methodIdx
required
integer
Enum: 0 1 2 3 4

Regionalization method

  • 0: WARD
  • 1: Average Linkage
  • 2: Complete Linkage
  • 3: Single Linkage
  • 4: First-Order Single Linkage
regionNum
required
integer

Number of regions

object

Smoothing parameters

object

Control population

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "variables": {
    },
  • "methodIdx": 0,
  • "regionNum": 0,
  • "smooth": {
    },
  • "controlPop": {
    }
}

Response samples

Content type
application/json
{
  • "jobID": 0,
  • "error": "string"
}

Check the status of a regionalization job

Check the status of a regionalization job

Authorizations:
bearerHttpAuth
query Parameters
jobId
required
any

The job ID

Responses

Response samples

Content type
application/json
{
  • "status": "string",
  • "progress": "string",
  • "resultUrl": "string",
  • "link": "string",
  • "embedCode": "string",
  • "error": "string"
}

Space-Time Patterns (VIS-STAMP)

Space-Time Patterns (VIS-STAMP)

Set data

Set data

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
dataId
required
integer

Unit data ID

csvId
required
integer

Space-time attribute data ID

Responses

Request samples

Content type
application/json
{
  • "dataId": 0,
  • "csvId": 0
}

Response samples

Content type
application/json
{
  • "csvContextId": 0,
  • "featureIdField": "string",
  • "unitFields": [ ],
  • "numericFields": {
    },
  • "error": "string"
}

Set feature ID field

Set feature ID field

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
csvContextId
required
integer

Context ID

featureIdField
required
string

Field name of the feature ID to join the space-time attribute data

Responses

Request samples

Content type
application/json
{
  • "csvContextId": 0,
  • "featureIdField": "string"
}

Response samples

Content type
application/json
{
  • "success": "string",
  • "error": "string"
}

Run VIS-STAMP

Run VIS-STAMP

Authorizations:
bearerHttpAuth
Request Body schema: application/json
required
csvContextId
required
integer

Context ID

somSize
required
integer

The size of the SOM

required
object

Variables for classification

Responses

Request samples

Content type
application/json
{
  • "csvContextId": 0,
  • "somSize": 0,
  • "variables": {
    }
}

Response samples

Content type
application/json
{
  • "jobID": 0,
  • "error": "string"
}

Get the status of a VISSTAMP job

Get the status of a VISSTAMP classification job

Authorizations:
bearerHttpAuth
query Parameters
jobId
required
any

The job ID

Responses

Response samples

Content type
application/json
{
  • "status": "string",
  • "result": { },
  • "link": "string",
  • "embedCode": "string",
  • "error": "string"
}