[aws-android-sdk-rekognition] Update models to latest (#1070)

Author: awsmobilesdk

aws-android-sdk-rekognition/src/main/java/com/amazonaws/services/rekognition/AmazonRekognition.java

@@ -22,10 +22,10 @@
  * Structure containing the estimated age range, in years, for a face.
  * </p>
  * <p>
- * Rekognition estimates an age-range for faces detected in the input image.
- * Estimated age ranges can overlap; a face of a 5 year old may have an
- * estimated range of 4-6 whilst the face of a 6 year old may have an estimated
- * range of 4-8.
+ * Amazon Rekognition estimates an age range for faces detected in the input
+ * image. Estimated age ranges can overlap. A face of a 5-year-old might have an
+ * estimated range of 4-6, while the face of a 6-year-old might have an
+ * estimated range of 4-8.
  * </p>
  */
 public class AgeRange implements Serializable {

aws-android-sdk-rekognition/src/main/java/com/amazonaws/services/rekognition/AmazonRekognitionClient.java

@@ -19,7 +19,7 @@
 
 /**
  * <p>
- * Identifies the bounding box around the object, face or text. The
+ * Identifies the bounding box around the label, face, or text. The
  * <code>left</code> (x-coordinate) and <code>top</code> (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).

aws-android-sdk-rekognition/src/main/java/com/amazonaws/services/rekognition/model/AgeRange.java

@@ -19,7 +19,8 @@
 
 /**
  * <p>
- * Provides information about a celebrity recognized by the operation.
+ * Provides information about a celebrity recognized by the
+ * <a>RecognizeCelebrities</a> operation.
  * </p>
  */
 public class Celebrity implements Serializable {
@@ -59,8 +60,8 @@ public class Celebrity implements Serializable {
 
     /**
      * <p>
-     * The confidence, in percentage, that Rekognition has that the recognized
-     * face is the celebrity.
+     * The confidence, in percentage, that Amazon Rekognition has that the
+     * recognized face is the celebrity.
      * </p>
      * <p>
      * <b>Constraints:</b><br/>
@@ -310,16 +311,16 @@ public Celebrity withFace(ComparedFace face) {
 
     /**
      * <p>
-     * The confidence, in percentage, that Rekognition has that the recognized
-     * face is the celebrity.
+     * The confidence, in percentage, that Amazon Rekognition has that the
+     * recognized face is the celebrity.
      * </p>
      * <p>
      * <b>Constraints:</b><br/>
      * <b>Length: </b>0 - 100<br/>
      *
      * @return <p>
-     *         The confidence, in percentage, that Rekognition has that the
-     *         recognized face is the celebrity.
+     *         The confidence, in percentage, that Amazon Rekognition has that
+     *         the recognized face is the celebrity.
      *         </p>
      */
     public Float getMatchConfidence() {
@@ -328,16 +329,16 @@ public Float getMatchConfidence() {
 
     /**
      * <p>
-     * The confidence, in percentage, that Rekognition has that the recognized
-     * face is the celebrity.
+     * The confidence, in percentage, that Amazon Rekognition has that the
+     * recognized face is the celebrity.
      * </p>
      * <p>
      * <b>Constraints:</b><br/>
      * <b>Length: </b>0 - 100<br/>
      *
      * @param matchConfidence <p>
-     *            The confidence, in percentage, that Rekognition has that the
-     *            recognized face is the celebrity.
+     *            The confidence, in percentage, that Amazon Rekognition has
+     *            that the recognized face is the celebrity.
      *            </p>
      */
     public void setMatchConfidence(Float matchConfidence) {
@@ -346,8 +347,8 @@ public void setMatchConfidence(Float matchConfidence) {
 
     /**
      * <p>
-     * The confidence, in percentage, that Rekognition has that the recognized
-     * face is the celebrity.
+     * The confidence, in percentage, that Amazon Rekognition has that the
+     * recognized face is the celebrity.
      * </p>
      * <p>
      * Returns a reference to this object so that method calls can be chained
@@ -357,8 +358,8 @@ public void setMatchConfidence(Float matchConfidence) {
      * <b>Length: </b>0 - 100<br/>
      *
      * @param matchConfidence <p>
-     *            The confidence, in percentage, that Rekognition has that the
-     *            recognized face is the celebrity.
+     *            The confidence, in percentage, that Amazon Rekognition has
+     *            that the recognized face is the celebrity.
      *            </p>
      * @return A reference to this updated object so that method calls can be
      *         chained together.

aws-android-sdk-rekognition/src/main/java/com/amazonaws/services/rekognition/model/BoundingBox.java

@@ -20,7 +20,7 @@
 /**
  * <p>
  * Provides information about a face in a target image that matches the source
- * image face analysed by <code>CompareFaces</code>. The <code>Face</code>
+ * image face analyzed by <code>CompareFaces</code>. The <code>Face</code>
  * property contains the bounding box of the face in the target image. The
  * <code>Similarity</code> property is the confidence that the source image face
  * matches the face in the bounding box.

aws-android-sdk-rekognition/src/main/java/com/amazonaws/services/rekognition/model/Celebrity.java

@@ -32,9 +32,9 @@
  * </note>
  * <p>
  * You pass the input and target images either as base64-encoded image bytes or
- * as a references to images in an Amazon S3 bucket. If you use the Amazon CLI
- * to call Amazon Rekognition operations, passing image bytes is not supported.
- * The image must be either a PNG or JPEG formatted file.
+ * as references to images in an Amazon S3 bucket. If you use the AWS CLI to
+ * call Amazon Rekognition operations, passing image bytes isn't supported. The
+ * image must be formatted as a PNG or JPEG file.
  * </p>
  * <p>
  * In response, the operation returns an array of face matches ordered by
@@ -91,6 +91,12 @@ public class CompareFacesRequest extends AmazonWebServiceRequest implements Seri
      * AWS CLI to call Amazon Rekognition operations, passing base64-encoded
      * image bytes is not supported.
      * </p>
+     * <p>
+     * If you are using an AWS SDK to call Amazon Rekognition, you might not
+     * need to base64-encode image bytes passed using the <code>Bytes</code>
+     * field. For more information, see Images in the Amazon Rekognition
+     * developer guide.
+     * </p>
      */
     private Image sourceImage;
 
@@ -100,6 +106,12 @@ public class CompareFacesRequest extends AmazonWebServiceRequest implements Seri
      * AWS CLI to call Amazon Rekognition operations, passing base64-encoded
      * image bytes is not supported.
      * </p>
+     * <p>
+     * If you are using an AWS SDK to call Amazon Rekognition, you might not
+     * need to base64-encode image bytes passed using the <code>Bytes</code>
+     * field. For more information, see Images in the Amazon Rekognition
+     * developer guide.
+     * </p>
      */
     private Image targetImage;
 
@@ -132,11 +144,23 @@ public CompareFacesRequest() {
      *            you use the AWS CLI to call Amazon Rekognition operations,
      *            passing base64-encoded image bytes is not supported.
      *            </p>
+     *            <p>
+     *            If you are using an AWS SDK to call Amazon Rekognition, you
+     *            might not need to base64-encode image bytes passed using the
+     *            <code>Bytes</code> field. For more information, see Images in
+     *            the Amazon Rekognition developer guide.
+     *            </p>
      * @param targetImage <p>
      *            The target image as base64-encoded bytes or an S3 object. If
      *            you use the AWS CLI to call Amazon Rekognition operations,
      *            passing base64-encoded image bytes is not supported.
      *            </p>
+     *            <p>
+     *            If you are using an AWS SDK to call Amazon Rekognition, you
+     *            might not need to base64-encode image bytes passed using the
+     *            <code>Bytes</code> field. For more information, see Images in
+     *            the Amazon Rekognition developer guide.
+     *            </p>
      */
     public CompareFacesRequest(Image sourceImage, Image targetImage) {
         setSourceImage(sourceImage);
@@ -149,12 +173,24 @@ public CompareFacesRequest(Image sourceImage, Image targetImage) {
      * AWS CLI to call Amazon Rekognition operations, passing base64-encoded
      * image bytes is not supported.
      * </p>
+     * <p>
+     * If you are using an AWS SDK to call Amazon Rekognition, you might not
+     * need to base64-encode image bytes passed using the <code>Bytes</code>
+     * field. For more information, see Images in the Amazon Rekognition
+     * developer guide.
+     * </p>
      *
      * @return <p>
      *         The input image as base64-encoded bytes or an S3 object. If you
      *         use the AWS CLI to call Amazon Rekognition operations, passing
      *         base64-encoded image bytes is not supported.
      *         </p>
+     *         <p>
+     *         If you are using an AWS SDK to call Amazon Rekognition, you might
+     *         not need to base64-encode image bytes passed using the
+     *         <code>Bytes</code> field. For more information, see Images in the
+     *         Amazon Rekognition developer guide.
+     *         </p>
      */
     public Image getSourceImage() {
         return sourceImage;
@@ -166,12 +202,24 @@ public Image getSourceImage() {
      * AWS CLI to call Amazon Rekognition operations, passing base64-encoded
      * image bytes is not supported.
      * </p>
+     * <p>
+     * If you are using an AWS SDK to call Amazon Rekognition, you might not
+     * need to base64-encode image bytes passed using the <code>Bytes</code>
+     * field. For more information, see Images in the Amazon Rekognition
+     * developer guide.
+     * </p>
      *
      * @param sourceImage <p>
      *            The input image as base64-encoded bytes or an S3 object. If
      *            you use the AWS CLI to call Amazon Rekognition operations,
      *            passing base64-encoded image bytes is not supported.
      *            </p>
+     *            <p>
+     *            If you are using an AWS SDK to call Amazon Rekognition, you
+     *            might not need to base64-encode image bytes passed using the
+     *            <code>Bytes</code> field. For more information, see Images in
+     *            the Amazon Rekognition developer guide.
+     *            </p>
      */
     public void setSourceImage(Image sourceImage) {
         this.sourceImage = sourceImage;
@@ -184,6 +232,12 @@ public void setSourceImage(Image sourceImage) {
      * image bytes is not supported.
      * </p>
      * <p>
+     * If you are using an AWS SDK to call Amazon Rekognition, you might not
+     * need to base64-encode image bytes passed using the <code>Bytes</code>
+     * field. For more information, see Images in the Amazon Rekognition
+     * developer guide.
+     * </p>
+     * <p>
      * Returns a reference to this object so that method calls can be chained
      * together.
      *
@@ -192,6 +246,12 @@ public void setSourceImage(Image sourceImage) {
      *            you use the AWS CLI to call Amazon Rekognition operations,
      *            passing base64-encoded image bytes is not supported.
      *            </p>
+     *            <p>
+     *            If you are using an AWS SDK to call Amazon Rekognition, you
+     *            might not need to base64-encode image bytes passed using the
+     *            <code>Bytes</code> field. For more information, see Images in
+     *            the Amazon Rekognition developer guide.
+     *            </p>
      * @return A reference to this updated object so that method calls can be
      *         chained together.
      */
@@ -206,12 +266,24 @@ public CompareFacesRequest withSourceImage(Image sourceImage) {
      * AWS CLI to call Amazon Rekognition operations, passing base64-encoded
      * image bytes is not supported.
      * </p>
+     * <p>
+     * If you are using an AWS SDK to call Amazon Rekognition, you might not
+     * need to base64-encode image bytes passed using the <code>Bytes</code>
+     * field. For more information, see Images in the Amazon Rekognition
+     * developer guide.
+     * </p>
      *
      * @return <p>
      *         The target image as base64-encoded bytes or an S3 object. If you
      *         use the AWS CLI to call Amazon Rekognition operations, passing
      *         base64-encoded image bytes is not supported.
      *         </p>
+     *         <p>
+     *         If you are using an AWS SDK to call Amazon Rekognition, you might
+     *         not need to base64-encode image bytes passed using the
+     *         <code>Bytes</code> field. For more information, see Images in the
+     *         Amazon Rekognition developer guide.
+     *         </p>
      */
     public Image getTargetImage() {
         return targetImage;
@@ -223,12 +295,24 @@ public Image getTargetImage() {
      * AWS CLI to call Amazon Rekognition operations, passing base64-encoded
      * image bytes is not supported.
      * </p>
+     * <p>
+     * If you are using an AWS SDK to call Amazon Rekognition, you might not
+     * need to base64-encode image bytes passed using the <code>Bytes</code>
+     * field. For more information, see Images in the Amazon Rekognition
+     * developer guide.
+     * </p>
      *
      * @param targetImage <p>
      *            The target image as base64-encoded bytes or an S3 object. If
      *            you use the AWS CLI to call Amazon Rekognition operations,
      *            passing base64-encoded image bytes is not supported.
      *            </p>
+     *            <p>
+     *            If you are using an AWS SDK to call Amazon Rekognition, you
+     *            might not need to base64-encode image bytes passed using the
+     *            <code>Bytes</code> field. For more information, see Images in
+     *            the Amazon Rekognition developer guide.
+     *            </p>
      */
     public void setTargetImage(Image targetImage) {
         this.targetImage = targetImage;
@@ -241,6 +325,12 @@ public void setTargetImage(Image targetImage) {
      * image bytes is not supported.
      * </p>
      * <p>
+     * If you are using an AWS SDK to call Amazon Rekognition, you might not
+     * need to base64-encode image bytes passed using the <code>Bytes</code>
+     * field. For more information, see Images in the Amazon Rekognition
+     * developer guide.
+     * </p>
+     * <p>
      * Returns a reference to this object so that method calls can be chained
      * together.
      *
@@ -249,6 +339,12 @@ public void setTargetImage(Image targetImage) {
      *            you use the AWS CLI to call Amazon Rekognition operations,
      *            passing base64-encoded image bytes is not supported.
      *            </p>
+     *            <p>
+     *            If you are using an AWS SDK to call Amazon Rekognition, you
+     *            might not need to base64-encode image bytes passed using the
+     *            <code>Bytes</code> field. For more information, see Images in
+     *            the Amazon Rekognition developer guide.
+     *            </p>
      * @return A reference to this updated object so that method calls can be
      *         chained together.
      */