aws-sdk-rekognition 1.0.0.rc9 → 1.0.0.rc10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1c0e3ac4affb7c4f40cc3a701f42d7e10e170701
-  data.tar.gz: 319ada6fe5d0593bb38e0dd594f0cd83f682cc64
+  metadata.gz: d530f5a46ac184014f42546dc6fa4d7fb44c9524
+  data.tar.gz: a6f7cd4bc098e1846794f975b44e74f7446d379c
 SHA512:
-  metadata.gz: caee8ac7b503267e8fb663340d318cb33ea96b81708c90177ba72ecd3606382e09017d7c3fcf0ed36db1fa5531a5507bab556c23bb6e9084f6f6d8bc8d4c63ec
-  data.tar.gz: eeafea754e97bf12bb916a354cf275c4e5d6da26b5c2499d3c2565f15641ce7ba8f06bd3595b156d4175299b0d134a82beb061e9b7f5b985c489c8514bcd1d66
+  metadata.gz: 4ca0644eec96c84f77e46280557b52643a91f3a834a8419ed28402ddc0b7233f1272badb4beaaecb0e3cbfec1dfec06a8303cb61666fb6f678ac7f11f47e1c94
+  data.tar.gz: e48374dcc8436f70f4f9884713ee92bc955b75e5a2329e70734d589c7c117b589c8dcc994dd843574f6a86b54dcb20a1139064b08e88edc744c2477aff1e401e

data/lib/aws-sdk-rekognition.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-rekognition/customizations'
 # @service
 module Aws::Rekognition
 
-  GEM_VERSION = '1.0.0.rc9'
+  GEM_VERSION = '1.0.0.rc10'
 
 end

data/lib/aws-sdk-rekognition/client.rb

@@ -159,51 +159,62 @@ module Aws::Rekognition
     # the *target* input image.
     #
     # <note markdown="1"> If the source image contains multiple faces, the service detects the
-    # largest face and uses it to compare with each face detected in the
-    # target image.
+    # largest face and compares it with each face detected in the target
+    # image.
     #
     #  </note>
     #
     # In response, the operation returns an array of face matches ordered by
-    # similarity score with the highest similarity scores first. For each
-    # face match, the response provides a bounding box of the face and
-    # `confidence` value (indicating the level of confidence that the
-    # bounding box contains a face). The response also provides a
-    # `similarity` score, which indicates how closely the faces match.
+    # similarity score in descending order. For each face match, the
+    # response provides a bounding box of the face, facial landmarks, pose
+    # details (pitch, role, and yaw), quality (brightness and sharpness),
+    # and confidence value (indicating the level of confidence that the
+    # bounding box contains a face). The response also provides a similarity
+    # score, which indicates how closely the faces match.
     #
-    # <note markdown="1"> By default, only faces with the similarity score of greater than or
-    # equal to 80% are returned in the response. You can change this value.
+    # <note markdown="1"> By default, only faces with a similarity score of greater than or
+    # equal to 80% are returned in the response. You can change this value
+    # by specifying the `SimilarityThreshold` parameter.
     #
     #  </note>
     #
-    # In addition to the face matches, the response returns information
-    # about the face in the source image, including the bounding box of the
-    # face and confidence value.
+    # `CompareFaces` also returns an array of faces that don't match the
+    # source image. For each face, it returns a bounding box, confidence
+    # value, landmarks, pose details, and quality. The response also returns
+    # information about the face in the source image, including the bounding
+    # box of the face and confidence value.
     #
-    # <note markdown="1"> This is a stateless API operation. That is, the operation does not
-    # persist any data.
+    # If the image doesn't contain Exif metadata, `CompareFaces` returns
+    # orientation information for the source and target images. Use these
+    # values to display the images with the correct image orientation.
+    #
+    # <note markdown="1"> This is a stateless API operation. That is, data returned by this
+    # operation doesn't persist.
     #
     #  </note>
     #
-    # For an example, see get-started-exercise-compare-faces
+    # For an example, see get-started-exercise-compare-faces.
     #
     # This operation requires permissions to perform the
     # `rekognition:CompareFaces` action.
     #
     # @option params [required, Types::Image] :source_image
-    #   Source image either as bytes or an S3 object
+    #   The source image, either as bytes or as an S3 object.
     #
     # @option params [required, Types::Image] :target_image
-    #   Target image either as bytes or an S3 object
+    #   The target image, either as bytes or as an S3 object.
     #
     # @option params [Float] :similarity_threshold
-    #   The minimum level of confidence in the match you want included in the
-    #   result.
+    #   The minimum level of confidence in the face matches that a match must
+    #   meet to be included in the `FaceMatches` array.
     #
     # @return [Types::CompareFacesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CompareFacesResponse#source_image_face #source_image_face} => Types::ComparedSourceImageFace
     #   * {Types::CompareFacesResponse#face_matches #face_matches} => Array&lt;Types::CompareFacesMatch&gt;
+    #   * {Types::CompareFacesResponse#unmatched_faces #unmatched_faces} => Array&lt;Types::ComparedFace&gt;
+    #   * {Types::CompareFacesResponse#source_image_orientation_correction #source_image_orientation_correction} => String
+    #   * {Types::CompareFacesResponse#target_image_orientation_correction #target_image_orientation_correction} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -241,6 +252,32 @@ module Aws::Rekognition
     #   resp.face_matches[0].face.bounding_box.left #=> Float
     #   resp.face_matches[0].face.bounding_box.top #=> Float
     #   resp.face_matches[0].face.confidence #=> Float
+    #   resp.face_matches[0].face.landmarks #=> Array
+    #   resp.face_matches[0].face.landmarks[0].type #=> String, one of "EYE_LEFT", "EYE_RIGHT", "NOSE", "MOUTH_LEFT", "MOUTH_RIGHT", "LEFT_EYEBROW_LEFT", "LEFT_EYEBROW_RIGHT", "LEFT_EYEBROW_UP", "RIGHT_EYEBROW_LEFT", "RIGHT_EYEBROW_RIGHT", "RIGHT_EYEBROW_UP", "LEFT_EYE_LEFT", "LEFT_EYE_RIGHT", "LEFT_EYE_UP", "LEFT_EYE_DOWN", "RIGHT_EYE_LEFT", "RIGHT_EYE_RIGHT", "RIGHT_EYE_UP", "RIGHT_EYE_DOWN", "NOSE_LEFT", "NOSE_RIGHT", "MOUTH_UP", "MOUTH_DOWN", "LEFT_PUPIL", "RIGHT_PUPIL"
+    #   resp.face_matches[0].face.landmarks[0].x #=> Float
+    #   resp.face_matches[0].face.landmarks[0].y #=> Float
+    #   resp.face_matches[0].face.pose.roll #=> Float
+    #   resp.face_matches[0].face.pose.yaw #=> Float
+    #   resp.face_matches[0].face.pose.pitch #=> Float
+    #   resp.face_matches[0].face.quality.brightness #=> Float
+    #   resp.face_matches[0].face.quality.sharpness #=> Float
+    #   resp.unmatched_faces #=> Array
+    #   resp.unmatched_faces[0].bounding_box.width #=> Float
+    #   resp.unmatched_faces[0].bounding_box.height #=> Float
+    #   resp.unmatched_faces[0].bounding_box.left #=> Float
+    #   resp.unmatched_faces[0].bounding_box.top #=> Float
+    #   resp.unmatched_faces[0].confidence #=> Float
+    #   resp.unmatched_faces[0].landmarks #=> Array
+    #   resp.unmatched_faces[0].landmarks[0].type #=> String, one of "EYE_LEFT", "EYE_RIGHT", "NOSE", "MOUTH_LEFT", "MOUTH_RIGHT", "LEFT_EYEBROW_LEFT", "LEFT_EYEBROW_RIGHT", "LEFT_EYEBROW_UP", "RIGHT_EYEBROW_LEFT", "RIGHT_EYEBROW_RIGHT", "RIGHT_EYEBROW_UP", "LEFT_EYE_LEFT", "LEFT_EYE_RIGHT", "LEFT_EYE_UP", "LEFT_EYE_DOWN", "RIGHT_EYE_LEFT", "RIGHT_EYE_RIGHT", "RIGHT_EYE_UP", "RIGHT_EYE_DOWN", "NOSE_LEFT", "NOSE_RIGHT", "MOUTH_UP", "MOUTH_DOWN", "LEFT_PUPIL", "RIGHT_PUPIL"
+    #   resp.unmatched_faces[0].landmarks[0].x #=> Float
+    #   resp.unmatched_faces[0].landmarks[0].y #=> Float
+    #   resp.unmatched_faces[0].pose.roll #=> Float
+    #   resp.unmatched_faces[0].pose.yaw #=> Float
+    #   resp.unmatched_faces[0].pose.pitch #=> Float
+    #   resp.unmatched_faces[0].quality.brightness #=> Float
+    #   resp.unmatched_faces[0].quality.sharpness #=> Float
+    #   resp.source_image_orientation_correction #=> String, one of "ROTATE_0", "ROTATE_90", "ROTATE_180", "ROTATE_270"
+    #   resp.target_image_orientation_correction #=> String, one of "ROTATE_0", "ROTATE_90", "ROTATE_180", "ROTATE_270"
     #
     # @overload compare_faces(params = {})
     # @param [Hash] params ({})
@@ -257,6 +294,10 @@ module Aws::Rekognition
     # operation and persist results in a specific collection. Then, a user
     # can search the collection for faces in the user-specific container.
     #
+    # <note markdown="1"> Collection names are case-sensitive.
+    #
+    #  </note>
+    #
     # For an example, see example1.
     #
     # This operation requires permissions to perform the
@@ -380,7 +421,7 @@ module Aws::Rekognition
     #   an S3 object.
     #
     # @option params [Array<String>] :attributes
-    #   A list of facial attributes you want to be returned. This can be the
+    #   An array of facial attributes you want to be returned. This can be the
     #   default list of attributes or all attributes. If you don't specify a
     #   value for `Attributes` or if you specify `["DEFAULT"]`, the API
     #   returns the following subset of facial attributes: `BoundingBox`,
@@ -560,33 +601,18 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
-    # Detects explicit or suggestive adult content in a specified .jpeg or
-    # .png image. Use `DetectModerationLabels` to moderate images depending
-    # on your requirements. For example, you might want to filter images
-    # that contain nudity, but not images containing suggestive content.
+    # Detects explicit or suggestive adult content in a specified JPEG or
+    # PNG format image. Use `DetectModerationLabels` to moderate images
+    # depending on your requirements. For example, you might want to filter
+    # images that contain nudity, but not images containing suggestive
+    # content.
     #
     # To filter images, use the labels returned by `DetectModerationLabels`
     # to determine which types of content are appropriate. For information
-    # about moderation labels, see howitworks-moderateimage.
+    # about moderation labels, see image-moderation.
     #
     # @option params [required, Types::Image] :image
-    #   Provides the source image either as bytes or an S3 object.
-    #
-    #   The region for the S3 bucket containing the S3 object must match the
-    #   region you use for Amazon Rekognition operations.
-    #
-    #   You may need to Base64-encode the image bytes depending on the
-    #   language you are using and whether or not you are using the AWS SDK.
-    #   For more information, see example4.
-    #
-    #   If you use the Amazon CLI to call Amazon Rekognition operations,
-    #   passing image bytes using the Bytes property is not supported. You
-    #   must first upload the image to an Amazon S3 bucket and then call the
-    #   operation using the S3Object property.
-    #
-    #   For Amazon Rekognition to process an S3 object, the user must have
-    #   permission to access the S3 object. For more information, see
-    #   manage-access-resource-policies.
+    #   The input image as bytes or an S3 object.
     #
     # @option params [Float] :min_confidence
     #   Specifies the minimum confidence level for the labels to return.
@@ -628,6 +654,43 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # Gets the name and additional information about a celebrity based on
+    # his or her Rekognition ID. The additional information is returned as
+    # an array of URLs. If there is no additional information about the
+    # celebrity, this list is empty. For more information, see
+    # celebrity-recognition.
+    #
+    # This operation requires permissions to perform the
+    # `rekognition:GetCelebrityInfo` action.
+    #
+    # @option params [required, String] :id
+    #   The ID for the celebrity. You get the celebrity ID from a call to the
+    #   operation, which recognizes celebrities in an image.
+    #
+    # @return [Types::GetCelebrityInfoResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetCelebrityInfoResponse#urls #urls} => Array&lt;String&gt;
+    #   * {Types::GetCelebrityInfoResponse#name #name} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_celebrity_info({
+    #     id: "RekognitionUniqueId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.urls #=> Array
+    #   resp.urls[0] #=> String
+    #   resp.name #=> String
+    #
+    # @overload get_celebrity_info(params = {})
+    # @param [Hash] params ({})
+    def get_celebrity_info(params = {}, options = {})
+      req = build_request(:get_celebrity_info, params)
+      req.send_request(options)
+    end
+
     # Detects faces in the input image and adds them to the specified
     # collection.
     #
@@ -649,7 +712,7 @@ module Aws::Rekognition
     # detected faces. This includes, the bounding box of the detected face,
     # confidence value (indicating the bounding box contains a face), a face
     # ID assigned by the service for each face that is detected and stored,
-    # and an image ID assigned by the service for the input image If you
+    # and an image ID assigned by the service for the input image. If you
     # request all facial attributes (using the `detectionAttributes`
     # parameter, Amazon Rekognition returns detailed facial attributes such
     # as facial landmarks (for example, location of eye and mount) and other
@@ -667,30 +730,14 @@ module Aws::Rekognition
     #   that are detected in the input images.
     #
     # @option params [required, Types::Image] :image
-    #   Provides the source image either as bytes or an S3 object.
-    #
-    #   The region for the S3 bucket containing the S3 object must match the
-    #   region you use for Amazon Rekognition operations.
-    #
-    #   You may need to Base64-encode the image bytes depending on the
-    #   language you are using and whether or not you are using the AWS SDK.
-    #   For more information, see example4.
-    #
-    #   If you use the Amazon CLI to call Amazon Rekognition operations,
-    #   passing image bytes using the Bytes property is not supported. You
-    #   must first upload the image to an Amazon S3 bucket and then call the
-    #   operation using the S3Object property.
-    #
-    #   For Amazon Rekognition to process an S3 object, the user must have
-    #   permission to access the S3 object. For more information, see
-    #   manage-access-resource-policies.
+    #   The input image as bytes or an S3 object.
     #
     # @option params [String] :external_image_id
     #   ID you want to assign to all the faces detected in the image.
     #
     # @option params [Array<String>] :detection_attributes
-    #   A list of facial attributes that you want to be returned. This can be
-    #   the default list of attributes or all attributes. If you don't
+    #   An array of facial attributes that you want to be returned. This can
+    #   be the default list of attributes or all attributes. If you don't
     #   specify a value for `Attributes` or if you specify `["DEFAULT"]`, the
     #   API returns the following subset of facial attributes: `BoundingBox`,
     #   `Confidence`, `Pose`, `Quality` and `Landmarks`. If you provide
@@ -870,6 +917,102 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # Returns an array of celebrities recognized in the input image. The
+    # image is passed either as base64-encoded image bytes or as a reference
+    # to an image in an Amazon S3 bucket. The image must be either a PNG or
+    # JPEG formatted file. For more information, see celebrity-recognition.
+    #
+    # `RecognizeCelebrities` returns the 15 largest faces in the image. It
+    # lists recognized celebrities in the `CelebrityFaces` list and
+    # unrecognized faces in the `UnrecognizedFaces` list. The operation
+    # doesn't return celebrities whose face sizes are smaller than the
+    # largest 15 faces in the image.
+    #
+    # For each celebrity recognized, the API returns a `Celebrity` object.
+    # The `Celebrity` object contains the celebrity name, ID, URL links to
+    # additional information, match confidence, and a `ComparedFace` object
+    # that you can use to locate the celebrity's face on the image.
+    #
+    # Rekognition does not retain information about which images a celebrity
+    # has been recognized in. Your application must store this information
+    # and use the `Celebrity` ID property as a unique identifier for the
+    # celebrity. If you don't store the celebrity name or additional
+    # information URLs returned by `RecognizeCelebrities`, you will need the
+    # ID to identify the celebrity in a call to the operation.
+    #
+    # For an example, see recognize-celebrities-tutorial.
+    #
+    # This operation requires permissions to perform the
+    # `rekognition:RecognizeCelebrities` operation.
+    #
+    # @option params [required, Types::Image] :image
+    #   The input image to use for celebrity recognition.
+    #
+    # @return [Types::RecognizeCelebritiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::RecognizeCelebritiesResponse#celebrity_faces #celebrity_faces} => Array&lt;Types::Celebrity&gt;
+    #   * {Types::RecognizeCelebritiesResponse#unrecognized_faces #unrecognized_faces} => Array&lt;Types::ComparedFace&gt;
+    #   * {Types::RecognizeCelebritiesResponse#orientation_correction #orientation_correction} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.recognize_celebrities({
+    #     image: { # required
+    #       bytes: "data",
+    #       s3_object: {
+    #         bucket: "S3Bucket",
+    #         name: "S3ObjectName",
+    #         version: "S3ObjectVersion",
+    #       },
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.celebrity_faces #=> Array
+    #   resp.celebrity_faces[0].urls #=> Array
+    #   resp.celebrity_faces[0].urls[0] #=> String
+    #   resp.celebrity_faces[0].name #=> String
+    #   resp.celebrity_faces[0].id #=> String
+    #   resp.celebrity_faces[0].face.bounding_box.width #=> Float
+    #   resp.celebrity_faces[0].face.bounding_box.height #=> Float
+    #   resp.celebrity_faces[0].face.bounding_box.left #=> Float
+    #   resp.celebrity_faces[0].face.bounding_box.top #=> Float
+    #   resp.celebrity_faces[0].face.confidence #=> Float
+    #   resp.celebrity_faces[0].face.landmarks #=> Array
+    #   resp.celebrity_faces[0].face.landmarks[0].type #=> String, one of "EYE_LEFT", "EYE_RIGHT", "NOSE", "MOUTH_LEFT", "MOUTH_RIGHT", "LEFT_EYEBROW_LEFT", "LEFT_EYEBROW_RIGHT", "LEFT_EYEBROW_UP", "RIGHT_EYEBROW_LEFT", "RIGHT_EYEBROW_RIGHT", "RIGHT_EYEBROW_UP", "LEFT_EYE_LEFT", "LEFT_EYE_RIGHT", "LEFT_EYE_UP", "LEFT_EYE_DOWN", "RIGHT_EYE_LEFT", "RIGHT_EYE_RIGHT", "RIGHT_EYE_UP", "RIGHT_EYE_DOWN", "NOSE_LEFT", "NOSE_RIGHT", "MOUTH_UP", "MOUTH_DOWN", "LEFT_PUPIL", "RIGHT_PUPIL"
+    #   resp.celebrity_faces[0].face.landmarks[0].x #=> Float
+    #   resp.celebrity_faces[0].face.landmarks[0].y #=> Float
+    #   resp.celebrity_faces[0].face.pose.roll #=> Float
+    #   resp.celebrity_faces[0].face.pose.yaw #=> Float
+    #   resp.celebrity_faces[0].face.pose.pitch #=> Float
+    #   resp.celebrity_faces[0].face.quality.brightness #=> Float
+    #   resp.celebrity_faces[0].face.quality.sharpness #=> Float
+    #   resp.celebrity_faces[0].match_confidence #=> Float
+    #   resp.unrecognized_faces #=> Array
+    #   resp.unrecognized_faces[0].bounding_box.width #=> Float
+    #   resp.unrecognized_faces[0].bounding_box.height #=> Float
+    #   resp.unrecognized_faces[0].bounding_box.left #=> Float
+    #   resp.unrecognized_faces[0].bounding_box.top #=> Float
+    #   resp.unrecognized_faces[0].confidence #=> Float
+    #   resp.unrecognized_faces[0].landmarks #=> Array
+    #   resp.unrecognized_faces[0].landmarks[0].type #=> String, one of "EYE_LEFT", "EYE_RIGHT", "NOSE", "MOUTH_LEFT", "MOUTH_RIGHT", "LEFT_EYEBROW_LEFT", "LEFT_EYEBROW_RIGHT", "LEFT_EYEBROW_UP", "RIGHT_EYEBROW_LEFT", "RIGHT_EYEBROW_RIGHT", "RIGHT_EYEBROW_UP", "LEFT_EYE_LEFT", "LEFT_EYE_RIGHT", "LEFT_EYE_UP", "LEFT_EYE_DOWN", "RIGHT_EYE_LEFT", "RIGHT_EYE_RIGHT", "RIGHT_EYE_UP", "RIGHT_EYE_DOWN", "NOSE_LEFT", "NOSE_RIGHT", "MOUTH_UP", "MOUTH_DOWN", "LEFT_PUPIL", "RIGHT_PUPIL"
+    #   resp.unrecognized_faces[0].landmarks[0].x #=> Float
+    #   resp.unrecognized_faces[0].landmarks[0].y #=> Float
+    #   resp.unrecognized_faces[0].pose.roll #=> Float
+    #   resp.unrecognized_faces[0].pose.yaw #=> Float
+    #   resp.unrecognized_faces[0].pose.pitch #=> Float
+    #   resp.unrecognized_faces[0].quality.brightness #=> Float
+    #   resp.unrecognized_faces[0].quality.sharpness #=> Float
+    #   resp.orientation_correction #=> String, one of "ROTATE_0", "ROTATE_90", "ROTATE_180", "ROTATE_270"
+    #
+    # @overload recognize_celebrities(params = {})
+    # @param [Hash] params ({})
+    def recognize_celebrities(params = {}, options = {})
+      req = build_request(:recognize_celebrities, params)
+      req.send_request(options)
+    end
+
     # For a given input face ID, searches for matching faces in the
     # collection the face belongs to. You get a face ID when you add a face
     # to the collection using the IndexFaces operation. The operation
@@ -976,23 +1119,7 @@ module Aws::Rekognition
     #   ID of the collection to search.
     #
     # @option params [required, Types::Image] :image
-    #   Provides the source image either as bytes or an S3 object.
-    #
-    #   The region for the S3 bucket containing the S3 object must match the
-    #   region you use for Amazon Rekognition operations.
-    #
-    #   You may need to Base64-encode the image bytes depending on the
-    #   language you are using and whether or not you are using the AWS SDK.
-    #   For more information, see example4.
-    #
-    #   If you use the Amazon CLI to call Amazon Rekognition operations,
-    #   passing image bytes using the Bytes property is not supported. You
-    #   must first upload the image to an Amazon S3 bucket and then call the
-    #   operation using the S3Object property.
-    #
-    #   For Amazon Rekognition to process an S3 object, the user must have
-    #   permission to access the S3 object. For more information, see
-    #   manage-access-resource-policies.
+    #   The input image as bytes or an S3 object.
     #
     # @option params [Integer] :max_faces
     #   Maximum number of faces to return. The operation returns the maximum
@@ -1063,7 +1190,7 @@ module Aws::Rekognition
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rekognition'
-      context[:gem_version] = '1.0.0.rc9'
+      context[:gem_version] = '1.0.0.rc10'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-rekognition/client_api.rb

@@ -18,13 +18,17 @@ module Aws::Rekognition
     Beard = Shapes::StructureShape.new(name: 'Beard')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
     BoundingBox = Shapes::StructureShape.new(name: 'BoundingBox')
+    Celebrity = Shapes::StructureShape.new(name: 'Celebrity')
+    CelebrityList = Shapes::ListShape.new(name: 'CelebrityList')
     CollectionId = Shapes::StringShape.new(name: 'CollectionId')
     CollectionIdList = Shapes::ListShape.new(name: 'CollectionIdList')
     CompareFacesMatch = Shapes::StructureShape.new(name: 'CompareFacesMatch')
     CompareFacesMatchList = Shapes::ListShape.new(name: 'CompareFacesMatchList')
     CompareFacesRequest = Shapes::StructureShape.new(name: 'CompareFacesRequest')
     CompareFacesResponse = Shapes::StructureShape.new(name: 'CompareFacesResponse')
+    CompareFacesUnmatchList = Shapes::ListShape.new(name: 'CompareFacesUnmatchList')
     ComparedFace = Shapes::StructureShape.new(name: 'ComparedFace')
+    ComparedFaceList = Shapes::ListShape.new(name: 'ComparedFaceList')
     ComparedSourceImageFace = Shapes::StructureShape.new(name: 'ComparedSourceImageFace')
     CreateCollectionRequest = Shapes::StructureShape.new(name: 'CreateCollectionRequest')
     CreateCollectionResponse = Shapes::StructureShape.new(name: 'CreateCollectionResponse')
@@ -58,6 +62,8 @@ module Aws::Rekognition
     Float = Shapes::FloatShape.new(name: 'Float')
     Gender = Shapes::StructureShape.new(name: 'Gender')
     GenderType = Shapes::StringShape.new(name: 'GenderType')
+    GetCelebrityInfoRequest = Shapes::StructureShape.new(name: 'GetCelebrityInfoRequest')
+    GetCelebrityInfoResponse = Shapes::StructureShape.new(name: 'GetCelebrityInfoResponse')
     Image = Shapes::StructureShape.new(name: 'Image')
     ImageBlob = Shapes::BlobShape.new(name: 'ImageBlob')
     ImageId = Shapes::StringShape.new(name: 'ImageId')
@@ -90,6 +96,9 @@ module Aws::Rekognition
     Percent = Shapes::FloatShape.new(name: 'Percent')
     Pose = Shapes::StructureShape.new(name: 'Pose')
     ProvisionedThroughputExceededException = Shapes::StructureShape.new(name: 'ProvisionedThroughputExceededException')
+    RecognizeCelebritiesRequest = Shapes::StructureShape.new(name: 'RecognizeCelebritiesRequest')
+    RecognizeCelebritiesResponse = Shapes::StructureShape.new(name: 'RecognizeCelebritiesResponse')
+    RekognitionUniqueId = Shapes::StringShape.new(name: 'RekognitionUniqueId')
     ResourceAlreadyExistsException = Shapes::StructureShape.new(name: 'ResourceAlreadyExistsException')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     S3Bucket = Shapes::StringShape.new(name: 'S3Bucket')
@@ -105,6 +114,8 @@ module Aws::Rekognition
     Sunglasses = Shapes::StructureShape.new(name: 'Sunglasses')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
     UInteger = Shapes::IntegerShape.new(name: 'UInteger')
+    Url = Shapes::StringShape.new(name: 'Url')
+    Urls = Shapes::ListShape.new(name: 'Urls')
 
     AgeRange.add_member(:low, Shapes::ShapeRef.new(shape: UInteger, location_name: "Low"))
     AgeRange.add_member(:high, Shapes::ShapeRef.new(shape: UInteger, location_name: "High"))
@@ -122,6 +133,15 @@ module Aws::Rekognition
     BoundingBox.add_member(:top, Shapes::ShapeRef.new(shape: Float, location_name: "Top"))
     BoundingBox.struct_class = Types::BoundingBox
 
+    Celebrity.add_member(:urls, Shapes::ShapeRef.new(shape: Urls, location_name: "Urls"))
+    Celebrity.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
+    Celebrity.add_member(:id, Shapes::ShapeRef.new(shape: RekognitionUniqueId, location_name: "Id"))
+    Celebrity.add_member(:face, Shapes::ShapeRef.new(shape: ComparedFace, location_name: "Face"))
+    Celebrity.add_member(:match_confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "MatchConfidence"))
+    Celebrity.struct_class = Types::Celebrity
+
+    CelebrityList.member = Shapes::ShapeRef.new(shape: Celebrity)
+
     CollectionIdList.member = Shapes::ShapeRef.new(shape: CollectionId)
 
     CompareFacesMatch.add_member(:similarity, Shapes::ShapeRef.new(shape: Percent, location_name: "Similarity"))
@@ -137,12 +157,22 @@ module Aws::Rekognition
 
     CompareFacesResponse.add_member(:source_image_face, Shapes::ShapeRef.new(shape: ComparedSourceImageFace, location_name: "SourceImageFace"))
     CompareFacesResponse.add_member(:face_matches, Shapes::ShapeRef.new(shape: CompareFacesMatchList, location_name: "FaceMatches"))
+    CompareFacesResponse.add_member(:unmatched_faces, Shapes::ShapeRef.new(shape: CompareFacesUnmatchList, location_name: "UnmatchedFaces"))
+    CompareFacesResponse.add_member(:source_image_orientation_correction, Shapes::ShapeRef.new(shape: OrientationCorrection, location_name: "SourceImageOrientationCorrection"))
+    CompareFacesResponse.add_member(:target_image_orientation_correction, Shapes::ShapeRef.new(shape: OrientationCorrection, location_name: "TargetImageOrientationCorrection"))
     CompareFacesResponse.struct_class = Types::CompareFacesResponse
 
+    CompareFacesUnmatchList.member = Shapes::ShapeRef.new(shape: ComparedFace)
+
     ComparedFace.add_member(:bounding_box, Shapes::ShapeRef.new(shape: BoundingBox, location_name: "BoundingBox"))
     ComparedFace.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
+    ComparedFace.add_member(:landmarks, Shapes::ShapeRef.new(shape: Landmarks, location_name: "Landmarks"))
+    ComparedFace.add_member(:pose, Shapes::ShapeRef.new(shape: Pose, location_name: "Pose"))
+    ComparedFace.add_member(:quality, Shapes::ShapeRef.new(shape: ImageQuality, location_name: "Quality"))
     ComparedFace.struct_class = Types::ComparedFace
 
+    ComparedFaceList.member = Shapes::ShapeRef.new(shape: ComparedFace)
+
     ComparedSourceImageFace.add_member(:bounding_box, Shapes::ShapeRef.new(shape: BoundingBox, location_name: "BoundingBox"))
     ComparedSourceImageFace.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     ComparedSourceImageFace.struct_class = Types::ComparedSourceImageFace
@@ -251,6 +281,13 @@ module Aws::Rekognition
     Gender.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     Gender.struct_class = Types::Gender
 
+    GetCelebrityInfoRequest.add_member(:id, Shapes::ShapeRef.new(shape: RekognitionUniqueId, required: true, location_name: "Id"))
+    GetCelebrityInfoRequest.struct_class = Types::GetCelebrityInfoRequest
+
+    GetCelebrityInfoResponse.add_member(:urls, Shapes::ShapeRef.new(shape: Urls, location_name: "Urls"))
+    GetCelebrityInfoResponse.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
+    GetCelebrityInfoResponse.struct_class = Types::GetCelebrityInfoResponse
+
     Image.add_member(:bytes, Shapes::ShapeRef.new(shape: ImageBlob, location_name: "Bytes"))
     Image.add_member(:s3_object, Shapes::ShapeRef.new(shape: S3Object, location_name: "S3Object"))
     Image.struct_class = Types::Image
@@ -319,6 +356,14 @@ module Aws::Rekognition
     Pose.add_member(:pitch, Shapes::ShapeRef.new(shape: Degree, location_name: "Pitch"))
     Pose.struct_class = Types::Pose
 
+    RecognizeCelebritiesRequest.add_member(:image, Shapes::ShapeRef.new(shape: Image, required: true, location_name: "Image"))
+    RecognizeCelebritiesRequest.struct_class = Types::RecognizeCelebritiesRequest
+
+    RecognizeCelebritiesResponse.add_member(:celebrity_faces, Shapes::ShapeRef.new(shape: CelebrityList, location_name: "CelebrityFaces"))
+    RecognizeCelebritiesResponse.add_member(:unrecognized_faces, Shapes::ShapeRef.new(shape: ComparedFaceList, location_name: "UnrecognizedFaces"))
+    RecognizeCelebritiesResponse.add_member(:orientation_correction, Shapes::ShapeRef.new(shape: OrientationCorrection, location_name: "OrientationCorrection"))
+    RecognizeCelebritiesResponse.struct_class = Types::RecognizeCelebritiesResponse
+
     S3Object.add_member(:bucket, Shapes::ShapeRef.new(shape: S3Bucket, location_name: "Bucket"))
     S3Object.add_member(:name, Shapes::ShapeRef.new(shape: S3ObjectName, location_name: "Name"))
     S3Object.add_member(:version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "Version"))
@@ -353,6 +398,8 @@ module Aws::Rekognition
     Sunglasses.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     Sunglasses.struct_class = Types::Sunglasses
 
+    Urls.member = Shapes::ShapeRef.new(shape: Url)
+
 
     # @api private
     API = Seahorse::Model::Api.new.tap do |api|
@@ -474,6 +521,20 @@ module Aws::Rekognition
         o.errors << Shapes::ShapeRef.new(shape: InvalidImageFormatException)
       end)
 
+      api.add_operation(:get_celebrity_info, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetCelebrityInfo"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetCelebrityInfoRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetCelebrityInfoResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+      end)
+
       api.add_operation(:index_faces, Seahorse::Model::Operation.new.tap do |o|
         o.name = "IndexFaces"
         o.http_method = "POST"
@@ -533,6 +594,23 @@ module Aws::Rekognition
         )
       end)
 
+      api.add_operation(:recognize_celebrities, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "RecognizeCelebrities"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: RecognizeCelebritiesRequest)
+        o.output = Shapes::ShapeRef.new(shape: RecognizeCelebritiesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidS3ObjectException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidImageFormatException)
+        o.errors << Shapes::ShapeRef.new(shape: ImageTooLargeException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidImageFormatException)
+      end)
+
       api.add_operation(:search_faces, Seahorse::Model::Operation.new.tap do |o|
         o.name = "SearchFaces"
         o.http_method = "POST"

data/lib/aws-sdk-rekognition/types.rb

@@ -97,9 +97,46 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # For the provided the bounding box, confidence level that the bounding
-    # box actually contains a face, and the similarity between the face in
-    # the bounding box and the face in the source image.
+    # Provides information about a celebrity recognized by the operation.
+    #
+    # @!attribute [rw] urls
+    #   An array of URLs pointing to additional information about the
+    #   celebrity. If there is no additional information about the
+    #   celebrity, this list is empty.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] name
+    #   The name of the celebrity.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   A unique identifier for the celebrity.
+    #   @return [String]
+    #
+    # @!attribute [rw] face
+    #   Provides information about the celebrity's face, such as its
+    #   location on the image.
+    #   @return [Types::ComparedFace]
+    #
+    # @!attribute [rw] match_confidence
+    #   The confidence, in percentage, that Rekognition has that the
+    #   recognized face is the celebrity.
+    #   @return [Float]
+    #
+    class Celebrity < Struct.new(
+      :urls,
+      :name,
+      :id,
+      :face,
+      :match_confidence)
+      include Aws::Structure
+    end
+
+    # Provides information about a face in a target image that matches the
+    # source image face analysed by `CompareFaces`. The `Face` property
+    # contains the bounding box of the face in the target image. The
+    # `Similarity` property is the confidence that the source image face
+    # matches the face in the bounding box.
     #
     # @!attribute [rw] similarity
     #   Level of confidence that the faces match.
@@ -140,16 +177,16 @@ module Aws::Rekognition
     #       }
     #
     # @!attribute [rw] source_image
-    #   Source image either as bytes or an S3 object
+    #   The source image, either as bytes or as an S3 object.
     #   @return [Types::Image]
     #
     # @!attribute [rw] target_image
-    #   Target image either as bytes or an S3 object
+    #   The target image, either as bytes or as an S3 object.
     #   @return [Types::Image]
     #
     # @!attribute [rw] similarity_threshold
-    #   The minimum level of confidence in the match you want included in
-    #   the result.
+    #   The minimum level of confidence in the face matches that a match
+    #   must meet to be included in the `FaceMatches` array.
     #   @return [Float]
     #
     class CompareFacesRequest < Struct.new(
@@ -160,59 +197,97 @@ module Aws::Rekognition
     end
 
     # @!attribute [rw] source_image_face
-    #   The face from the source image that was used for comparison.
+    #   The face in the source image that was used for comparison.
     #   @return [Types::ComparedSourceImageFace]
     #
     # @!attribute [rw] face_matches
-    #   Provides an array of `CompareFacesMatch` objects. Each object
-    #   provides the bounding box, confidence that the bounding box contains
-    #   a face, and the similarity between the face in the bounding box and
-    #   the face in the source image.
+    #   An array of faces in the target image that match the source image
+    #   face. Each `CompareFacesMatch` object provides the bounding box, the
+    #   confidence level that the bounding box contains a face, and the
+    #   similarity score for the face in the bounding box and the face in
+    #   the source image.
     #   @return [Array<Types::CompareFacesMatch>]
     #
+    # @!attribute [rw] unmatched_faces
+    #   An array of faces in the target image that did not match the source
+    #   image face.
+    #   @return [Array<Types::ComparedFace>]
+    #
+    # @!attribute [rw] source_image_orientation_correction
+    #   The orientation of the source image (counterclockwise direction). If
+    #   your application displays the source image, you can use this value
+    #   to correct image orientation. The bounding box coordinates returned
+    #   in `SourceImageFace` represent the location of the face before the
+    #   image orientation is corrected.
+    #
+    #   <note markdown="1"> If the source image is in .jpeg format, it might contain
+    #   exchangeable image (Exif) metadata that includes the image's
+    #   orientation. If the Exif metadata for the source image populates the
+    #   orientation field, the value of `OrientationCorrection` is null and
+    #   the `SourceImageFace` bounding box coordinates represent the
+    #   location of the face after Exif metadata is used to correct the
+    #   orientation. Images in .png format don't contain Exif metadata.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @!attribute [rw] target_image_orientation_correction
+    #   The orientation of the target image (in counterclockwise direction).
+    #   If your application displays the target image, you can use this
+    #   value to correct the orientation of the image. The bounding box
+    #   coordinates returned in `FaceMatches` and `UnmatchedFaces` represent
+    #   face locations before the image orientation is corrected.
+    #
+    #   <note markdown="1"> If the target image is in .jpg format, it might contain Exif
+    #   metadata that includes the orientation of the image. If the Exif
+    #   metadata for the target image populates the orientation field, the
+    #   value of `OrientationCorrection` is null and the bounding box
+    #   coordinates in `FaceMatches` and `UnmatchedFaces` represent the
+    #   location of the face after Exif metadata is used to correct the
+    #   orientation. Images in .png format don't contain Exif metadata.
+    #
+    #    </note>
+    #   @return [String]
+    #
     class CompareFacesResponse < Struct.new(
       :source_image_face,
-      :face_matches)
+      :face_matches,
+      :unmatched_faces,
+      :source_image_orientation_correction,
+      :target_image_orientation_correction)
       include Aws::Structure
     end
 
-    # Provides face metadata (bounding box and confidence that the bounding
-    # box actually contains a face).
+    # Provides face metadata for target image faces that are analysed by
+    # `CompareFaces` and `RecognizeCelebrities`.
     #
     # @!attribute [rw] bounding_box
-    #   Identifies the bounding box around the object or face. The `left`
-    #   (x-coordinate) and `top` (y-coordinate) are coordinates representing
-    #   the top and left sides of the bounding box. Note that the upper-left
-    #   corner of the image is the origin (0,0).
-    #
-    #   The `top` and `left` values returned are ratios of the overall image
-    #   size. For example, if the input image is 700x200 pixels, and the
-    #   top-left coordinate of the bounding box is 350x50 pixels, the API
-    #   returns a `left` value of 0.5 (350/700) and a `top` value of 0.25
-    #   (50/200).
-    #
-    #   The `width` and `height` values represent the dimensions of the
-    #   bounding box as a ratio of the overall image dimension. For example,
-    #   if the input image is 700x200 pixels, and the bounding box width is
-    #   70 pixels, the width returned is 0.1.
-    #
-    #   <note markdown="1"> The bounding box coordinates can have negative values. For example,
-    #   if Amazon Rekognition is able to detect a face that is at the image
-    #   edge and is only partially visible, the service can return
-    #   coordinates that are outside the image bounds and, depending on the
-    #   image edge, you might get negative values or values greater than 1
-    #   for the `left` or `top` values.
-    #
-    #    </note>
+    #   Bounding box of the face.
     #   @return [Types::BoundingBox]
     #
     # @!attribute [rw] confidence
     #   Level of confidence that what the bounding box contains is a face.
     #   @return [Float]
     #
+    # @!attribute [rw] landmarks
+    #   An array of facial landmarks.
+    #   @return [Array<Types::Landmark>]
+    #
+    # @!attribute [rw] pose
+    #   Indicates the pose of the face as determined by its pitch, roll, and
+    #   yaw.
+    #   @return [Types::Pose]
+    #
+    # @!attribute [rw] quality
+    #   Identifies face image brightness and sharpness.
+    #   @return [Types::ImageQuality]
+    #
     class ComparedFace < Struct.new(
       :bounding_box,
-      :confidence)
+      :confidence,
+      :landmarks,
+      :pose,
+      :quality)
       include Aws::Structure
     end
 
@@ -223,30 +298,7 @@ module Aws::Rekognition
     # for this comparison.
     #
     # @!attribute [rw] bounding_box
-    #   Identifies the bounding box around the object or face. The `left`
-    #   (x-coordinate) and `top` (y-coordinate) are coordinates representing
-    #   the top and left sides of the bounding box. Note that the upper-left
-    #   corner of the image is the origin (0,0).
-    #
-    #   The `top` and `left` values returned are ratios of the overall image
-    #   size. For example, if the input image is 700x200 pixels, and the
-    #   top-left coordinate of the bounding box is 350x50 pixels, the API
-    #   returns a `left` value of 0.5 (350/700) and a `top` value of 0.25
-    #   (50/200).
-    #
-    #   The `width` and `height` values represent the dimensions of the
-    #   bounding box as a ratio of the overall image dimension. For example,
-    #   if the input image is 700x200 pixels, and the bounding box width is
-    #   70 pixels, the width returned is 0.1.
-    #
-    #   <note markdown="1"> The bounding box coordinates can have negative values. For example,
-    #   if Amazon Rekognition is able to detect a face that is at the image
-    #   edge and is only partially visible, the service can return
-    #   coordinates that are outside the image bounds and, depending on the
-    #   image edge, you might get negative values or values greater than 1
-    #   for the `left` or `top` values.
-    #
-    #    </note>
+    #   Bounding box of the face.
     #   @return [Types::BoundingBox]
     #
     # @!attribute [rw] confidence
@@ -367,13 +419,13 @@ module Aws::Rekognition
     #   @return [Types::Image]
     #
     # @!attribute [rw] attributes
-    #   A list of facial attributes you want to be returned. This can be the
-    #   default list of attributes or all attributes. If you don't specify
-    #   a value for `Attributes` or if you specify `["DEFAULT"]`, the API
-    #   returns the following subset of facial attributes: `BoundingBox`,
-    #   `Confidence`, `Pose`, `Quality` and `Landmarks`. If you provide
-    #   `["ALL"]`, all facial attributes are returned but the operation will
-    #   take longer to complete.
+    #   An array of facial attributes you want to be returned. This can be
+    #   the default list of attributes or all attributes. If you don't
+    #   specify a value for `Attributes` or if you specify `["DEFAULT"]`,
+    #   the API returns the following subset of facial attributes:
+    #   `BoundingBox`, `Confidence`, `Pose`, `Quality` and `Landmarks`. If
+    #   you provide `["ALL"]`, all facial attributes are returned but the
+    #   operation will take longer to complete.
     #
     #   If you provide both, `["ALL", "DEFAULT"]`, the service uses a
     #   logical AND operator to determine which attributes to return (in
@@ -391,19 +443,19 @@ module Aws::Rekognition
     #   @return [Array<Types::FaceDetail>]
     #
     # @!attribute [rw] orientation_correction
-    #   The algorithm detects the image orientation. If it detects that the
-    #   image was rotated, it returns the degrees of rotation. If your
-    #   application is displaying the image, you can use this value to
-    #   adjust the orientation.
-    #
-    #   For example, if the service detects that the input image was rotated
-    #   by 90 degrees, it corrects orientation, performs face detection, and
-    #   then returns the faces. That is, the bounding box coordinates in the
-    #   response are based on the corrected orientation.
-    #
-    #   <note markdown="1"> If the source image Exif metadata populates the orientation field,
-    #   Amazon Rekognition does not perform orientation correction and the
-    #   value of OrientationCorrection will be nil.
+    #   The orientation of the input image (counter-clockwise direction). If
+    #   your application displays the image, you can use this value to
+    #   correct image orientation. The bounding box coordinates returned in
+    #   `FaceDetails` represent face locations before the image orientation
+    #   is corrected.
+    #
+    #   <note markdown="1"> If the input image is in .jpeg format, it might contain exchangeable
+    #   image (Exif) metadata that includes the image's orientation. If so,
+    #   and the Exif metadata for the input image populates the orientation
+    #   field, the value of `OrientationCorrection` is null and the
+    #   `FaceDetails` bounding box coordinates represent face locations
+    #   after Exif metadata is used to correct the image orientation. Images
+    #   in .png format don't contain Exif metadata.
     #
     #    </note>
     #   @return [String]
@@ -462,16 +514,15 @@ module Aws::Rekognition
     #   @return [Array<Types::Label>]
     #
     # @!attribute [rw] orientation_correction
-    #   Amazon Rekognition returns the orientation of the input image that
-    #   was detected (clockwise direction). If your application displays the
-    #   image, you can use this value to correct the orientation. If Amazon
-    #   Rekognition detects that the input image was rotated (for example,
-    #   by 90 degrees), it first corrects the orientation before detecting
-    #   the labels.
-    #
-    #   <note markdown="1"> If the source image Exif metadata populates the orientation field,
+    #   The orientation of the input image (counter-clockwise direction). If
+    #   your application displays the image, you can use this value to
+    #   correct the orientation. If Amazon Rekognition detects that the
+    #   input image was rotated (for example, by 90 degrees), it first
+    #   corrects the orientation before detecting the labels.
+    #
+    #   <note markdown="1"> If the input image Exif metadata populates the orientation field,
     #   Amazon Rekognition does not perform orientation correction and the
-    #   value of OrientationCorrection will be nil.
+    #   value of OrientationCorrection will be null.
     #
     #    </note>
     #   @return [String]
@@ -498,23 +549,7 @@ module Aws::Rekognition
     #       }
     #
     # @!attribute [rw] image
-    #   Provides the source image either as bytes or an S3 object.
-    #
-    #   The region for the S3 bucket containing the S3 object must match the
-    #   region you use for Amazon Rekognition operations.
-    #
-    #   You may need to Base64-encode the image bytes depending on the
-    #   language you are using and whether or not you are using the AWS SDK.
-    #   For more information, see example4.
-    #
-    #   If you use the Amazon CLI to call Amazon Rekognition operations,
-    #   passing image bytes using the Bytes property is not supported. You
-    #   must first upload the image to an Amazon S3 bucket and then call the
-    #   operation using the S3Object property.
-    #
-    #   For Amazon Rekognition to process an S3 object, the user must have
-    #   permission to access the S3 object. For more information, see
-    #   manage-access-resource-policies.
+    #   The input image as bytes or an S3 object.
     #   @return [Types::Image]
     #
     # @!attribute [rw] min_confidence
@@ -533,7 +568,7 @@ module Aws::Rekognition
     end
 
     # @!attribute [rw] moderation_labels
-    #   A list of labels for explicit or suggestive adult content found in
+    #   An array of labels for explicit or suggestive adult content found in
     #   the image. The list includes the top-level label and each child
     #   label detected in the image. This is useful for filtering specific
     #   categories of content.
@@ -597,41 +632,18 @@ module Aws::Rekognition
     end
 
     # Describes the face properties such as the bounding box, face ID, image
-    # ID of the source image, and external image ID that you assigned.
+    # ID of the input image, and external image ID that you assigned.
     #
     # @!attribute [rw] face_id
     #   Unique identifier that Amazon Rekognition assigns to the face.
     #   @return [String]
     #
     # @!attribute [rw] bounding_box
-    #   Identifies the bounding box around the object or face. The `left`
-    #   (x-coordinate) and `top` (y-coordinate) are coordinates representing
-    #   the top and left sides of the bounding box. Note that the upper-left
-    #   corner of the image is the origin (0,0).
-    #
-    #   The `top` and `left` values returned are ratios of the overall image
-    #   size. For example, if the input image is 700x200 pixels, and the
-    #   top-left coordinate of the bounding box is 350x50 pixels, the API
-    #   returns a `left` value of 0.5 (350/700) and a `top` value of 0.25
-    #   (50/200).
-    #
-    #   The `width` and `height` values represent the dimensions of the
-    #   bounding box as a ratio of the overall image dimension. For example,
-    #   if the input image is 700x200 pixels, and the bounding box width is
-    #   70 pixels, the width returned is 0.1.
-    #
-    #   <note markdown="1"> The bounding box coordinates can have negative values. For example,
-    #   if Amazon Rekognition is able to detect a face that is at the image
-    #   edge and is only partially visible, the service can return
-    #   coordinates that are outside the image bounds and, depending on the
-    #   image edge, you might get negative values or values greater than 1
-    #   for the `left` or `top` values.
-    #
-    #    </note>
+    #   Bounding box of the face.
     #   @return [Types::BoundingBox]
     #
     # @!attribute [rw] image_id
-    #   Unique identifier that Amazon Rekognition assigns to the source
+    #   Unique identifier that Amazon Rekognition assigns to the input
     #   image.
     #   @return [String]
     #
@@ -710,11 +722,11 @@ module Aws::Rekognition
     #   @return [Array<Types::Emotion>]
     #
     # @!attribute [rw] landmarks
-    #   Indicates the location of the landmark on the face.
+    #   Indicates the location of landmarks on the face.
     #   @return [Array<Types::Landmark>]
     #
     # @!attribute [rw] pose
-    #   Indicates the pose of the face as determined by pitch, roll, and the
+    #   Indicates the pose of the face as determined by its pitch, roll, and
     #   yaw.
     #   @return [Types::Pose]
     #
@@ -771,7 +783,7 @@ module Aws::Rekognition
     #
     # @!attribute [rw] face
     #   Describes the face properties such as the bounding box, face ID,
-    #   image ID of the source image, and external image ID that you
+    #   image ID of the input image, and external image ID that you
     #   assigned.
     #   @return [Types::Face]
     #
@@ -802,15 +814,53 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # Provides the source image either as bytes or an S3 object.
+    # @note When making an API call, you may pass GetCelebrityInfoRequest
+    #   data as a hash:
+    #
+    #       {
+    #         id: "RekognitionUniqueId", # required
+    #       }
+    #
+    # @!attribute [rw] id
+    #   The ID for the celebrity. You get the celebrity ID from a call to
+    #   the operation, which recognizes celebrities in an image.
+    #   @return [String]
+    #
+    class GetCelebrityInfoRequest < Struct.new(
+      :id)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] urls
+    #   An array of URLs pointing to additional celebrity information.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] name
+    #   The name of the celebrity.
+    #   @return [String]
+    #
+    class GetCelebrityInfoResponse < Struct.new(
+      :urls,
+      :name)
+      include Aws::Structure
+    end
+
+    # Provides the input image either as bytes or an S3 object.
+    #
+    # You pass image bytes to a Rekognition API operation by using the
+    # `Bytes` property. For example, you would use the `Bytes` property to
+    # pass an image loaded from a local file system. Image bytes passed by
+    # using the `Bytes` property must be base64-encoded. Your code may not
+    # need to encode image bytes if you are using an AWS SDK to call
+    # Rekognition API operations. For more information, see example4.
+    #
+    # You pass images stored in an S3 bucket to a Rekognition API operation
+    # by using the `S3Object` property. Images stored in an S3 bucket do not
+    # need to be base64-encoded.
     #
     # The region for the S3 bucket containing the S3 object must match the
     # region you use for Amazon Rekognition operations.
     #
-    # You may need to Base64-encode the image bytes depending on the
-    # language you are using and whether or not you are using the AWS SDK.
-    # For more information, see example4.
-    #
     # If you use the Amazon CLI to call Amazon Rekognition operations,
     # passing image bytes using the Bytes property is not supported. You
     # must first upload the image to an Amazon S3 bucket and then call the
@@ -889,23 +939,7 @@ module Aws::Rekognition
     #   @return [String]
     #
     # @!attribute [rw] image
-    #   Provides the source image either as bytes or an S3 object.
-    #
-    #   The region for the S3 bucket containing the S3 object must match the
-    #   region you use for Amazon Rekognition operations.
-    #
-    #   You may need to Base64-encode the image bytes depending on the
-    #   language you are using and whether or not you are using the AWS SDK.
-    #   For more information, see example4.
-    #
-    #   If you use the Amazon CLI to call Amazon Rekognition operations,
-    #   passing image bytes using the Bytes property is not supported. You
-    #   must first upload the image to an Amazon S3 bucket and then call the
-    #   operation using the S3Object property.
-    #
-    #   For Amazon Rekognition to process an S3 object, the user must have
-    #   permission to access the S3 object. For more information, see
-    #   manage-access-resource-policies.
+    #   The input image as bytes or an S3 object.
     #   @return [Types::Image]
     #
     # @!attribute [rw] external_image_id
@@ -913,7 +947,7 @@ module Aws::Rekognition
     #   @return [String]
     #
     # @!attribute [rw] detection_attributes
-    #   A list of facial attributes that you want to be returned. This can
+    #   An array of facial attributes that you want to be returned. This can
     #   be the default list of attributes or all attributes. If you don't
     #   specify a value for `Attributes` or if you specify `["DEFAULT"]`,
     #   the API returns the following subset of facial attributes:
@@ -940,14 +974,18 @@ module Aws::Rekognition
     #   @return [Array<Types::FaceRecord>]
     #
     # @!attribute [rw] orientation_correction
-    #   The algorithm detects the image orientation. If it detects that the
-    #   image was rotated, it returns the degree of rotation. You can use
-    #   this value to correct the orientation and also appropriately analyze
-    #   the bounding box coordinates that are returned.
-    #
-    #   <note markdown="1"> If the source image Exif metadata populates the orientation field,
-    #   Amazon Rekognition does not perform orientation correction and the
-    #   value of OrientationCorrection will be nil.
+    #   The orientation of the input image (counterclockwise direction). If
+    #   your application displays the image, you can use this value to
+    #   correct image orientation. The bounding box coordinates returned in
+    #   `FaceRecords` represent face locations before the image orientation
+    #   is corrected.
+    #
+    #   <note markdown="1"> If the input image is in jpeg format, it might contain exchangeable
+    #   image (Exif) metadata. If so, and the Exif metadata populates the
+    #   orientation field, the value of `OrientationCorrection` is null and
+    #   the bounding box coordinates in `FaceRecords` represent face
+    #   locations after Exif metadata is used to correct the image
+    #   orientation. Images in .png format don't contain Exif metadata.
     #
     #    </note>
     #   @return [String]
@@ -1089,8 +1127,7 @@ module Aws::Rekognition
 
     # Provides information about a single type of moderated content found in
     # an image. Each type of moderated content has a label within a
-    # hierarchical taxonomy. For more information, see
-    # howitworks-moderateimage.
+    # hierarchical taxonomy. For more information, see image-moderation.
     #
     # @!attribute [rw] confidence
     #   Specifies the confidence that Amazon Rekognition has that the label
@@ -1152,7 +1189,7 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # Indicates the pose of the face as determined by pitch, roll, and the
+    # Indicates the pose of the face as determined by its pitch, roll, and
     # yaw.
     #
     # @!attribute [rw] roll
@@ -1174,6 +1211,64 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass RecognizeCelebritiesRequest
+    #   data as a hash:
+    #
+    #       {
+    #         image: { # required
+    #           bytes: "data",
+    #           s3_object: {
+    #             bucket: "S3Bucket",
+    #             name: "S3ObjectName",
+    #             version: "S3ObjectVersion",
+    #           },
+    #         },
+    #       }
+    #
+    # @!attribute [rw] image
+    #   The input image to use for celebrity recognition.
+    #   @return [Types::Image]
+    #
+    class RecognizeCelebritiesRequest < Struct.new(
+      :image)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] celebrity_faces
+    #   Details about each celebrity found in the image. Amazon Rekognition
+    #   can detect a maximum of 15 celebrities in an image.
+    #   @return [Array<Types::Celebrity>]
+    #
+    # @!attribute [rw] unrecognized_faces
+    #   Details about each unrecognized face in the image.
+    #   @return [Array<Types::ComparedFace>]
+    #
+    # @!attribute [rw] orientation_correction
+    #   The orientation of the input image (counterclockwise direction). If
+    #   your application displays the image, you can use this value to
+    #   correct the orientation. The bounding box coordinates returned in
+    #   `CelebrityFaces` and `UnrecognizedFaces` represent face locations
+    #   before the image orientation is corrected.
+    #
+    #   <note markdown="1"> If the input image is in .jpeg format, it might contain exchangeable
+    #   image (Exif) metadata that includes the image's orientation. If so,
+    #   and the Exif metadata for the input image populates the orientation
+    #   field, the value of `OrientationCorrection` is null and the
+    #   `CelebrityFaces` and `UnrecognizedFaces` bounding box coordinates
+    #   represent face locations after Exif metadata is used to correct the
+    #   image orientation. Images in .png format don't contain Exif
+    #   metadata.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    class RecognizeCelebritiesResponse < Struct.new(
+      :celebrity_faces,
+      :unrecognized_faces,
+      :orientation_correction)
+      include Aws::Structure
+    end
+
     # Provides the S3 bucket name and object name.
     #
     # The region for the S3 bucket containing the S3 object must match the
@@ -1234,23 +1329,7 @@ module Aws::Rekognition
     #   @return [String]
     #
     # @!attribute [rw] image
-    #   Provides the source image either as bytes or an S3 object.
-    #
-    #   The region for the S3 bucket containing the S3 object must match the
-    #   region you use for Amazon Rekognition operations.
-    #
-    #   You may need to Base64-encode the image bytes depending on the
-    #   language you are using and whether or not you are using the AWS SDK.
-    #   For more information, see example4.
-    #
-    #   If you use the Amazon CLI to call Amazon Rekognition operations,
-    #   passing image bytes using the Bytes property is not supported. You
-    #   must first upload the image to an Amazon S3 bucket and then call the
-    #   operation using the S3Object property.
-    #
-    #   For Amazon Rekognition to process an S3 object, the user must have
-    #   permission to access the S3 object. For more information, see
-    #   manage-access-resource-policies.
+    #   The input image as bytes or an S3 object.
     #   @return [Types::Image]
     #
     # @!attribute [rw] max_faces

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rekognition
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc9
+  version: 1.0.0.rc10
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-05-23 00:00:00.000000000 Z
+date: 2017-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc12
+        version: 3.0.0.rc13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc12
+        version: 3.0.0.rc13
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement