ジャンプ先

• リクエスト
• レスポンス
• 例

仮想モザイクの定義の取得

get

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

仮想モザイク名を指定して、仮想モザイクの定義を取得します。

リクエスト

パス・パラメータ

• virtualMosaicName(required): string
  仮想モザイクの名前

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

トップに戻る

レスポンス

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

• application/json

200レスポンス

リクエストされた仮想モザイクの情報を返します

本文()

ルート・スキーマ: VMObjectResponse

型: object

ソースの表示

• dimensionSize: array sdo_number_array
• links: array links
  自己、rasterImage、rasterDataへのリンク
• maxNumberOfBands: integer
• name: string
• pyramidMaxLevel: integer
• spatialExtent: object sdo_geometry
• vmDefinition: object schema
  仮想モザイク関連パラメータ。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"
        }
    }
}

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

型: 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 type
• 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"
        }
    }
}

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

型: 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"
    }
}

401レスポンス

認証情報がないか無効です

ヘッダー

• WWW_Authenticate(required):

トップに戻る

例

次の例は、cURLによってGETリクエストを発行して、"landsatMosaic"という名前のモザイクの定義をリクエストする方法を示しています。

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

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

{
     "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"
     } ]
 } 

トップに戻る