densityJob


URI

<density_uri>/{jobID}[.<format>]

Supported methods

GET, HEAD

Parent resource

density

Introduction

densityJob indicates a denisty analysis job. Check the detail configuration information of denisty analysis job through sending GET request to denistyJob, such as: analysis range, address of source data, and so on. The densityJob resource can be got by ID {jobID}.

Supported Methods:

Supported output formats: rjson, json, html, xml.

Resource hierarchy

 

HTTP request methods

Implement the HTTP request on the following URI, where supermapiserver is the server name, with rjson being the output format.

http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/spatialanalyst/density/{jobID}.rjson

GET request

Gets information of a denisty analysis job.

Response structure

Execute a GET request on the densityJob resource. The representation structure for the returned resource is like this:

Field Type Description
id String Application ID.
state Jobstate The status of the task. Including execution status, start time, time consuming, and so on.
setting JobSetting Lists the detail information of current density analysis task.

Response example

Sending GET request to densityJob resource http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/spatialanalyst/density/2d47e0bf_3629_4810_93cb_dc1c68630d08.rjson, the description for the returned rjson is:

{

  "id": "2d47e0bf_3629_4810_93cb_dc1c68630d08",

  "setting": {

    "DEFAULT_MASTER_ADRESS": "local[*] ",

    "analyst": {

      "fields": "",

      "meshType": "0",

      "method": "0",

      "query": "",

      "radius": "0.01",

      "resolution": "1000"

    },

    "appName": "kernelDensity",

    "args": [

      "--input",

      "file:/E:/spark/newyork_taxi_2013_01_14k_new.csv",

      "--separator",

      ",",

      "--pointIndex",

      "10",

      "--resolution",

      "1000",

      "--radius",

      "0.01",

      "--method",

      "0",

      "--meshType",

      "0",

      "--output",

      "E:\\supermapiserver\\supermap_iserver_*_win64_deploy\\webapps\\iserver\\processingResultData\\KernelDensity\\udbs\\ada2f56f-9c71-476d-8bb6-9056c4d73dbc",

      "--datasetName",

      "analystResult"

    ],

    "contextSetting": null,

    "input": {

      "datasetInfo": {

        "name": "dcsv_newyork_taxi_2013_01_14k_new",

        "separator": ",",

        "type": "CSV",

        "url": "E:\\spark\\newyork_taxi_2013_01_14k_new.csv",

        "xIndex": 10,

        "yIndex": 11

      },

      "datasetName": "dcsv_newyork_taxi_2013_01_14k_new"

    },

    "mainClass": "com.supermap.bsp.main.DensityAnalystMain",

    "output": {

      "cacheName": null,

      "cacheType": null,

      "datasetName": "analystResult",

      "outputPath": "E:\\supermap_iserver_900_14910_2648_win64_deploy\\supermap_iserver_900_14910_2648_win64_deploy\\webapps\\iserver\\processingResultData\\KernelDensity\\udbs\\ada2f56f-9c71-476d-8bb6-9056c4d73dbc"

    },

    "serviceInfo": null,

    "serviceRoot": "http://localhost:8090/iserver/services/"

  },

  "state": {

    "elapsedTime": 0,

    "endState": false,

    "endTime": 0,

    "errorMsg": null,

    "errorStackTrace": null,

    "publisherelapsedTime": 0,

    "runState": "RUNNING",

    "startTime": 1494832059228

  }

}

HEAD request

Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.

HEAD request can be used to check if the densityJob resource exists, or if the densityJob resource can be accessed by clients. It can also determine if the densityJob resource supports an output format <format> if performed on a URI with <format> included.

See