GetTextDetection - Amazon Rekognition

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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 を使用する方法の詳細については、次を参照してください: