Class: Google::Cloud::Vision::V1::FaceAnnotation

Inherits:

Object

• Object
• Google::Cloud::Vision::V1::FaceAnnotation

Defined in:

lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb

Overview

A face annotation object contains the results of face detection.

Defined Under Namespace

Classes: Landmark

Instance Attribute Summary

• #anger_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

  Anger likelihood.

• #blurred_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

  Blurred likelihood.

• #bounding_poly ⇒ Google::Cloud::Vision::V1::BoundingPoly

  The bounding polygon around the face.

• #detection_confidence ⇒ Float

  Detection confidence.

• #fd_bounding_poly ⇒ Google::Cloud::Vision::V1::BoundingPoly

  The +fd_bounding_poly+ bounding polygon is tighter than the +boundingPoly+, and encloses only the skin part of the face.

• #headwear_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

  Headwear likelihood.

• #joy_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

  Joy likelihood.

• #landmarking_confidence ⇒ Float

  Face landmarking confidence.

• #landmarks ⇒ Array<Google::Cloud::Vision::V1::FaceAnnotation::Landmark>

  Detected face landmarks.

• #pan_angle ⇒ Float

  Yaw angle, which indicates the leftward/rightward angle that the face is pointing relative to the vertical plane perpendicular to the image.

• #roll_angle ⇒ Float

  Roll angle, which indicates the amount of clockwise/anti-clockwise rotation of the face relative to the image vertical about the axis perpendicular to the face.

• #sorrow_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

  Sorrow likelihood.

• #surprise_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

  Surprise likelihood.

• #tilt_angle ⇒ Float

  Pitch angle, which indicates the upwards/downwards angle that the face is pointing relative to the image's horizontal plane.

• #under_exposed_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

  Under-exposed likelihood.

Instance Attribute Details

#anger_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

Returns Anger likelihood.

Returns:

• (Google::Cloud::Vision::V1::Likelihood) —

  Anger likelihood.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#blurred_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

Returns Blurred likelihood.

Returns:

• (Google::Cloud::Vision::V1::Likelihood) —

  Blurred likelihood.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#bounding_poly ⇒ Google::Cloud::Vision::V1::BoundingPoly

Returns The bounding polygon around the face. The coordinates of the bounding box are in the original image's scale, as returned in +ImageParams+. The bounding box is computed to "frame" the face in accordance with human expectations. It is based on the landmarker results. Note that one or more x and/or y coordinates may not be generated in the +BoundingPoly+ (the polygon will be unbounded) if only a partial face appears in the image to be annotated.

Returns:

• (Google::Cloud::Vision::V1::BoundingPoly) —

  The bounding polygon around the face. The coordinates of the bounding box are in the original image's scale, as returned in +ImageParams+. The bounding box is computed to "frame" the face in accordance with human expectations. It is based on the landmarker results. Note that one or more x and/or y coordinates may not be generated in the +BoundingPoly+ (the polygon will be unbounded) if only a partial face appears in the image to be annotated.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#detection_confidence ⇒ Float

Returns Detection confidence. Range [0, 1].

Returns:

• (Float) —

  Detection confidence. Range [0, 1].

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#fd_bounding_poly ⇒ Google::Cloud::Vision::V1::BoundingPoly

Returns The +fd_bounding_poly+ bounding polygon is tighter than the +boundingPoly+, and encloses only the skin part of the face. Typically, it is used to eliminate the face from any image analysis that detects the "amount of skin" visible in an image. It is not based on the landmarker results, only on the initial face detection, hence the fd (face detection) prefix.

Returns:

• (Google::Cloud::Vision::V1::BoundingPoly) —

  The +fd_bounding_poly+ bounding polygon is tighter than the +boundingPoly+, and encloses only the skin part of the face. Typically, it is used to eliminate the face from any image analysis that detects the "amount of skin" visible in an image. It is not based on the landmarker results, only on the initial face detection, hence the fd (face detection) prefix.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#headwear_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

Returns Headwear likelihood.

Returns:

• (Google::Cloud::Vision::V1::Likelihood) —

  Headwear likelihood.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#joy_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

Returns Joy likelihood.

Returns:

• (Google::Cloud::Vision::V1::Likelihood) —

  Joy likelihood.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#landmarking_confidence ⇒ Float

Returns Face landmarking confidence. Range [0, 1].

Returns:

• (Float) —

  Face landmarking confidence. Range [0, 1].

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#landmarks ⇒ Array<Google::Cloud::Vision::V1::FaceAnnotation::Landmark>

Returns Detected face landmarks.

Returns:

• (Array<Google::Cloud::Vision::V1::FaceAnnotation::Landmark>) —

  Detected face landmarks.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#pan_angle ⇒ Float

Returns Yaw angle, which indicates the leftward/rightward angle that the face is pointing relative to the vertical plane perpendicular to the image. Range [-180,180].

Returns:

• (Float) —

  Yaw angle, which indicates the leftward/rightward angle that the face is pointing relative to the vertical plane perpendicular to the image. Range [-180,180].

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#roll_angle ⇒ Float

Returns Roll angle, which indicates the amount of clockwise/anti-clockwise rotation of the face relative to the image vertical about the axis perpendicular to the face. Range [-180,180].

Returns:

• (Float) —

  Roll angle, which indicates the amount of clockwise/anti-clockwise rotation of the face relative to the image vertical about the axis perpendicular to the face. Range [-180,180].

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#sorrow_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

Returns Sorrow likelihood.

Returns:

• (Google::Cloud::Vision::V1::Likelihood) —

  Sorrow likelihood.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#surprise_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

Returns Surprise likelihood.

Returns:

• (Google::Cloud::Vision::V1::Likelihood) —

  Surprise likelihood.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#tilt_angle ⇒ Float

Returns Pitch angle, which indicates the upwards/downwards angle that the face is pointing relative to the image's horizontal plane. Range [-180,180].

Returns:

• (Float) —

  Pitch angle, which indicates the upwards/downwards angle that the face is pointing relative to the image's horizontal plane. Range [-180,180].

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end

#under_exposed_likelihood ⇒ Google::Cloud::Vision::V1::Likelihood

Returns Under-exposed likelihood.

Returns:

• (Google::Cloud::Vision::V1::Likelihood) —

  Under-exposed likelihood.

# File 'lib/google/cloud/vision/v1/doc/google/cloud/vision/v1/image_annotator.rb', line 166

class FaceAnnotation
  # A face-specific landmark (for example, a face feature).
  # Landmark positions may fall outside the bounds of the image
  # if the face is near one or more edges of the image.
  # Therefore it is NOT guaranteed that +0 <= x < width+ or
  # +0 <= y < height+.
  # @!attribute [rw] type
  #   @return [Google::Cloud::Vision::V1::FaceAnnotation::Landmark::Type]
  #     Face landmark type.
  # @!attribute [rw] position
  #   @return [Google::Cloud::Vision::V1::Position]
  #     Face landmark position.
  class Landmark
    # Face landmark (feature) type.
    # Left and right are defined from the vantage of the viewer of the image
    # without considering mirror projections typical of photos. So, +LEFT_EYE+,
    # typically, is the person's right eye.
    module Type
      # Unknown face landmark detected. Should not be filled.
      UNKNOWN_LANDMARK = 0

      # Left eye.
      LEFT_EYE = 1

      # Right eye.
      RIGHT_EYE = 2

      # Left of left eyebrow.
      LEFT_OF_LEFT_EYEBROW = 3

      # Right of left eyebrow.
      RIGHT_OF_LEFT_EYEBROW = 4

      # Left of right eyebrow.
      LEFT_OF_RIGHT_EYEBROW = 5

      # Right of right eyebrow.
      RIGHT_OF_RIGHT_EYEBROW = 6

      # Midpoint between eyes.
      MIDPOINT_BETWEEN_EYES = 7

      # Nose tip.
      NOSE_TIP = 8

      # Upper lip.
      UPPER_LIP = 9

      # Lower lip.
      LOWER_LIP = 10

      # Mouth left.
      MOUTH_LEFT = 11

      # Mouth right.
      MOUTH_RIGHT = 12

      # Mouth center.
      MOUTH_CENTER = 13

      # Nose, bottom right.
      NOSE_BOTTOM_RIGHT = 14

      # Nose, bottom left.
      NOSE_BOTTOM_LEFT = 15

      # Nose, bottom center.
      NOSE_BOTTOM_CENTER = 16

      # Left eye, top boundary.
      LEFT_EYE_TOP_BOUNDARY = 17

      # Left eye, right corner.
      LEFT_EYE_RIGHT_CORNER = 18

      # Left eye, bottom boundary.
      LEFT_EYE_BOTTOM_BOUNDARY = 19

      # Left eye, left corner.
      LEFT_EYE_LEFT_CORNER = 20

      # Right eye, top boundary.
      RIGHT_EYE_TOP_BOUNDARY = 21

      # Right eye, right corner.
      RIGHT_EYE_RIGHT_CORNER = 22

      # Right eye, bottom boundary.
      RIGHT_EYE_BOTTOM_BOUNDARY = 23

      # Right eye, left corner.
      RIGHT_EYE_LEFT_CORNER = 24

      # Left eyebrow, upper midpoint.
      LEFT_EYEBROW_UPPER_MIDPOINT = 25

      # Right eyebrow, upper midpoint.
      RIGHT_EYEBROW_UPPER_MIDPOINT = 26

      # Left ear tragion.
      LEFT_EAR_TRAGION = 27

      # Right ear tragion.
      RIGHT_EAR_TRAGION = 28

      # Left eye pupil.
      LEFT_EYE_PUPIL = 29

      # Right eye pupil.
      RIGHT_EYE_PUPIL = 30

      # Forehead glabella.
      FOREHEAD_GLABELLA = 31

      # Chin gnathion.
      CHIN_GNATHION = 32

      # Chin left gonion.
      CHIN_LEFT_GONION = 33

      # Chin right gonion.
      CHIN_RIGHT_GONION = 34
    end
  end
end