- URL:
- https://<geoanalytics-url>/CreateSpaceTimeCube
- Methods:
GET
- Version Introduced:
- 10.5
Description
The Create
operation works with a layer of point features that are time enabled. It aggregates the data into a 3D cube of space-time bins. When determining the point in a space-time bin relationship, statistics about all points in the space-time bins are calculated and assigned to the bins. The most basic statistic is the number of points in the bins, but you can calculate other statistics as well.
For example, suppose you have point feature of crimes in a city, and you want to summarize the number of crimes in both space and time. You can calculate the space-time cube for the dataset, and use the cube to further analyze trends such as emerging hot and cold spots.
Request parameters
Parameter | Details |
---|---|
| The point features that will be aggregated into the bins specified in geographical size by the Syntax: As described in Feature input, this parameter can be one of the following:
REST examples
|
| The distance for the bins into which the REST examples
|
| The distance unit for the bins into which the Values: REST examples
|
| A numeric value that specifies the duration of the time bin. REST examples
|
| The duration unit of the time bin. Values: REST examples
|
| Defines how aggregation will occur based on a given
REST examples
|
| A date that specifies the reference time to align the time bins to if REST examples
|
| A list of field names, statistical summary types, and the fill option for empty values that will be calculated for all points in each space-time bin. The count of points in each bin is always returned. By default, all statistics are returned.
REST examples
|
| Defines the name of the space-time cube (netCDF) created by the operation. REST examples
|
|
The
Syntax:
|
|
The response format. The default response format is Values: |
Example usage
The example below is a sample request URL for Create
:
https://webadaptor.domain.com/server/rest/services/System/GeoAnalyticsTools/GPServer/CreateSpaceTimeCube/submitJob?pointLayer={"url":"https://webadaptor.domain.com/server/rest/services/Hurricane/hurricaneTrack/0"}&binSize=100&binSizeUnit=Meters&timeStepInterval=20&timeStepIntervalUnit=Minutes&timeStepAlignment=StartTime&summaryFields=[{"statisticType": "Mean", "onStatisticField": "Annual_Sales"},{"statisticType": "Sum", "onStatisticField": "Annual_Sales"}]&outputName=myOutput&context={"extent":{"xmin":-122.68,"ymin":45.53,"xmax":-122.45,"ymax":45.6,"spatialReference":{"wkid":4326}}}&f=json
Response
When you submit a request, the service assigns a unique job ID for the transaction.
Syntax:
{
"jobId": "<unique job identifier>",
"jobStatus": "<job status>"
}
After the initial request is submitted, you can use job
to periodically check the status of the job and messages as described in Check job status. Once the job has successfully completed, use job
to retrieve the results. To track the status, you can make a request of the following form:
https://<analysis url>/CreateSpaceTimeCube/jobs/<jobId>
Access results
When the status of the job request is esri
, you can access the results of the analysis by making a request of the following form:
https://<analysis-url>/CreateSpaceTimeCube/jobs/<jobId>/results/outputCube?token=<your token>&f=json
Response | Description |
---|---|
|
If the
The result has properties for parameter name, data type, and value. The contents of
When you browse to the output URL, the netCDF cube will automatically download to your local machine. |