イメージ形式1でのラスター・データの取得
get
{server}/georaster/v1/{datasource}/{tableName}/{georasterColumnName}/{rdt}/{rid}/rasterImage
指定されたGeoRasterオブジェクトのラスター・データを問い合せて、表示用に標準Webイメージ形式で結果を返します。
問合せパラメータformatおよびthumbnailは、返されるイメージ形式を指定するために使用されます。トリミング・ウィンドウ、バンド番号、ピラミッド・レベルおよびイメージ処理方法を問合せパラメータとして指定することもできます。
リクエスト
パス・パラメータ
- georasterColumnName(required): string
GeoRaster列の名前例
- rdt(required): string
ラスター・データ表(RDT)名。例
- rid(required): integer
GeoRasterオブジェクトのラスターID (RID)。例
- tableName(required): string
表の名前の前にスキーマ名を付けることができます例
問合せパラメータ
- IPMethod: string
イメージ処理方法を指定します。許容値:
[ "stretch", "piecewisestretch", "normalize", "equalize" ]
- bandNumbers: string
取得するバンド番号を指定します。例
- cropWin: array[number]
最小アイテム数:
4
最大アイテム数:4
返されたイメージのトリミング・ウィンドウ。トリミング・ウィンドウの座標はセル領域の座標、つまり、ラスター・データのトリミング・ウィンドウの左上および右下隅の行と列番号です。サムネイル・パラメータと共存できません。例 - format: string
返されるイメージの形式(JPEG、GIF、PNGまたはBMP)を指定します。truecolorおよびグレースケール・イメージの場合、デフォルトはJPEGです。疑似カラー・イメージの場合、デフォルトはPNGです。許容値:
[ "JPEG", "GIF", "PNG", "BMP" ]
例:JPEG
- pyramidLevel: number
GeoRasterデータのピラミッド・レベルを指定します。例
- thumbnail: boolean
サムネイル・イメージを返すかどうかを指定するブール値。
この操作にはリクエスト本文はありません。
トップに戻るレスポンス
サポートされるメディア・タイプ
- image/png
- image/jpeg
- image/bmp
- image/gif
200レスポンス
出力ラスター・データをバイナリ・ストリームで返します。
ルート・スキーマ: schema
型:
string(binary)
401レスポンス
例
次の例は、cURLによってGETリクエストを発行して、GeoRasterオブジェクトからサムネイル・イメージをリクエストする方法を示しています。
curl -X GET "https://localhost:8080/oraclespatial/georaster/v1/datasource1/raster_image/image/rasterImage?format=JPEG&thumbnail=true" -H "Cookie: JSESSIONID=<jsessionid_value>"