Get Area Of Interest - Get Area Of Interest

サービス:

Azure AI Services

API バージョン:

3.2

この操作は、画像の最も重要な部分を囲む境界ボックスを返します。 成功した応答は 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

要求のサンプル

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/areaOfInterest


{
  "url": "{url}"
}

応答のサンプル

状態コード:

200

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

Object

AreaOfInterest 操作の結果。

名前	型	説明
areaOfInterest	BoundingRect	画像内の関心領域の境界ボックス。
metadata	ImageMetadata	イメージ メタデータ。
modelVersion	string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	AI モデルのバージョン。
requestId	string	REST API 要求の ID。

BoundingRect

Object

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

名前	型	説明
h	integer (int32)	領域の左上のポイントからピクセル単位で測定された高さ。
w	integer (int32)	領域の左上のポイントからピクセル単位で測定された幅。
x	integer (int32)	領域の左上のポイントの X 座標 (ピクセル単位)。
y	integer (int32)	領域の左上のポイントの Y 座標 (ピクセル単位)。

ComputerVisionError

Object

API 要求エラー。

名前	型	説明
code	ComputerVisionErrorCodes	エラー コード。
innererror	ComputerVisionInnerError	内部エラーには、より具体的な情報が含まれています。
message	string	サービスによって報告されたエラーを説明するメッセージ。

ComputerVisionErrorCodes

列挙

エラー コード。

値	説明
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable

ComputerVisionErrorResponse

Object

API エラー応答。

名前	型	説明
error	ComputerVisionError	エラーの内容。

ComputerVisionInnerError

Object

API 要求エラーの詳細。

名前	型	説明
code	ComputerVisionInnerErrorCodeValue	エラー コード。
message	string	エラーメッセージ。

ComputerVisionInnerErrorCodeValue

列挙

エラー コード。

値	説明
InvalidImageFormat
UnsupportedMediaType
InvalidImageUrl
NotSupportedFeature
NotSupportedImage
Timeout
InternalServerError
InvalidImageSize
BadArgument
DetectFaceError
NotSupportedLanguage
InvalidThumbnailSize
InvalidDetails
InvalidModel
CancelledRequest
NotSupportedVisualFeature
FailedToProcess
Unspecified
StorageException

ImageMetadata

Object

イメージ メタデータ。

名前	型	説明
format	string	イメージ形式。
height	integer (int32)	画像の高さ (ピクセル単位)。
width	integer (int32)	画像の幅 (ピクセル単位)。

ImageUrl

Object

名前	型	説明
url	string	イメージのパブリックに到達可能な URL。