Get Area Of Interest - Get Area Of Interest
この操作は、画像の最も重要な部分を囲む境界ボックスを返します。 成功した応答は JSON で返されます。 要求が失敗した場合、応答にはエラー コードと、問題の特定に役立つメッセージが含まれます。 エラーが発生すると、エラー コードとエラー メッセージが返されます。 エラー コードは、InvalidImageUrl、InvalidImageFormat、InvalidImageSize、NotSupportedImage、FailedToProcess、Timeout、または InternalServerError のいずれかです。
POST {Endpoint}/vision/v3.2/areaOfInterest
POST {Endpoint}/vision/v3.2/areaOfInterest?model-version={model-version}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
Endpoint
|
path | True |
string |
サポートされている Cognitive Services エンドポイント。 |
model-version
|
query |
string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$ |
AI モデルのバージョンを指定する省略可能なパラメーター。 指定できる値は、"latest"、"2021-04-01"、"2021-05-01" です。 既定値は "latest" です。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
url | True |
string |
イメージのパブリックに到達可能な URL。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
応答には、JSON 形式で抽出された対象領域が含まれます。 |
|
Other Status Codes |
エラー応答。 |
セキュリティ
Ocp-Apim-Subscription-Key
型:
apiKey
/:
header
例
Successful GetAreaOfInterest request
要求のサンプル
POST https://westus.api.cognitive.microsoft.com/vision/v3.2/areaOfInterest
{
"url": "{url}"
}
応答のサンプル
{
"areaOfInterest": {
"h": 951,
"w": 950,
"x": 160,
"y": 0
},
"requestId": "ed2de1c6-fb55-4686-b0da-4da6e05d283f",
"metadata": {
"format": "Jpeg",
"height": 951,
"width": 1378
},
"modelVersion": "2021-04-01"
}
定義
名前 | 説明 |
---|---|
Area |
AreaOfInterest 操作の結果。 |
Bounding |
イメージ内の領域の境界ボックス。 |
Computer |
API 要求エラー。 |
Computer |
エラー コード。 |
Computer |
API エラー応答。 |
Computer |
API 要求エラーの詳細。 |
Computer |
エラー コード。 |
Image |
イメージ メタデータ。 |
Image |
AreaOfInterestResult
AreaOfInterest 操作の結果。
名前 | 型 | 説明 |
---|---|---|
areaOfInterest |
画像内の関心領域の境界ボックス。 |
|
metadata |
イメージ メタデータ。 |
|
modelVersion |
string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$ |
AI モデルのバージョン。 |
requestId |
string |
REST API 要求の ID。 |
BoundingRect
イメージ内の領域の境界ボックス。
名前 | 型 | 説明 |
---|---|---|
h |
integer (int32) |
領域の左上のポイントからピクセル単位で測定された高さ。 |
w |
integer (int32) |
領域の左上のポイントからピクセル単位で測定された幅。 |
x |
integer (int32) |
領域の左上のポイントの X 座標 (ピクセル単位)。 |
y |
integer (int32) |
領域の左上のポイントの Y 座標 (ピクセル単位)。 |
ComputerVisionError
API 要求エラー。
名前 | 型 | 説明 |
---|---|---|
code |
エラー コード。 |
|
innererror |
内部エラーには、より具体的な情報が含まれています。 |
|
message |
string |
サービスによって報告されたエラーを説明するメッセージ。 |
ComputerVisionErrorCodes
エラー コード。
値 | 説明 |
---|---|
InternalServerError | |
InvalidArgument | |
InvalidRequest | |
ServiceUnavailable |
ComputerVisionErrorResponse
API エラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
エラーの内容。 |
ComputerVisionInnerError
API 要求エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
code |
エラー コード。 |
|
message |
string |
エラーメッセージ。 |
ComputerVisionInnerErrorCodeValue
エラー コード。
値 | 説明 |
---|---|
BadArgument | |
CancelledRequest | |
DetectFaceError | |
FailedToProcess | |
InternalServerError | |
InvalidDetails | |
InvalidImageFormat | |
InvalidImageSize | |
InvalidImageUrl | |
InvalidModel | |
InvalidThumbnailSize | |
NotSupportedFeature | |
NotSupportedImage | |
NotSupportedLanguage | |
NotSupportedVisualFeature | |
StorageException | |
Timeout | |
Unspecified | |
UnsupportedMediaType |
ImageMetadata
イメージ メタデータ。
名前 | 型 | 説明 |
---|---|---|
format |
string |
イメージ形式。 |
height |
integer (int32) |
画像の高さ (ピクセル単位)。 |
width |
integer (int32) |
画像の幅 (ピクセル単位)。 |
ImageUrl
名前 | 型 | 説明 |
---|---|---|
url |
string |
イメージのパブリックに到達可能な URL。 |