<density_uri>/{jobID}[.<format>]
densityJob 资源表示一个密度分析作业。通过对 densityJob 资源执行 GET 请求,可以查看密度分析作业的详细配置信息,如分析范围、源数据地址等。densityJob 资源可以通过 ID 号({jobID}) 来获取。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/spatialanalyst/density/{jobID}.rjson
获取一个核密度分析作业信息。
对 densityJob 资源执行 GET 请求,返回操作结果的结构如下:
字段 | 类型 | 说明 |
id | String | 应用ID。 |
state | SparkJobState | 该任务的状态。包括执行状态、起止时间、耗时等。 |
setting | SparkJobSetting | 列举当前密度分析任务详细信息。 |
对 densityJob 资源http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/spatialanalyst/density/2d47e0bf_3629_4810_93cb_dc1c68630d08.rjson执行 GET 请求,则返回的rjson表述结果如下:
{
"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
}
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 densityJob 资源是否存在,或者客户端是否有权限访问 densityJob 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 densityJob 资源是否支持<format>格式的表述。