Spatial REST API

仮想モザイクのリスト

get

{server}/georaster/v1/{datasource}/vm

すべての仮想モザイクをリストします。

リクエスト

この操作のリクエスト・パラメータはありません。

この操作にはリクエスト本文はありません。

トップに戻る

レスポンス

サポートされるメディア・タイプ

application/json

200レスポンス

仮想モザイクのリストを返します。

ルート・スキーマ: VMListResponse

型: object

ソースの表示

count: integer
hasMore: boolean
items: array items
limit: integer
links: array links

自己、rasterImage、rasterDataへのリンク
offset: integer

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/VMObjectResponse"
            }
        },
        "hasMore":{
            "type":"boolean"
        },
        "limit":{
            "type":"integer"
        },
        "offset":{
            "type":"integer"
        },
        "count":{
            "type":"integer"
        },
        "links":{
            "type":"array",
            "description":"link to self, rasterImage, rasterData",
            "items":{
                "$ref":"#/components/schemas/instanceLink"
            }
        }
    }
}

ネストされたスキーマ: items

型: array

ソースの表示

配列: object VMObjectResponse

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/VMObjectResponse"
    }
}

ネストされたスキーマ: links

型: array

自己、rasterImage、rasterDataへのリンク

ソースの表示

配列: string

{
    "type":"array",
    "description":"link to self, rasterImage, rasterData",
    "items":{
        "$ref":"#/components/schemas/instanceLink"
    }
}

ネストされたスキーマ: VMObjectResponse

型: object

ソースの表示

dimensionSize: array sdo_number_array
links: array links

自己、rasterImage、rasterDataへのリンク
maxNumberOfBands: integer
name: string
pyramidMaxLevel: integer
spatialExtent: object sdo_geometry
vmDefinition: object VMObject

仮想モザイク関連パラメータ。pyramidlevel、bandNumber、cropAreaはリクエストで指定されるため、ここには含まれていません。

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "vmDefinition":{
            "$ref":"#/components/schemas/VMObject"
        },
        "pyramidMaxLevel":{
            "type":"integer"
        },
        "maxNumberOfBands":{
            "type":"integer"
        },
        "dimensionSize":{
            "$ref":"#/components/schemas/sdo_number_array"
        },
        "spatialExtent":{
            "$ref":"#/components/schemas/sdo_geometry",
            "nullable":true
        },
        "links":{
            "type":"array",
            "description":"link to self, rasterImage, rasterData",
            "items":{
                "$ref":"#/components/schemas/instanceLink"
            }
        }
    }
}

ネストされたスキーマ: sdo_number_array

型: array

ソースの表示

配列: number

{
    "type":"array",
    "items":{
        "type":"number"
    }
}

ネストされたスキーマ: links

型: array

自己、rasterImage、rasterDataへのリンク

ソースの表示

配列: string

{
    "type":"array",
    "description":"link to self, rasterImage, rasterData",
    "items":{
        "$ref":"#/components/schemas/instanceLink"
    }
}

ネストされたスキーマ: sdo_geometry

型: object

ソースの表示

attr: string

{
    "type":"object",
    "properties":{
        "attr":{
            "type":"string"
        }
    }
}

ネストされたスキーマ: VMObject

型: object

仮想モザイク関連パラメータ。pyramidlevel、bandNumber、cropAreaはリクエストで指定されるため、ここには含まれていません。

ソースの表示

bgValues: array sdo_number_array
colorBalance: object colorBalance
commonPointRule: string

許容値: [ "start", "end", "latest", "oldest", "ctc", "high", "low", "average", "highres" ]
elevationParam: string
fillGap: boolean

デフォルト値: false
nodata: boolean

デフォルト値: false
outModelCoordLoc: string

デフォルト値: center

許容値: [ "center", "upperleft" ]
outResolutions: object outResolutions
outSRID: integer
referencePoint: object sdo_geometry
resamplingMethod: string
resamplingTolerance: number

最小値: 0

最大値: 0.5
sourceImages(required): object sourceImages

{
    "type":"object",
    "description":"virtual mosaic related parameters. pyramidlevel, bandNumber, cropArea not included here as it will be specified at the request.",
    "required":[
        "sourceImages"
    ],
    "properties":{
        "sourceImages":{
            "type":"object",
            "required":[
                "tableNames",
                "columnNames"
            ],
            "properties":{
                "tableNames":{
                    "type":"array",
                    "items":{
                        "type":"string"
                    }
                },
                "columnNames":{
                    "type":"array",
                    "items":{
                        "type":"string"
                    }
                },
                "conditions":{
                    "type":"array",
                    "items":{
                        "type":"string"
                    }
                }
            }
        },
        "outSRID":{
            "type":"integer"
        },
        "elevationParam":{
            "type":"string"
        },
        "outModelCoordLoc":{
            "type":"string",
            "enum":[
                "center",
                "upperleft"
            ],
            "default":"center"
        },
        "outResolutions":{
            "type":"object",
            "required":[
                "value"
            ],
            "properties":{
                "value":{
                    "$ref":"#/components/schemas/sdo_number_array"
                },
                "unit":{
                    "type":"string"
                }
            }
        },
        "referencePoint":{
            "$ref":"#/components/schemas/sdo_geometry"
        },
        "resamplingMethod":{
            "type":"string"
        },
        "resamplingTolerance":{
            "type":"number",
            "minimum":0,
            "maximum":0.5
        },
        "commonPointRule":{
            "type":"string",
            "enum":[
                "start",
                "end",
                "latest",
                "oldest",
                "ctc",
                "high",
                "low",
                "average",
                "highres"
            ]
        },
        "nodata":{
            "type":"boolean",
            "default":false
        },
        "fillGap":{
            "type":"boolean",
            "default":false
        },
        "colorBalance":{
            "type":"object",
            "required":[
                "balanceMethod"
            ],
            "properties":{
                "balanceMethod":{
                    "type":"string",
                    "enum":[
                        "none",
                        "linearstretching",
                        "statisticdmatching",
                        "histogrammatching"
                    ],
                    "default":"none"
                },
                "referenceMethod":{
                    "type":"string",
                    "enum":[
                        "value",
                        "image",
                        "overlap"
                    ]
                },
                "reference":{
                    "oneOf":[
                        {
                            "$ref":"#/components/schemas/sdo_georaster"
                        },
                        {
                            "type":"object",
                            "properties":{
                                "values1":{
                                    "$ref":"#/components/schemas/sdo_number_array"
                                },
                                "values2":{
                                    "$ref":"#/components/schemas/sdo_number_array"
                                }
                            }
                        },
                        {
                            "$ref":"#/components/schemas/sdo_geor_histogram"
                        }
                    ]
                }
            }
        },
        "bgValues":{
            "$ref":"#/components/schemas/sdo_number_array"
        }
    }
}

ネストされたスキーマ: colorBalance

型: object

ソースの表示

balanceMethod(required): string

デフォルト値: none

許容値: [ "none", "linearstretching", "statisticdmatching", "histogrammatching" ]
reference: reference
referenceMethod: string

許容値: [ "value", "image", "overlap" ]

{
    "type":"object",
    "required":[
        "balanceMethod"
    ],
    "properties":{
        "balanceMethod":{
            "type":"string",
            "enum":[
                "none",
                "linearstretching",
                "statisticdmatching",
                "histogrammatching"
            ],
            "default":"none"
        },
        "referenceMethod":{
            "type":"string",
            "enum":[
                "value",
                "image",
                "overlap"
            ]
        },
        "reference":{
            "oneOf":[
                {
                    "$ref":"#/components/schemas/sdo_georaster"
                },
                {
                    "type":"object",
                    "properties":{
                        "values1":{
                            "$ref":"#/components/schemas/sdo_number_array"
                        },
                        "values2":{
                            "$ref":"#/components/schemas/sdo_number_array"
                        }
                    }
                },
                {
                    "$ref":"#/components/schemas/sdo_geor_histogram"
                }
            ]
        }
    }
}

ネストされたスキーマ: outResolutions

型: object

ソースの表示

unit: string
value(required): array sdo_number_array

{
    "type":"object",
    "required":[
        "value"
    ],
    "properties":{
        "value":{
            "$ref":"#/components/schemas/sdo_number_array"
        },
        "unit":{
            "type":"string"
        }
    }
}

ネストされたスキーマ: sourceImages

型: object

ソースの表示

columnNames(required): array columnNames
conditions: array conditions
tableNames(required): array tableNames

{
    "type":"object",
    "required":[
        "tableNames",
        "columnNames"
    ],
    "properties":{
        "tableNames":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "columnNames":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "conditions":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    }
}

ネストされたスキーマ: reference

1つのスキーマに一致

ソースの表示

object sdo_georaster
object reference-oneOf[1]
object sdo_geor_histogram

{
    "oneOf":[
        {
            "$ref":"#/components/schemas/sdo_georaster"
        },
        {
            "type":"object",
            "properties":{
                "values1":{
                    "$ref":"#/components/schemas/sdo_number_array"
                },
                "values2":{
                    "$ref":"#/components/schemas/sdo_number_array"
                }
            }
        },
        {
            "$ref":"#/components/schemas/sdo_geor_histogram"
        }
    ]
}

ネストされたスキーマ: sdo_georaster

型: object

ソースの表示

rasterDataTable: string
rasterID: integer

{
    "type":"object",
    "properties":{
        "rasterDataTable":{
            "type":"string"
        },
        "rasterID":{
            "type":"integer"
        }
    }
}

ネストされたスキーマ: reference-oneOf[1]

型: object

ソースの表示

values1: array sdo_number_array
values2: array sdo_number_array

{
    "type":"object",
    "properties":{
        "values1":{
            "$ref":"#/components/schemas/sdo_number_array"
        },
        "values2":{
            "$ref":"#/components/schemas/sdo_number_array"
        }
    }
}

ネストされたスキーマ: sdo_geor_histogram

型: object

ソースの表示

cellvalue: array sdo_number_array
count: array sdo_number_array

{
    "type":"object",
    "properties":{
        "cellvalue":{
            "$ref":"#/components/schemas/sdo_number_array"
        },
        "count":{
            "$ref":"#/components/schemas/sdo_number_array"
        }
    }
}

ネストされたスキーマ: columnNames

型: array

ソースの表示

配列: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: conditions

型: array

ソースの表示

配列: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ: tableNames

型: array

ソースの表示

配列: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

トップに戻る

例

次の例は、cURLによってGETリクエストを発行して、使用可能な仮想モザイクをリストする方法を示しています。

curl -X GET "https://localhost:8080/oraclespatial/georaster/v1/datasource1/vm" -H "Cookie: JSESSIONID=<jsessionid_value>"

次に、前述のリクエストに対するJSON形式のレスポンスの例を示します。

{
   "items" : [ {
     "name" : "landsatMosaic",
     "vmDefinition" : {
       "sourceImages" : {
         "tableNames" : [ "landsat" ],
         "columnNames" : [ "image" ],
         "conditions" : null
       },
       "outSRID" : 4326,
       "outResolutions" : [ 30.0, 30.0 ],
       "resolutionUnit" : "meter",
       "resamplingMethod" : "bilinear",
       "resamplingTolerance" : 0.2,
       "commonPointRule" : "high"
     },
     "pyramidMaxLevel" : 7,
     "maxNumberOfBand" : 3,
     "cellDepth" : "8BIT_U",
     "dimensionSize" : [ 111498, 186723 ],
     "spatialExtent" : {
       "srid" : 4326,
       "polygon" : {
         "boundary" : [ {
           "rectangle" : {
             "datapoints" : [ [ -130.10368, 22.6478 ], [ -64.168344, 52.7826807 ] ]
           }
         } ]
       }
     },
     "links" : [ {
       "rel" : "self",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm/landsatMosaic"
     }, {
       "rel" : "rasterImage",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm/landsatMosaic/rasterImage"
     }, {
       "rel" : "rasterData",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm/landsatMosaic/rasterData"
     }, {
       "rel" : "statistics",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm/landsatMosaic/statistics"
     }, {
       "rel" : "parent",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm"
     } ]
   }, {
     "name" : "railway",
     "vmDefinition" : {
       "sourceImages" : {
         "tableNames" : [ "railway_1", "railway_2" ],
         "columnNames" : [ "raster", "raster" ]
       },
       "outSRID" : 3078,
       "outResolutions" : [ 0.03190937, 0.03205382 ],
       "resolutionUnit" : "degree",
       "commonPointRule" : "high",
       "nodata" : false,
       "fillgap" : true,
       "resFilter" : true,
       "bgValues" : [ 100.0, 100.0, 100.0 ]
     },
     "pyramidMaxLevel" : 15,
     "maxNumberOfBand" : 3,
     "cellDepth" : "8BIT_U",
     "dimensionSize" : [ 10367826, 1930012 ],
     "spatialExtent" : {
       "srid" : 3078,
       "polygon" : {
         "boundary" : [ {
           "rectangle" : {
             "datapoints" : [ [ 78717.2701, -910680.42 ], [ 140302.73, -578352.01 ] ]
           }
         } ]
       }
     },
     "links" : [ {
       "rel" : "self",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm/railway"
     }, {
       "rel" : "rasterImage",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm/railway/rasterImage"
     }, {
       "rel" : "rasterData",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm/railway/rasterData"
     }, {
       "rel" : "statistics",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm/railway/statistics"
     }, {
       "rel" : "parent",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm"
     } ]
   } ],
   "hasMore" : false,
   "totalResults" : 2,
   "links" : [ {
     "rel" : "canonical",
     "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm"
   }, {
     "rel" : "self",
     "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/vm"
   } ]
  }

トップに戻る