ジャンプ先

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

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

post

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

指定された仮想モザイクのサブセットをイメージ形式で取得します。

リクエスト

パス・パラメータ

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

問合せパラメータ

• format: string
  イメージの形式、JPEG、GIF、PNG、BMP

  許容値: [ "JPEG", "GIF", "PNG", "BMP" ]

  例:

  JPEG

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

• application/json

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

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

ルート・スキーマ: schema

型: object

イメージ内のモザイク・サブセットを返すためのパラメータ

ソースの表示

• renderOps: object rendering_param
  クライアント側レンダリング・オプション
• vm_param: object vm_param
  仮想モザイク取得パラメータ。一部のパラメータは、仮想モザイク定義の一部でもあります。これらのパラメータを指定すると、仮想モザイク定義で指定されたパラメータが上書きされます。

{
    "type":"object",
    "description":"parameters for returning the mosaic subset in an image",
    "properties":{
        "renderOps":{
            "$ref":"#/components/schemas/rendering_param"
        },
        "vm_param":{
            "$ref":"#/components/schemas/vm_param"
        }
    }
}

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

型: object

クライアント側レンダリング・オプション

ソースの表示

• colorMap: array colormap
  カラーマップ・エントリの配列
• grayScale: array grayscale
  グレースケール・エントリの配列
• IPMethod: string
  許容値: [ "none", "stretch", "piecewisestretch", "normalize", "equalize" ]

  レンダリング・イメージ処理方法。affinetransform、getrasterdata、getrastersubset、rectify、reprojectおよびwarpなどのサーバー側のラスター操作から返されるデータの場合、イメージ・レンダリング・プロセスではGeoRasterオブジェクトに格納されている統計を使用する必要があります。GeoRasterオブジェクト・メタデータに統計が設定されていない場合、返されるデータの統計がイメージ処理で使用されます。IPMethodが指定されておらず、データがレンダリング範囲(8ビットなど)にない場合、正規化はレンダリングされたイメージに適用されます。
• mask: array mask
  マスクを適用するレイヤーを指定する配列。そのレイヤーにマスクがない場合は無視されます。
• nodataMapping: array nodataMapping
  nodataマッピング・エントリの配列

{
    "type":"object",
    "description":"client side rendering options",
    "properties":{
        "IPMethod":{
            "description":"the Rendering Image Processing Method. Note that for the data that is returned from the server-side raster operations such as affinetransform, getrasterdata, getrastersubset, rectify, reproject and warp, the image rendering process should use the statistics stored in the GeoRaster Object. If there is no statistics set in the GeoRaster Object metadata, the statistics of the returned data is used in the image processing. When IPMethod is not specified but the data is not in the rendering range (for example, not 8bit), normalization is applied to the rendered image.",
            "type":"string",
            "enum":[
                "none",
                "stretch",
                "piecewisestretch",
                "normalize",
                "equalize"
            ]
        },
        "colorMap":{
            "$ref":"#/components/schemas/colormap"
        },
        "grayScale":{
            "$ref":"#/components/schemas/grayscale"
        },
        "nodataMapping":{
            "$ref":"#/components/schemas/nodataMapping"
        },
        "mask":{
            "$ref":"#/components/schemas/mask"
        }
    }
}

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

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

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

型: array

カラーマップ・エントリの配列

ソースの表示

• 配列: object items
  カラーマップ・エントリ

{
    "type":"array",
    "description":"an array of colormap entries",
    "items":{
        "type":"object",
        "description":"colormap entry",
        "properties":{
            "value":{
                "type":"number"
            },
            "red":{
                "type":"integer"
            },
            "green":{
                "type":"integer"
            },
            "blue":{
                "type":"integer"
            },
            "alpha":{
                "type":"number"
            }
        }
    }
}

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

型: array

グレースケール・エントリの配列

ソースの表示

• 配列: object items
  グレースケール・エントリ

{
    "type":"array",
    "description":"an array of grayscale entries",
    "items":{
        "type":"object",
        "description":"grayscale entry",
        "properties":{
            "value":{
                "type":"number"
            },
            "gray":{
                "type":"integer"
            }
        }
    }
}

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

型: array

マスクを適用するレイヤーを指定する配列。そのレイヤーにマスクがない場合は無視されます。

ソースの表示

• 配列: object items
  マスク・マッピングを定義します

{
    "type":"array",
    "description":"an array specifying the layers to apply the mask, if there is no mask in that layer, it is ignored.",
    "items":{
        "type":"object",
        "description":"Define the mask mapping",
        "properties":{
            "layerNumber":{
                "type":"number"
            },
            "zeroMapping":{
                "type":"number"
            },
            "oneMapping":{
                "type":"number"
            }
        }
    }
}

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

型: array

nodataマッピング・エントリの配列

ソースの表示

• 配列: object items
  nodataマッピング・エントリ

{
    "type":"array",
    "description":"an array of nodata mapping entries",
    "items":{
        "type":"object",
        "description":"nodata mapping entry",
        "properties":{
            "startValue":{
                "type":"number"
            },
            "endValue":{
                "type":"number"
            },
            "newValue":{
                "type":"number"
            },
            "isTransparent":{
                "type":"boolean"
            }
        }
    }
}

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

型: object

カラーマップ・エントリ

ソースの表示

• alpha: number
• blue: integer
• green: integer
• red: integer
• value: number

{
    "type":"object",
    "description":"colormap entry",
    "properties":{
        "value":{
            "type":"number"
        },
        "red":{
            "type":"integer"
        },
        "green":{
            "type":"integer"
        },
        "blue":{
            "type":"integer"
        },
        "alpha":{
            "type":"number"
        }
    }
}

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

型: object

グレースケール・エントリ

ソースの表示

• gray: integer
• value: number

{
    "type":"object",
    "description":"grayscale entry",
    "properties":{
        "value":{
            "type":"number"
        },
        "gray":{
            "type":"integer"
        }
    }
}

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

型: object

マスク・マッピングを定義します

ソースの表示

• layerNumber: number
• oneMapping: number
• zeroMapping: number

{
    "type":"object",
    "description":"Define the mask mapping",
    "properties":{
        "layerNumber":{
            "type":"number"
        },
        "zeroMapping":{
            "type":"number"
        },
        "oneMapping":{
            "type":"number"
        }
    }
}

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

型: object

nodataマッピング・エントリ

ソースの表示

• endValue: number
• isTransparent: boolean
• newValue: number
• startValue: number

{
    "type":"object",
    "description":"nodata mapping entry",
    "properties":{
        "startValue":{
            "type":"number"
        },
        "endValue":{
            "type":"number"
        },
        "newValue":{
            "type":"number"
        },
        "isTransparent":{
            "type":"boolean"
        }
    }
}

ネストされたスキーマ: 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 reference-oneOf[1]
• 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"
        }
    }
}

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

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

トップに戻る

レスポンス

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

• image/png
• image/jpeg
• image/bmp
• image/gif

200レスポンス

イメージ内の仮想モザイク・サブセットを返します。

本文()

ルート・スキーマ: schema

型: string(binary)

401レスポンス

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

ヘッダー

• WWW_Authenticate(required):

トップに戻る

例

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

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

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

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

トップに戻る