次の方法で共有


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

AreaOfInterestResult

応答には、JSON 形式で抽出された対象領域が含まれます。

Other Status Codes

ComputerVisionErrorResponse

エラー応答。

セキュリティ

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

定義

名前 説明
AreaOfInterestResult

AreaOfInterest 操作の結果。

BoundingRect

イメージ内の領域の境界ボックス。

ComputerVisionError

API 要求エラー。

ComputerVisionErrorCodes

エラー コード。

ComputerVisionErrorResponse

API エラー応答。

ComputerVisionInnerError

API 要求エラーの詳細。

ComputerVisionInnerErrorCodeValue

エラー コード。

ImageMetadata

イメージ メタデータ。

ImageUrl

AreaOfInterestResult

AreaOfInterest 操作の結果。

名前 説明
areaOfInterest

BoundingRect

画像内の関心領域の境界ボックス。

metadata

ImageMetadata

イメージ メタデータ。

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

ComputerVisionErrorCodes

エラー コード。

innererror

ComputerVisionInnerError

内部エラーには、より具体的な情報が含まれています。

message

string

サービスによって報告されたエラーを説明するメッセージ。

ComputerVisionErrorCodes

エラー コード。

説明
InternalServerError
InvalidArgument
InvalidRequest
ServiceUnavailable

ComputerVisionErrorResponse

API エラー応答。

名前 説明
error

ComputerVisionError

エラーの内容。

ComputerVisionInnerError

API 要求エラーの詳細。

名前 説明
code

ComputerVisionInnerErrorCodeValue

エラー コード。

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。