buildRasterPyramid

URI

<dataprocessingJobs_uri>/buildrasterpyramid[.<format>]

支持的方法

GET、POST、HEAD

父资源

dataProcessingJobs

子资源

buildRasterPyramidJob

介绍

创建拷贝栅格数据资源根目录。通过对 buildRasterPyramid 执行GET 请求，可获取当前的创建拷贝栅格数据作业列表。通过 POST 请求可创建一个分析任务

支持的方法：

支持的表述格式：RJSON、JSON、HTML、JSONP、XML。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/dataprocessing/buildRasterPyramid.rjson

GET 请求

获取创建拷贝栅格数据作业列表。

响应结构

对 buildRasterPyramid 资源执行 GET 请求，在响应消息的实体主体里是一个创建栅格金字塔资源描述集，其中单个资源描述的结构如下：

字段 类型 说明
id String 应用ID。
state SparkJobState 该任务的状态。包括执行状态、起止时间、耗时等。
setting SparkJobSetting 列举了任务配置的详细信息。

响应示例

对 buildRasterPyramid 资源执行 GET 请求，返回 rjson 格式的资源描述如下：

[

    {

        "id": "546589b9_0be2_4873_bb93_fd5a15a40469",

        "state": {

            "errorStackTrace": null,

            "endState": true,

            "startTime": 1552550007105,

            "endTime": 1552550030307,

            "publisherelapsedTime": 0,

            "runState": "FINISHED",

            "errorMsg": null,

            "elapsedTime": 22562

        },

        "setting": {

            "output": {

                "resultEpsgCode": 3857,

                "outputPath": null,

                "datasourcePath": "F:\\01_package\\20190313\\result",

                "datasetName": "analystResult",

                "type": "FILESYSTEM"

            },

            "args": null,

            "input": {

                "datasetName": "DEM_ASTGTM2_N41E075_dem",

                "numSlices": 0,

                "specField": null,

                "datasetInfo": {

                    "available": true,

                    "name": "DEM_ASTGTM2_N41E075_dem",

                    "type": "TIF",

                    "url": "F:\\01_package\\20190311\\DEM\\ASTGTM2_N41E075_dem.tif"

                }

            },

            "DEFAULT_MASTER_ADRESS": "local[*] ",

            "referToken": "ZDnHe2rGeLVuQj6O1tbKrVUEDtej4OpGz9NQiRxgq0y4aI6_9aQNM7IkTBPwzfShG9hitALlMVTi0xwNI69SnA..",

            "mainClass": null,

            "sparkLogFile": null,

            "appName": null,

            "contextSetting": null,

            "serviceInfo": {

                "targetDataPath": null,

                "targetServiceInfos": null

            },

            "referServicesAddress": "http://supermapiserver:8090/iserver"

        }

    }

]

POST 请求

创建一个创建拷贝栅格数据任务

请求参数

对 buildRasterPyramid 资源执行 POST 请求，创建一个创建拷贝栅格数据任务，请求体需包含参数如下：

名称 类型 含义

input

【必填参数】

 DatasetInputDataSetting

数据集输入设置，输入数据是一个已注册的本地目录或HDFS目录时，用该设置。其中包含如下字段

  • datasetName：源数据集名称。数据集名称不可带有中文。【必填参数】

数据集信息输入设置，当数据来源为本地存储的文件或HDFS存储的文件时，用该设置。其中包含如下字段

  • datasetInfo：源数据集名称。

  • type：数据集类型。仅支持TIF。【必填参数】

  • url：源数据所在路径。可以是一个具体的TIF文件地址，也可以是一个目录。若是具体TIF文件路径时，则该数据集名称不可含有中文；若是TIF目录为路径时，则该目录不可含有中文【必填参数】

output

【必填参数】

 FileSystemOutputSetting

分析结果输出设置。当输出结果到本地存储时。用该设置。其中包含如下字段

  • type：目标数据库类型。【必填参数】

  • datasourcePath ：目标文件系统地址。其中分析结果可以存放到本地存储。【必填参数】

  • resultEpsgCode：目标EPSGCODE。默认值为：3857。【选填参数】
DatabaseOutputSetting

分析结果输出设置。当输出结果到HDFS存储时。用该设置。其中包含如下字段【必填参数】

  • type：目标数据库类型。【必填参数】

  • datasourceInfo：结果数据源的连接信息。【必填参数】详细参数设定请参考：大数据分析输出参数设定。

  • resultEpsgCode：目标EPSGCODE。默认值为：3857。【选填参数】

示例1：输入本地数据集信息输出到HDFS存储库

对示例 buildRasterPyramid 资源：http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/dataprocessing/buildRasterPyramid.json 目标结果输出到HDFS存储库。执行POST 请求，创建一个创建拷贝栅格数据任务。请求体中的参数如下：

{

    "input": {

        "datasetInfo": {

            "type": "TIF",

            "url": "F:\\data\\B49C001002.tif"

        }

    },

    "output": {

        "type": "GEOTRELLISHDFS",

        "datasourceInfo": {

            "server": "hdfs://192.168.112.131:9000/test/wangyd/iserver011",

            "engineType": "GEOTRELLISHDFS"

        },

        "resultEpsgCode": "3857"

    }

}

返回 rjson 格式的操作结果表述如下：

{

    "postResultType": "CreateChild",

    "newResourceID": "d4886a88_fb4c_4ada_b2a1_42edf39f97eb",

    "succeed": true,

    "newResourceLocation": "http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/dataprocessing/buildRasterPyramid/d4886a88_fb4c_4ada_b2a1_42edf39f97eb"

}

示例2：输入HDFS数据集信息结果输出到本地存储

对示例 buildRasterPyramid 资源：http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/dataprocessing/buildRasterPyramid.json 目标结果输出到本地存储。执行POST 请求，创建一个创建拷贝栅格数据任务。请求体中的参数如下：

{

    "input": {

        "datasetInfo": {

            "type": "TIF",

            "url": "hdfs://192.168.112.131:9000/test/TIF/B49C001001.tif"

        }

    },

    "output": {

        "type": "FILESYSTEM",

        "datasourcePath": "F:\\02_Data\\result",

        "resultEpsgCode": "3857"

    }

}

返回 rjson 格式的操作结果表述如下：

{

    "postResultType": "CreateChild",

    "newResourceID": "07e78789_e625_4e97_a8da_5f9765078389",

    "succeed": true,

    "newResourceLocation": "http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/dataprocessing/buildRasterPyramid/07e78789_e625_4e97_a8da_5f9765078389"

}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 buildRasterPyramid 资源是否存在，或者客户端是否有权限访问 buildRasterPyramid 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 buildRasterPyramid 资源是否支持<format>格式的表述。

请参见