ジャンプ先

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

RAWデータ形式での仮想モザイク・データの取得

post

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

指定された仮想モザイクのサブセットをマルチパート・データ形式で取得します。

リクエスト

パス・パラメータ

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

問合せパラメータ

• format: string
  ラスター・データの形式。BASE64、RAWのいずれかの値。

  許容値: [ "BASE64", "RAW" ]

  例:

  RAW

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

• application/json

リクエスト本文 - application/json ()

仮想モザイク・サブセット・パラメータ

ルート・スキーマ: schema

型: object

仮想モザイク取得パラメータ。一部のパラメータは、仮想モザイク定義の一部でもあります。これらのパラメータを指定すると、仮想モザイク定義で指定されたパラメータが上書きされます。

ソースの表示

• bandNumbers: string
• bgValues: array sdo_number_array
• colorBalance: object colorBalance
• commonPointRule: string
  許容値: [ "start", "end", "latest", "oldest", "ctc", "high", "low", "average", "highres" ]
• considerNodata: boolean
  デフォルト値: false
• cropArea: cropArea
• fillGap: boolean
  デフォルト値: false
• memoryParam: object memoryParam
  メモリー使用量パラメータ
• pyramidLevel: integer
• resamplingMethod: string
• resamplingTolerance: number
  最小値: 0

  最大値: 0.5
• resFilter: boolean
  デフォルト値: false

{
    "type":"object",
    "description":"virtual mosaic retrieval parameter. Some parameters are part of the virtual mosaic definition too. If these parameters are specified, they will overwrite the parameters specified at virutal mosaic definition.",
    "properties":{
        "pyramidLevel":{
            "type":"integer"
        },
        "bandNumbers":{
            "type":"string"
        },
        "cropArea":{
            "oneOf":[
                {
                    "$ref":"#/components/schemas/sdo_number_array"
                },
                {
                    "$ref":"#/components/schemas/sdo_geometry"
                }
            ],
            "nullable":true
        },
        "resamplingMethod":{
            "type":"string"
        },
        "resamplingTolerance":{
            "type":"number",
            "minimum":0,
            "maximum":0.5
        },
        "commonPointRule":{
            "type":"string",
            "enum":[
                "start",
                "end",
                "latest",
                "oldest",
                "ctc",
                "high",
                "low",
                "average",
                "highres"
            ]
        },
        "considerNodata":{
            "type":"boolean",
            "default":false
        },
        "fillGap":{
            "type":"boolean",
            "default":false
        },
        "resFilter":{
            "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":{
                                "value1":{
                                    "$ref":"#/components/schemas/sdo_number_array"
                                },
                                "value2":{
                                    "$ref":"#/components/schemas/sdo_number_array"
                                }
                            }
                        },
                        {
                            "$ref":"#/components/schemas/sdo_geor_histogram"
                        }
                    ]
                }
            }
        },
        "bgValues":{
            "$ref":"#/components/schemas/sdo_number_array"
        },
        "memoryParam":{
            "$ref":"#/components/schemas/memoryParam"
        }
    }
}

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

型: array

ソースの表示

• 配列: number

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

ネストされたスキーマ: 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":{
                        "value1":{
                            "$ref":"#/components/schemas/sdo_number_array"
                        },
                        "value2":{
                            "$ref":"#/components/schemas/sdo_number_array"
                        }
                    }
                },
                {
                    "$ref":"#/components/schemas/sdo_geor_histogram"
                }
            ]
        }
    }
}

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

1つのスキーマに一致

ソースの表示

• array sdo_number_array
• object sdo_geometry

{
    "oneOf":[
        {
            "$ref":"#/components/schemas/sdo_number_array"
        },
        {
            "$ref":"#/components/schemas/sdo_geometry"
        }
    ],
    "nullable":true
}

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

型: object

メモリー使用量パラメータ

ソースの表示

• maxMemSize: integer (int64)
• readBlockMemSize: integer
• writeBlockMemSize: integer

{
    "type":"object",
    "description":"the memory usage parameter",
    "properties":{
        "maxMemSize":{
            "type":"integer",
            "format":"int64"
        },
        "readBlockMemSize":{
            "type":"integer"
        },
        "writeBlockMemSize":{
            "type":"integer"
        }
    }
}

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

1つのスキーマに一致

ソースの表示

• object sdo_georaster
• object type
• object sdo_geor_histogram

{
    "oneOf":[
        {
            "$ref":"#/components/schemas/sdo_georaster"
        },
        {
            "type":"object",
            "properties":{
                "value1":{
                    "$ref":"#/components/schemas/sdo_number_array"
                },
                "value2":{
                    "$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

ソースの表示

• value1: array sdo_number_array
• value2: array sdo_number_array

{
    "type":"object",
    "properties":{
        "value1":{
            "$ref":"#/components/schemas/sdo_number_array"
        },
        "value2":{
            "$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"
        }
    }
}

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

型: object

ソースの表示

• attr: string

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

トップに戻る

レスポンス

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

• application/json

200レスポンス

仮想モザイク・サブセットをマルチパート・データ形式で返します。

本文()

ルート・スキーマ: rasterData

型: object

GeoRasterラスター・データの情報のjsonレスポンス。バイナリ・データは、マルチパート形式でこの後に続きます。

ソースの表示

• area(required): object sdo_geometry
• links(required): array links
  自己、メタデータおよびGeoRasterオブジェクトへのリンク
• window(required): array sdo_number_array

{
    "type":"object",
    "description":"The json response of the information of the GeoRaster raster data, the binary data is to be followed after this in the multi-part format.",
    "required":[
        "window",
        "area",
        "links"
    ],
    "properties":{
        "window":{
            "$ref":"#/components/schemas/sdo_number_array"
        },
        "area":{
            "$ref":"#/components/schemas/sdo_geometry"
        },
        "links":{
            "type":"array",
            "description":"links to self, metadata and the GeoRaster Object",
            "items":{
                "$ref":"#/components/schemas/instanceLink"
            }
        }
    }
}

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

型: object

ソースの表示

• attr: string

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

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

型: array

自己、メタデータおよびGeoRasterオブジェクトへのリンク

ソースの表示

• 配列: string

{
    "type":"array",
    "description":"links to self, metadata and the GeoRaster Object",
    "items":{
        "$ref":"#/components/schemas/instanceLink"
    }
}

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

型: array

ソースの表示

• 配列: number

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

401レスポンス

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

ヘッダー

• WWW_Authenticate(required):

トップに戻る

例

次の例は、cURLによってPOSTリクエストを発行して、仮想モザイクのサブセットをリクエストする方法を示しています。

curl -X POST -d @request.json "https://localhost:8080/oraclespatial/georaster/v1/datasource1/vm/landsatMosaic/rasterData" -H "Cookie: JSESSIONID=<jsessionid_value>"

次の例は、リクエスト本文のrequest.jsonを示しています。

{
  "bandNumbers": "0",
  "cropArea": [
    0,
    0,
    100,
    100
  ],
  "resamplingMethod": "bilinear",
  "considerNodata": true,
  "fillGap": true,
  "commonPointRule": "low"
}

トップに戻る