FaceAnnotation(mapping=None, *, ignore_unknown_fields=False, **kwargs)A face annotation object contains the results of face detection.
Attributes
| Name | Description |
bounding_poly |
google.cloud.vision_v1p4beta1.types.BoundingPoly
The bounding polygon around the face. The coordinates of the bounding box are in the original image's scale. 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.
|
fd_bounding_poly |
google.cloud.vision_v1p4beta1.types.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.
|
landmarks |
MutableSequence[google.cloud.vision_v1p4beta1.types.FaceAnnotation.Landmark]
Detected face landmarks. |
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. Range [-180,180]. |
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. Range [-180,180]. |
tilt_angle |
float
Pitch angle, which indicates the upwards/downwards angle that the face is pointing relative to the image's horizontal plane. Range [-180,180]. |
detection_confidence |
float
Detection confidence. Range [0, 1]. |
landmarking_confidence |
float
Face landmarking confidence. Range [0, 1]. |
joy_likelihood |
google.cloud.vision_v1p4beta1.types.Likelihood
Joy likelihood. |
sorrow_likelihood |
google.cloud.vision_v1p4beta1.types.Likelihood
Sorrow likelihood. |
anger_likelihood |
google.cloud.vision_v1p4beta1.types.Likelihood
Anger likelihood. |
surprise_likelihood |
google.cloud.vision_v1p4beta1.types.Likelihood
Surprise likelihood. |
under_exposed_likelihood |
google.cloud.vision_v1p4beta1.types.Likelihood
Under-exposed likelihood. |
blurred_likelihood |
google.cloud.vision_v1p4beta1.types.Likelihood
Blurred likelihood. |
headwear_likelihood |
google.cloud.vision_v1p4beta1.types.Likelihood
Headwear likelihood. |
recognition_result |
MutableSequence[google.cloud.vision_v1p4beta1.types.FaceRecognitionResult]
Additional recognition information. Only computed if image_context.face_recognition_params is provided, **and** a match is found to a Celebrity in the input CelebritySet. This field is sorted in order of decreasing confidence values. |
Classes
Landmark
Landmark(mapping=None, *, ignore_unknown_fields=False, **kwargs)A face-specific landmark (for example, a face feature).