翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
GetPersonTracking
によって開始された Amazon Rekognition Video 分析のパストラッキング結果を取得します。StartPersonTracking。
個人パストラッキング操作は、への呼び出しによって開始されます。StartPersonTrackingジョブ識別子 (JobId). 操作が完了すると、Amazon Rekognition Video は、への最初の呼び出しに登録された Amazon 簡易通知サービスのトピックに完了ステータスを公開します。StartPersonTracking。
個人パストラッキング操作の結果を取得するには、まず Amazon SNS トピックに公開されたステータス値がSUCCEEDED。もしそうなら、電話してくださいGetPersonTrackingジョブ識別子を渡します (JobId) の最初の呼び出しからStartPersonTracking。
GetPersonTracking配列を返し、Persons、追跡された人物のうち、そのパスがビデオで追跡された時間。
GetPersonTrackingデフォルトのフェイシャルアトリビュートのみを返します (BoundingBox,Confidence,Landmarks,Pose, およびQuality). にリストされているその他のフェイシャルアトリビュートFace次のレスポンス構文のオブジェクトは返されません。
詳細については、「FaceDetail」を参照してください。
デフォルトでは、配列は動画内で人のパスが追跡される時刻でソートされます。追跡対象者で並べ替えるには、INDEX向けのSortBy入力パラメータ。
を使用するMaxResults返される項目数を制限するパラメータ。で指定した数を超える結果がある場合MaxResultsとすると、の値NextTokenオペレーションレスポンスには、次の結果セットを取得するためのページ割りトークンが含まれています。次の結果ページを取得したい場合は、GetPersonTrackingの入力NextTokenへの前回の呼び出しで返されたトークン値を持つリクエストパラメータGetPersonTracking。
リクエストの構文
{
"JobId": "string",
"MaxResults": number,
"NextToken": "string",
"SortBy": "string"
}リクエストパラメータ
リクエストは以下の JSON 形式のデータを受け入れます。
- JobId
-
動画内の人を追跡するジョブの識別子。次のようになります。
JobIdへの呼び出しからStartPersonTracking。Type: 文字列
長さの制約: 最小長は 1 です｡ 最大長は 64 です。
パターン:
^[a-zA-Z0-9-_]+$必須: はい
- MaxResults
-
ページ割りコールごとに返される結果の最大数。指定できる最大値は 1000 です。1000 より大きい値を指定した場合、最大 1000 件の結果が返されます。デフォルト値は 1000 です。
Type: 整数
有効範囲: 最小値は 1 です。
必須: いいえ
- NextToken
-
前のレスポンスが不完全だった場合 (取得する人が増えるため)、Amazon Rekognition Video はレスポンスでページ割りトークンを返します。このページ割りトークンを使用して、次の人のセットを取得できます。
Type: 文字列
長さの制約: 最大長は 255 です。
必須: いいえ
- SortBy
-
の要素に使用するソート
Persons配列。を使用するTIMESTAMP人が検出された時刻で配列要素をソートします。を使用するINDEX追跡された人物でソートする。並び替えたらINDEXの場合、各人の配列要素は検出信頼度でソートされます。デフォルトの並べ替えは by です。TIMESTAMP。Type: 文字列
有効な値:
INDEX | TIMESTAMP必須: いいえ
レスポンスの構文
{
"JobStatus": "string",
"NextToken": "string",
"Persons": [
{
"Person": {
"BoundingBox": {
"Height": number,
"Left": number,
"Top": number,
"Width": number
},
"Face": {
"AgeRange": {
"High": number,
"Low": number
},
"Beard": {
"Confidence": number,
"Value": boolean
},
"BoundingBox": {
"Height": number,
"Left": number,
"Top": number,
"Width": number
},
"Confidence": number,
"Emotions": [
{
"Confidence": number,
"Type": "string"
}
],
"Eyeglasses": {
"Confidence": number,
"Value": boolean
},
"EyesOpen": {
"Confidence": number,
"Value": boolean
},
"Gender": {
"Confidence": number,
"Value": "string"
},
"Landmarks": [
{
"Type": "string",
"X": number,
"Y": number
}
],
"MouthOpen": {
"Confidence": number,
"Value": boolean
},
"Mustache": {
"Confidence": number,
"Value": boolean
},
"Pose": {
"Pitch": number,
"Roll": number,
"Yaw": number
},
"Quality": {
"Brightness": number,
"Sharpness": number
},
"Smile": {
"Confidence": number,
"Value": boolean
},
"Sunglasses": {
"Confidence": number,
"Value": boolean
}
},
"Index": number
},
"Timestamp": number
}
],
"StatusMessage": "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 です。
- Persons
-
ビデオ内で検出された人の配列と、ビデオ全体でパスが追跡された時間。人のパスが追跡されるたびに、配列要素が存在します。
Type: の配列PersonDetectionオブジェクト
- StatusMessage
-
ジョブが失敗した場合、
StatusMessageは、わかりやすいエラーメッセージが表示されます。Type: 文字列
- VideoMetadata
-
Amazon Rekognition Video が分析した動画に関する情報。
Videometadataは、Amazon Rekognition Video オペレーションからページ分割されたレスポンスの各ページに返されます。型: 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 を使用する方法の詳細については、次を参照してください：
