翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
GetTextDetection
で開始された Amazon Rekognition Video 分析のテキスト検出結果を取得します。StartTextDetection。
Amazon Rekognition Video を使用したテキスト検出は、非同期オペレーションです。テキスト検出を開始するには、を呼び出します。StartTextDetectionジョブ識別子 (JobId
) テキスト検出操作が終了すると、Amazon Rekognition は、への最初の呼び出しに登録された Amazon 簡易通知サービスのトピックに完了ステータスを公開します。StartTextDetection
。テキスト検出操作の結果を取得するには、まず Amazon SNS トピックに発行されたステータス値がSUCCEEDED
。もしそうなら、GetTextDetection
ジョブ識別子を渡します (JobId
) の最初の呼び出しからStartLabelDetection
。
GetTextDetection
検出されたテキストの配列を返します (TextDetections
)は、テキストが検出された時刻でソートされます。ビデオフレームあたり最大50語です。
配列の各要素には、検出されたテキスト、検出されたテキストの精度に対する信頼度の比率、テキストが検出された時間、テキストが位置する境界ボックス情報、および単語とその行の一意の識別子が含まれます。
返されるテキスト検出の数を制限するには、MaxResults パラメータを使用します。で指定した数を超える結果がある場合MaxResults
とすると、の値NextToken
オペレーションレスポンスには、次の結果セットを取得するためのページ割りトークンが含まれています。次の結果ページを取得したい場合、GetTextDetection
入力してNextToken
リクエストパラメーター。前回の呼び出しで返されたトークン値。GetTextDetection
。
リクエストの構文
{
"JobId": "string
",
"MaxResults": number
,
"NextToken": "string
"
}
リクエストパラメータ
リクエストは以下の JSON 形式のデータを受け入れます。
- JobId
-
結果を返すテキスト検出操作のJob 識別子。ジョブ識別子は、への最初の呼び出しから取得します。
StartTextDetection
。Type: 文字列
長さの制約: 最小長は 1 です。 最大長は 64 です。
パターン:
^[a-zA-Z0-9-_]+$
必須: はい
- MaxResults
-
ページ割りコールごとに返す結果の最大数。指定できる最大値は 1000 です。
Type: 整数
有効範囲: 最小値は 1 です。
必須: いいえ
- NextToken
-
前のレスポンスが不完全だった場合 (取得するラベルが多いため)、Amazon Rekognition Video はレスポンスでページ割りトークンを返します。このページ割りトークンを使用して、次のテキストセットを取得できます。
Type: 文字列
長さの制約: 最大長は 255 です。
必須: いいえ
レスポンスの構文
{
"JobStatus": "string",
"NextToken": "string",
"StatusMessage": "string",
"TextDetections": [
{
"TextDetection": {
"Confidence": number,
"DetectedText": "string",
"Geometry": {
"BoundingBox": {
"Height": number,
"Left": number,
"Top": number,
"Width": number
},
"Polygon": [
{
"X": number,
"Y": number
}
]
},
"Id": number,
"ParentId": number,
"Type": "string"
},
"Timestamp": number
}
],
"TextModelVersion": "string",
"VideoMetadata": {
"Codec": "string",
"ColorRange": "string",
"DurationMillis": number,
"Format": "string",
"FrameHeight": number,
"FrameRate": number,
"FrameWidth": number
}
}
レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- JobStatus
-
テキスト検出ジョブの現在のステータス。
Type: 文字列
有効な値:
IN_PROGRESS | SUCCEEDED | FAILED
- NextToken
-
レスポンスが切り捨てられると、Amazon Rekognition Video はこのトークンを返します。このトークンを後続のリクエストで使用して、次のテキストセットを取得できます。
Type: 文字列
長さの制約: 最大長は 255 です。
- StatusMessage
-
ジョブが失敗した場合、
StatusMessage
は、わかりやすいエラーメッセージが表示されます。Type: 文字列
- TextDetections
-
ビデオで検出されたテキストの配列。各要素には、検出されたテキスト、テキストが検出されたビデオの開始からのミリ秒単位の時間、および画面上で検出された場所が含まれます。
Type: の配列TextDetectionResultオブジェクト
- TextModelVersion
-
テキストの検出に使用されたテキスト検出モデルのバージョン番号。
Type: 文字列
- VideoMetadata
-
Amazon Rekognition が分析した動画に関する情報。
Videometadata
は、Amazon Rekognition ビデオオペレーションからページ分割されたレスポンスの各ページに返されます。型: VideoMetadata オブジェクト
エラー
- AccessDeniedException
-
アクションを実行する権限がありません。
HTTP ステータスコード: 400
- InternalServerError
-
Amazon Rekognition でサービスの問題が発生しました。もう一度やり直してください。
HTTP ステータスコード: 500
- InvalidPaginationTokenException
-
リクエストのページ割りトークンが有効ではありません。
HTTP ステータスコード: 400
- InvalidParameterException
-
入力パラメータが制約に違反しています。API オペレーションを再度呼び出す前にパラメータを検証します。
HTTP ステータスコード: 400
- ProvisionedThroughputExceededException
-
お客様のスループット制限を超えたリクエストの数。この上限を引き上げる場合は、Amazon Rekognition までお問い合わせください。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
リクエストで指定されたリソースが見つかりません。
HTTP ステータスコード: 400
- ThrottlingException
-
Amazon Rekognition は一時的にリクエストを処理できませんでした。もう一度やり直してください。
HTTP ステータスコード: 500
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください: