-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Google Cloud Vision SDK.
--   
--   Integrates Google Vision features, including image labeling, face,
--   logo, and landmark detection, optical character recognition (OCR), and
--   detection of explicit content, into applications.
--   
--   <i>Warning:</i> This is an experimental prototype/preview release
--   which is still under exploratory development and not intended for
--   public use, caveat emptor!
--   
--   This library is compatible with version <tt>v1</tt> of the API.
@package gogol-vision
@version 0.3.0


module Network.Google.Vision.Types

-- | Default request referring to version <tt>v1</tt> of the Google Cloud
--   Vision API. This contains the host and root path used as a starting
--   point for constructing service requests.
visionService :: ServiceConfig

-- | View and manage your data across Google Cloud Platform services
cloudPlatformScope :: Proxy '["https://www.googleapis.com/auth/cloud-platform"]

-- | An object representing a latitude/longitude pair. This is expressed as
--   a pair of doubles representing degrees latitude and degrees longitude.
--   Unless specified otherwise, this must conform to the <a>WGS84
--   standard</a>. Values must be within normalized ranges. Example of
--   normalization code in Python: def NormalizeLongitude(longitude):
--   """Wraps decimal degrees longitude to [-180.0, 180.0].""" q, r =
--   divmod(longitude, 360.0) if r &gt; 180.0 or (r == 180.0 and q &lt;=
--   -1.0): return r - 360.0 return r def NormalizeLatLng(latitude,
--   longitude): """Wraps decimal degrees latitude and longitude to [-90.0,
--   90.0] and [-180.0, 180.0], respectively.""" r = latitude % 360.0 if r
--   &lt;= 90.0: return r, NormalizeLongitude(longitude) elif r &gt;=
--   270.0: return r - 360, NormalizeLongitude(longitude) else: return 180
--   - r, NormalizeLongitude(longitude + 180.0) assert 180.0 ==
--   NormalizeLongitude(180.0) assert -180.0 == NormalizeLongitude(-180.0)
--   assert -179.0 == NormalizeLongitude(181.0) assert (0.0, 0.0) ==
--   NormalizeLatLng(360.0, 0.0) assert (0.0, 0.0) ==
--   NormalizeLatLng(-360.0, 0.0) assert (85.0, 180.0) ==
--   NormalizeLatLng(95.0, 0.0) assert (-85.0, -170.0) ==
--   NormalizeLatLng(-95.0, 10.0) assert (90.0, 10.0) ==
--   NormalizeLatLng(90.0, 10.0) assert (-90.0, -10.0) ==
--   NormalizeLatLng(-90.0, -10.0) assert (0.0, -170.0) ==
--   NormalizeLatLng(-180.0, 10.0) assert (0.0, -170.0) ==
--   NormalizeLatLng(180.0, 10.0) assert (-90.0, 10.0) ==
--   NormalizeLatLng(270.0, 10.0) assert (90.0, 10.0) ==
--   NormalizeLatLng(-270.0, 10.0) The code in
--   logs/storage/validator/logs_validator_traits.cc treats this type as if
--   it were annotated as ST_LOCATION.
--   
--   <i>See:</i> <a>latLng</a> smart constructor.
data LatLng

-- | Creates a value of <a>LatLng</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>llLatitude</a></li>
--   <li><a>llLongitude</a></li>
--   </ul>
latLng :: LatLng

-- | The latitude in degrees. It must be in the range [-90.0, +90.0].
llLatitude :: Lens' LatLng (Maybe Double)

-- | The longitude in degrees. It must be in the range [-180.0, +180.0].
llLongitude :: Lens' LatLng (Maybe Double)

-- | Under-exposed likelihood.
data FaceAnnotationUnderExposedLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
Unknown :: FaceAnnotationUnderExposedLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
VeryUnlikely :: FaceAnnotationUnderExposedLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
Unlikely :: FaceAnnotationUnderExposedLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
Possible :: FaceAnnotationUnderExposedLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
Likely :: FaceAnnotationUnderExposedLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
VeryLikely :: FaceAnnotationUnderExposedLikelihood

-- | Users describe the type of Google Cloud Vision API tasks to perform
--   over images by using *Feature*s. Each Feature indicates a type of
--   image detection task to perform. Features encode the Cloud Vision API
--   vertical to operate on and the number of top-scoring results to
--   return.
--   
--   <i>See:</i> <a>feature</a> smart constructor.
data Feature

-- | Creates a value of <a>Feature</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>fType</a></li>
--   <li><a>fMaxResults</a></li>
--   </ul>
feature :: Feature

-- | The feature type.
fType :: Lens' Feature (Maybe FeatureType)

-- | Maximum number of results of this type.
fMaxResults :: Lens' Feature (Maybe Int32)

-- | The `Status` type defines a logical error model that is suitable for
--   different programming environments, including REST APIs and RPC APIs.
--   It is used by <a>gRPC</a>. The error model is designed to be: - Simple
--   to use and understand for most users - Flexible enough to meet
--   unexpected needs # Overview The `Status` message contains three pieces
--   of data: error code, error message, and error details. The error code
--   should be an enum value of google.rpc.Code, but it may accept
--   additional error codes if needed. The error message should be a
--   developer-facing English message that helps developers *understand*
--   and *resolve* the error. If a localized user-facing error message is
--   needed, put the localized message in the error details or localize it
--   in the client. The optional error details may contain arbitrary
--   information about the error. There is a predefined set of error detail
--   types in the package `google.rpc` which can be used for common error
--   conditions. # Language mapping The `Status` message is the logical
--   representation of the error model, but it is not necessarily the
--   actual wire format. When the `Status` message is exposed in different
--   client libraries and different wire protocols, it can be mapped
--   differently. For example, it will likely be mapped to some exceptions
--   in Java, but more likely mapped to some error codes in C. # Other uses
--   The error model and the `Status` message can be used in a variety of
--   environments, either with or without APIs, to provide a consistent
--   developer experience across different environments. Example uses of
--   this error model include: - Partial errors. If a service needs to
--   return partial errors to the client, it may embed the `Status` in the
--   normal response to indicate the partial errors. - Workflow errors. A
--   typical workflow has multiple steps. Each step may have a `Status`
--   message for error reporting purpose. - Batch operations. If a client
--   uses batch request and batch response, the `Status` message should be
--   used directly inside batch response, one for each error sub-response.
--   - Asynchronous operations. If an API call embeds asynchronous
--   operation results in its response, the status of those operations
--   should be represented directly using the `Status` message. - Logging.
--   If some API errors are stored in logs, the message `Status` could be
--   used directly after any stripping needed for security/privacy reasons.
--   
--   <i>See:</i> <a>status</a> smart constructor.
data Status

-- | Creates a value of <a>Status</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>sDetails</a></li>
--   <li><a>sCode</a></li>
--   <li><a>sMessage</a></li>
--   </ul>
status :: Status

-- | A list of messages that carry the error details. There will be a
--   common set of message types for APIs to use.
sDetails :: Lens' Status [StatusDetailsItem]

-- | The status code, which should be an enum value of google.rpc.Code.
sCode :: Lens' Status (Maybe Int32)

-- | A developer-facing error message, which should be in English. Any
--   user-facing error message should be localized and sent in the
--   google.rpc.Status.details field, or localized by the client.
sMessage :: Lens' Status (Maybe Text)

-- | A `Property` consists of a user-supplied name/value pair.
--   
--   <i>See:</i> <a>property</a> smart constructor.
data Property

-- | Creates a value of <a>Property</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>pValue</a></li>
--   <li><a>pName</a></li>
--   </ul>
property :: Property

-- | Value of the property.
pValue :: Lens' Property (Maybe Text)

-- | Name of the property.
pName :: Lens' Property (Maybe Text)

-- | Client image to perform Google Cloud Vision API tasks over.
--   
--   <i>See:</i> <a>image</a> smart constructor.
data Image

-- | Creates a value of <a>Image</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>iContent</a></li>
--   <li><a>iSource</a></li>
--   </ul>
image :: Image

-- | Image content, represented as a stream of bytes. Note: as with all
--   `bytes` fields, protobuffers use a pure binary representation, whereas
--   JSON representations use base64.
iContent :: Lens' Image (Maybe ByteString)

-- | Google Cloud Storage image location. If both `content` and `source`
--   are provided for an image, `content` takes precedence and is used to
--   perform the image annotation request.
iSource :: Lens' Image (Maybe ImageSource)

-- | 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
--   &lt;= x &lt; width` or `0 &lt;= y &lt; height`.
--   
--   <i>See:</i> <a>landmark</a> smart constructor.
data Landmark

-- | Creates a value of <a>Landmark</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>lType</a></li>
--   <li><a>lPosition</a></li>
--   </ul>
landmark :: Landmark

-- | Face landmark type.
lType :: Lens' Landmark (Maybe LandmarkType)

-- | Face landmark position.
lPosition :: Lens' Landmark (Maybe Position)

-- | Represents a color in the RGBA color space. This representation is
--   designed for simplicity of conversion to/from color representations in
--   various languages over compactness; for example, the fields of this
--   representation can be trivially provided to the constructor of
--   "java.awt.Color" in Java; it can also be trivially provided to
--   UIColor's "+colorWithRed:green:blue:alpha" method in iOS; and, with
--   just a little work, it can be easily formatted into a CSS "rgba()"
--   string in JavaScript, as well. Here are some examples: Example (Java):
--   import com.google.type.Color; // ... public static java.awt.Color
--   fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ?
--   protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color(
--   protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(),
--   alpha); } public static Color toProto(java.awt.Color color) { float
--   red = (float) color.getRed(); float green = (float) color.getGreen();
--   float blue = (float) color.getBlue(); float denominator = 255.0;
--   Color.Builder resultBuilder = Color .newBuilder() .setRed(red /
--   denominator) .setGreen(green / denominator) .setBlue(blue /
--   denominator); int alpha = color.getAlpha(); if (alpha != 255) {
--   result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) /
--   denominator) .build()); } return resultBuilder.build(); } // ...
--   Example (iOS / Obj-C): // ... static UIColor* fromProto(Color*
--   protocolor) { float red = [protocolor red]; float green = [protocolor
--   green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper =
--   [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) {
--   alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red
--   green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor*
--   color) { CGFloat red, green, blue, alpha; if (![color getRed:&amp;red
--   green:&amp;green blue:&amp;blue alpha:&amp;alpha]) { return nil; }
--   Color* result = [Color alloc] init]; [result setRed:red]; [result
--   setGreen:green]; [result setBlue:blue]; if (alpha &lt;= 0.9999) {
--   [result setAlpha:floatWrapperWithValue(alpha)]; } [result
--   autorelease]; return result; } // ... Example (JavaScript): // ... var
--   protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red ||
--   0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac =
--   rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green
--   = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255);
--   if (!('alpha' in rgb_color)) { return rgbToCssColor_(red, green,
--   blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams =
--   [red, green, blue].join(','); return ['rgba(', rgbParams, ',',
--   alphaFrac, ')'].join(''); }; var rgbToCssColor_ = function(red, green,
--   blue) { var rgbNumber = new Number((red &lt;&lt; 16) | (green &lt;&lt;
--   8) | blue); var hexString = rgbNumber.toString(16); var missingZeros =
--   6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i
--   &lt; missingZeros; i++) { resultBuilder.push('0'); }
--   resultBuilder.push(hexString); return resultBuilder.join(''); }; //
--   ...
--   
--   <i>See:</i> <a>color</a> smart constructor.
data Color

-- | Creates a value of <a>Color</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>cRed</a></li>
--   <li><a>cAlpha</a></li>
--   <li><a>cGreen</a></li>
--   <li><a>cBlue</a></li>
--   </ul>
color :: Color

-- | The amount of red in the color as a value in the interval [0, 1].
cRed :: Lens' Color (Maybe Double)

-- | The fraction of this color that should be applied to the pixel. That
--   is, the final pixel color is defined by the equation: pixel color =
--   alpha * (this color) + (1.0 - alpha) * (background color) This means
--   that a value of 1.0 corresponds to a solid color, whereas a value of
--   0.0 corresponds to a completely transparent color. This uses a wrapper
--   message rather than a simple float scalar so that it is possible to
--   distinguish between a default value and the value being unset. If
--   omitted, this color object is to be rendered as a solid color (as if
--   the alpha value had been explicitly given with a value of 1.0).
cAlpha :: Lens' Color (Maybe Double)

-- | The amount of green in the color as a value in the interval [0, 1].
cGreen :: Lens' Color (Maybe Double)

-- | The amount of blue in the color as a value in the interval [0, 1].
cBlue :: Lens' Color (Maybe Double)

-- | Headwear likelihood.
data FaceAnnotationHeadwearLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FAHLUnknown :: FaceAnnotationHeadwearLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FAHLVeryUnlikely :: FaceAnnotationHeadwearLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FAHLUnlikely :: FaceAnnotationHeadwearLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FAHLPossible :: FaceAnnotationHeadwearLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FAHLLikely :: FaceAnnotationHeadwearLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FAHLVeryLikely :: FaceAnnotationHeadwearLikelihood

-- | A bounding polygon for the detected image annotation.
--   
--   <i>See:</i> <a>boundingPoly</a> smart constructor.
data BoundingPoly

-- | Creates a value of <a>BoundingPoly</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>bpVertices</a></li>
--   </ul>
boundingPoly :: BoundingPoly

-- | The bounding polygon vertices.
bpVertices :: Lens' BoundingPoly [Vertex]

-- | Represents the adult content likelihood for the image.
data SafeSearchAnnotationAdult

-- | <tt>UNKNOWN</tt> Unknown likelihood.
SSAAUnknown :: SafeSearchAnnotationAdult

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
SSAAVeryUnlikely :: SafeSearchAnnotationAdult

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
SSAAUnlikely :: SafeSearchAnnotationAdult

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
SSAAPossible :: SafeSearchAnnotationAdult

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
SSAALikely :: SafeSearchAnnotationAdult

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
SSAAVeryLikely :: SafeSearchAnnotationAdult

-- | A vertex represents a 2D point in the image. NOTE: the vertex
--   coordinates are in the same scale as the original image.
--   
--   <i>See:</i> <a>vertex</a> smart constructor.
data Vertex

-- | Creates a value of <a>Vertex</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>vX</a></li>
--   <li><a>vY</a></li>
--   </ul>
vertex :: Vertex

-- | X coordinate.
vX :: Lens' Vertex (Maybe Int32)

-- | Y coordinate.
vY :: Lens' Vertex (Maybe Int32)

-- | Anger likelihood.
data FaceAnnotationAngerLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FAALUnknown :: FaceAnnotationAngerLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FAALVeryUnlikely :: FaceAnnotationAngerLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FAALUnlikely :: FaceAnnotationAngerLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FAALPossible :: FaceAnnotationAngerLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FAALLikely :: FaceAnnotationAngerLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FAALVeryLikely :: FaceAnnotationAngerLikelihood

-- | Detected entity location information.
--   
--   <i>See:</i> <a>locationInfo</a> smart constructor.
data LocationInfo

-- | Creates a value of <a>LocationInfo</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>liLatLng</a></li>
--   </ul>
locationInfo :: LocationInfo

-- | lat/long location coordinates.
liLatLng :: Lens' LocationInfo (Maybe LatLng)

-- | Likelihood that this is a medical image.
data SafeSearchAnnotationMedical

-- | <tt>UNKNOWN</tt> Unknown likelihood.
SSAMUnknown :: SafeSearchAnnotationMedical

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
SSAMVeryUnlikely :: SafeSearchAnnotationMedical

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
SSAMUnlikely :: SafeSearchAnnotationMedical

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
SSAMPossible :: SafeSearchAnnotationMedical

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
SSAMLikely :: SafeSearchAnnotationMedical

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
SSAMVeryLikely :: SafeSearchAnnotationMedical
data StatusDetailsItem

-- | Creates a value of <a>StatusDetailsItem</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>sdiAddtional</a></li>
--   </ul>
statusDetailsItem :: HashMap Text JSONValue -> StatusDetailsItem

-- | Properties of the object. Contains field 'type with type URL.
sdiAddtional :: Lens' StatusDetailsItem (HashMap Text JSONValue)

-- | Multiple image annotation requests are batched into a single service
--   call.
--   
--   <i>See:</i> <a>batchAnnotateImagesRequest</a> smart constructor.
data BatchAnnotateImagesRequest

-- | Creates a value of <a>BatchAnnotateImagesRequest</a> with the minimum
--   fields required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>bairRequests</a></li>
--   </ul>
batchAnnotateImagesRequest :: BatchAnnotateImagesRequest

-- | Individual image annotation requests for this batch.
bairRequests :: Lens' BatchAnnotateImagesRequest [AnnotateImageRequest]

-- | Color information consists of RGB channels, score, and the fraction of
--   the image that the color occupies in the image.
--   
--   <i>See:</i> <a>colorInfo</a> smart constructor.
data ColorInfo

-- | Creates a value of <a>ColorInfo</a> with the minimum fields required
--   to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>ciColor</a></li>
--   <li><a>ciScore</a></li>
--   <li><a>ciPixelFraction</a></li>
--   </ul>
colorInfo :: ColorInfo

-- | RGB components of the color.
ciColor :: Lens' ColorInfo (Maybe Color)

-- | Image-specific score for this color. Value in range [0, 1].
ciScore :: Lens' ColorInfo (Maybe Double)

-- | The fraction of pixels the color occupies in the image. Value in range
--   [0, 1].
ciPixelFraction :: Lens' ColorInfo (Maybe Double)

-- | Blurred likelihood.
data FaceAnnotationBlurredLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FABLUnknown :: FaceAnnotationBlurredLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FABLVeryUnlikely :: FaceAnnotationBlurredLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FABLUnlikely :: FaceAnnotationBlurredLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FABLPossible :: FaceAnnotationBlurredLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FABLLikely :: FaceAnnotationBlurredLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FABLVeryLikely :: FaceAnnotationBlurredLikelihood

-- | Response to an image annotation request.
--   
--   <i>See:</i> <a>annotateImageResponse</a> smart constructor.
data AnnotateImageResponse

-- | Creates a value of <a>AnnotateImageResponse</a> with the minimum
--   fields required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>airLogoAnnotations</a></li>
--   <li><a>airLabelAnnotations</a></li>
--   <li><a>airFaceAnnotations</a></li>
--   <li><a>airError</a></li>
--   <li><a>airSafeSearchAnnotation</a></li>
--   <li><a>airLandmarkAnnotations</a></li>
--   <li><a>airTextAnnotations</a></li>
--   <li><a>airImagePropertiesAnnotation</a></li>
--   </ul>
annotateImageResponse :: AnnotateImageResponse

-- | If present, logo detection has completed successfully.
airLogoAnnotations :: Lens' AnnotateImageResponse [EntityAnnotation]

-- | If present, label detection has completed successfully.
airLabelAnnotations :: Lens' AnnotateImageResponse [EntityAnnotation]

-- | If present, face detection has completed successfully.
airFaceAnnotations :: Lens' AnnotateImageResponse [FaceAnnotation]

-- | If set, represents the error message for the operation. Note that
--   filled-in image annotations are guaranteed to be correct, even when
--   `error` is set.
airError :: Lens' AnnotateImageResponse (Maybe Status)

-- | If present, safe-search annotation has completed successfully.
airSafeSearchAnnotation :: Lens' AnnotateImageResponse (Maybe SafeSearchAnnotation)

-- | If present, landmark detection has completed successfully.
airLandmarkAnnotations :: Lens' AnnotateImageResponse [EntityAnnotation]

-- | If present, text (OCR) detection has completed successfully.
airTextAnnotations :: Lens' AnnotateImageResponse [EntityAnnotation]

-- | If present, image properties were extracted successfully.
airImagePropertiesAnnotation :: Lens' AnnotateImageResponse (Maybe ImageProperties)

-- | Stores image properties, such as dominant colors.
--   
--   <i>See:</i> <a>imageProperties</a> smart constructor.
data ImageProperties

-- | Creates a value of <a>ImageProperties</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>ipDominantColors</a></li>
--   </ul>
imageProperties :: ImageProperties

-- | If present, dominant colors completed successfully.
ipDominantColors :: Lens' ImageProperties (Maybe DominantColorsAnnotation)

-- | A face annotation object contains the results of face detection.
--   
--   <i>See:</i> <a>faceAnnotation</a> smart constructor.
data FaceAnnotation

-- | Creates a value of <a>FaceAnnotation</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>faTiltAngle</a></li>
--   <li><a>faBlurredLikelihood</a></li>
--   <li><a>faBoundingPoly</a></li>
--   <li><a>faSurpriseLikelihood</a></li>
--   <li><a>faLandmarkingConfidence</a></li>
--   <li><a>faPanAngle</a></li>
--   <li><a>faRollAngle</a></li>
--   <li><a>faUnderExposedLikelihood</a></li>
--   <li><a>faFdBoundingPoly</a></li>
--   <li><a>faAngerLikelihood</a></li>
--   <li><a>faDetectionConfidence</a></li>
--   <li><a>faHeadwearLikelihood</a></li>
--   <li><a>faSorrowLikelihood</a></li>
--   <li><a>faJoyLikelihood</a></li>
--   <li><a>faLandmarks</a></li>
--   </ul>
faceAnnotation :: FaceAnnotation

-- | Pitch angle, which indicates the upwards/downwards angle that the face
--   is pointing relative to the image's horizontal plane. Range
--   [-180,180].
faTiltAngle :: Lens' FaceAnnotation (Maybe Double)

-- | Blurred likelihood.
faBlurredLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationBlurredLikelihood)

-- | 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.
faBoundingPoly :: Lens' FaceAnnotation (Maybe BoundingPoly)

-- | Surprise likelihood.
faSurpriseLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationSurpriseLikelihood)

-- | Face landmarking confidence. Range [0, 1].
faLandmarkingConfidence :: Lens' FaceAnnotation (Maybe Double)

-- | 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].
faPanAngle :: Lens' FaceAnnotation (Maybe Double)

-- | 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].
faRollAngle :: Lens' FaceAnnotation (Maybe Double)

-- | Under-exposed likelihood.
faUnderExposedLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationUnderExposedLikelihood)

-- | 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 <tt>fd</tt> (face detection) prefix.
faFdBoundingPoly :: Lens' FaceAnnotation (Maybe BoundingPoly)

-- | Anger likelihood.
faAngerLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationAngerLikelihood)

-- | Detection confidence. Range [0, 1].
faDetectionConfidence :: Lens' FaceAnnotation (Maybe Double)

-- | Headwear likelihood.
faHeadwearLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationHeadwearLikelihood)

-- | Sorrow likelihood.
faSorrowLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationSorrowLikelihood)

-- | Joy likelihood.
faJoyLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationJoyLikelihood)

-- | Detected face landmarks.
faLandmarks :: Lens' FaceAnnotation [Landmark]

-- | Violence likelihood.
data SafeSearchAnnotationViolence

-- | <tt>UNKNOWN</tt> Unknown likelihood.
SSAVUnknown :: SafeSearchAnnotationViolence

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
SSAVVeryUnlikely :: SafeSearchAnnotationViolence

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
SSAVUnlikely :: SafeSearchAnnotationViolence

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
SSAVPossible :: SafeSearchAnnotationViolence

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
SSAVLikely :: SafeSearchAnnotationViolence

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
SSAVVeryLikely :: SafeSearchAnnotationViolence

-- | Set of detected entity features.
--   
--   <i>See:</i> <a>entityAnnotation</a> smart constructor.
data EntityAnnotation

-- | Creates a value of <a>EntityAnnotation</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>eaScore</a></li>
--   <li><a>eaTopicality</a></li>
--   <li><a>eaLocale</a></li>
--   <li><a>eaBoundingPoly</a></li>
--   <li><a>eaConfidence</a></li>
--   <li><a>eaMid</a></li>
--   <li><a>eaLocations</a></li>
--   <li><a>eaDescription</a></li>
--   <li><a>eaProperties</a></li>
--   </ul>
entityAnnotation :: EntityAnnotation

-- | Overall score of the result. Range [0, 1].
eaScore :: Lens' EntityAnnotation (Maybe Double)

-- | The relevancy of the ICA (Image Content Annotation) label to the
--   image. For example, the relevancy of "tower" is likely higher to an
--   image containing the detected "Eiffel Tower" than to an image
--   containing a detected distant towering building, even though the
--   confidence that there is a tower in each image may be the same. Range
--   [0, 1].
eaTopicality :: Lens' EntityAnnotation (Maybe Double)

-- | The language code for the locale in which the entity textual
--   `description` is expressed.
eaLocale :: Lens' EntityAnnotation (Maybe Text)

-- | Image region to which this entity belongs. Currently not produced for
--   `LABEL_DETECTION` features. For `TEXT_DETECTION` (OCR),
--   `boundingPoly`s are produced for the entire text detected in an image
--   region, followed by `boundingPoly`s for each word within the detected
--   text.
eaBoundingPoly :: Lens' EntityAnnotation (Maybe BoundingPoly)

-- | The accuracy of the entity detection in an image. For example, for an
--   image in which the "Eiffel Tower" entity is detected, this field
--   represents the confidence that there is a tower in the query image.
--   Range [0, 1].
eaConfidence :: Lens' EntityAnnotation (Maybe Double)

-- | Opaque entity ID. Some IDs may be available in <a>Google Knowledge
--   Graph Search API</a>.
eaMid :: Lens' EntityAnnotation (Maybe Text)

-- | The location information for the detected entity. Multiple
--   `LocationInfo` elements can be present because one location may
--   indicate the location of the scene in the image, and another location
--   may indicate the location of the place where the image was taken.
--   Location information is usually present for landmarks.
eaLocations :: Lens' EntityAnnotation [LocationInfo]

-- | Entity textual description, expressed in its `locale` language.
eaDescription :: Lens' EntityAnnotation (Maybe Text)

-- | Some entities may have optional user-supplied `Property` (name/value)
--   fields, such a score or string that qualifies the entity.
eaProperties :: Lens' EntityAnnotation [Property]

-- | The feature type.
data FeatureType

-- | <tt>TYPE_UNSPECIFIED</tt> Unspecified feature type.
TypeUnspecified :: FeatureType

-- | <tt>FACE_DETECTION</tt> Run face detection.
FaceDetection :: FeatureType

-- | <tt>LANDMARK_DETECTION</tt> Run landmark detection.
LandmarkDetection :: FeatureType

-- | <tt>LOGO_DETECTION</tt> Run logo detection.
LogoDetection :: FeatureType

-- | <tt>LABEL_DETECTION</tt> Run label detection.
LabelDetection :: FeatureType

-- | <tt>TEXT_DETECTION</tt> Run OCR.
TextDetection :: FeatureType

-- | <tt>SAFE_SEARCH_DETECTION</tt> Run computer vision models to compute
--   image safe-search properties.
SafeSearchDetection :: FeatureType

-- | <tt>IMAGE_PROPERTIES</tt> Compute a set of image properties, such as
--   the image's dominant colors.
ImageProperties :: FeatureType

-- | Request for performing Google Cloud Vision API tasks over a
--   user-provided image, with user-requested features.
--   
--   <i>See:</i> <a>annotateImageRequest</a> smart constructor.
data AnnotateImageRequest

-- | Creates a value of <a>AnnotateImageRequest</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>airImage</a></li>
--   <li><a>airFeatures</a></li>
--   <li><a>airImageContext</a></li>
--   </ul>
annotateImageRequest :: AnnotateImageRequest

-- | The image to be processed.
airImage :: Lens' AnnotateImageRequest (Maybe Image)

-- | Requested features.
airFeatures :: Lens' AnnotateImageRequest [Feature]

-- | Additional context that may accompany the image.
airImageContext :: Lens' AnnotateImageRequest (Maybe ImageContext)

-- | Face landmark type.
data LandmarkType

-- | <tt>UNKNOWN_LANDMARK</tt> Unknown face landmark detected. Should not
--   be filled.
UnknownLandmark :: LandmarkType

-- | <tt>LEFT_EYE</tt> Left eye.
LeftEye :: LandmarkType

-- | <tt>RIGHT_EYE</tt> Right eye.
RightEye :: LandmarkType

-- | <tt>LEFT_OF_LEFT_EYEBROW</tt> Left of left eyebrow.
LeftOfLeftEyebrow :: LandmarkType

-- | <tt>RIGHT_OF_LEFT_EYEBROW</tt> Right of left eyebrow.
RightOfLeftEyebrow :: LandmarkType

-- | <tt>LEFT_OF_RIGHT_EYEBROW</tt> Left of right eyebrow.
LeftOfRightEyebrow :: LandmarkType

-- | <tt>RIGHT_OF_RIGHT_EYEBROW</tt> Right of right eyebrow.
RightOfRightEyebrow :: LandmarkType

-- | <tt>MIDPOINT_BETWEEN_EYES</tt> Midpoint between eyes.
MidpointBetweenEyes :: LandmarkType

-- | <tt>NOSE_TIP</tt> Nose tip.
NoseTip :: LandmarkType

-- | <tt>UPPER_LIP</tt> Upper lip.
UpperLip :: LandmarkType

-- | <tt>LOWER_LIP</tt> Lower lip.
LowerLip :: LandmarkType

-- | <tt>MOUTH_LEFT</tt> Mouth left.
MouthLeft :: LandmarkType

-- | <tt>MOUTH_RIGHT</tt> Mouth right.
MouthRight :: LandmarkType

-- | <tt>MOUTH_CENTER</tt> Mouth center.
MouthCenter :: LandmarkType

-- | <tt>NOSE_BOTTOM_RIGHT</tt> Nose, bottom right.
NoseBottomRight :: LandmarkType

-- | <tt>NOSE_BOTTOM_LEFT</tt> Nose, bottom left.
NoseBottomLeft :: LandmarkType

-- | <tt>NOSE_BOTTOM_CENTER</tt> Nose, bottom center.
NoseBottomCenter :: LandmarkType

-- | <tt>LEFT_EYE_TOP_BOUNDARY</tt> Left eye, top boundary.
LeftEyeTopBoundary :: LandmarkType

-- | <tt>LEFT_EYE_RIGHT_CORNER</tt> Left eye, right corner.
LeftEyeRightCorner :: LandmarkType

-- | <tt>LEFT_EYE_BOTTOM_BOUNDARY</tt> Left eye, bottom boundary.
LeftEyeBottomBoundary :: LandmarkType

-- | <tt>LEFT_EYE_LEFT_CORNER</tt> Left eye, left corner.
LeftEyeLeftCorner :: LandmarkType

-- | <tt>RIGHT_EYE_TOP_BOUNDARY</tt> Right eye, top boundary.
RightEyeTopBoundary :: LandmarkType

-- | <tt>RIGHT_EYE_RIGHT_CORNER</tt> Right eye, right corner.
RightEyeRightCorner :: LandmarkType

-- | <tt>RIGHT_EYE_BOTTOM_BOUNDARY</tt> Right eye, bottom boundary.
RightEyeBottomBoundary :: LandmarkType

-- | <tt>RIGHT_EYE_LEFT_CORNER</tt> Right eye, left corner.
RightEyeLeftCorner :: LandmarkType

-- | <tt>LEFT_EYEBROW_UPPER_MIDPOINT</tt> Left eyebrow, upper midpoint.
LeftEyebrowUpperMidpoint :: LandmarkType

-- | <tt>RIGHT_EYEBROW_UPPER_MIDPOINT</tt> Right eyebrow, upper midpoint.
RightEyebrowUpperMidpoint :: LandmarkType

-- | <tt>LEFT_EAR_TRAGION</tt> Left ear tragion.
LeftEarTragion :: LandmarkType

-- | <tt>RIGHT_EAR_TRAGION</tt> Right ear tragion.
RightEarTragion :: LandmarkType

-- | <tt>LEFT_EYE_PUPIL</tt> Left eye pupil.
LeftEyePupil :: LandmarkType

-- | <tt>RIGHT_EYE_PUPIL</tt> Right eye pupil.
RightEyePupil :: LandmarkType

-- | <tt>FOREHEAD_GLABELLA</tt> Forehead glabella.
ForeheadGlabella :: LandmarkType

-- | <tt>CHIN_GNATHION</tt> Chin gnathion.
ChinGnathion :: LandmarkType

-- | <tt>CHIN_LEFT_GONION</tt> Chin left gonion.
ChinLeftGonion :: LandmarkType

-- | <tt>CHIN_RIGHT_GONION</tt> Chin right gonion.
ChinRightGonion :: LandmarkType

-- | V1 error format.
data Xgafv

-- | <tt>1</tt> v1 error format
X1 :: Xgafv

-- | <tt>2</tt> v2 error format
X2 :: Xgafv

-- | External image source (Google Cloud Storage image location).
--   
--   <i>See:</i> <a>imageSource</a> smart constructor.
data ImageSource

-- | Creates a value of <a>ImageSource</a> with the minimum fields required
--   to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>isGcsImageURI</a></li>
--   </ul>
imageSource :: ImageSource

-- | Google Cloud Storage image URI, which must be in the following form:
--   `gs://bucket_name/object_name` (for details, see <a>Google Cloud
--   Storage Request URIs</a>). NOTE: Cloud Storage object versioning is
--   not supported.
isGcsImageURI :: Lens' ImageSource (Maybe Text)

-- | Spoof likelihood. The likelihood that an modification was made to the
--   image's canonical version to make it appear funny or offensive.
data SafeSearchAnnotationSpoof

-- | <tt>UNKNOWN</tt> Unknown likelihood.
SSASUnknown :: SafeSearchAnnotationSpoof

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
SSASVeryUnlikely :: SafeSearchAnnotationSpoof

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
SSASUnlikely :: SafeSearchAnnotationSpoof

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
SSASPossible :: SafeSearchAnnotationSpoof

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
SSASLikely :: SafeSearchAnnotationSpoof

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
SSASVeryLikely :: SafeSearchAnnotationSpoof

-- | Surprise likelihood.
data FaceAnnotationSurpriseLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FASLUnknown :: FaceAnnotationSurpriseLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FASLVeryUnlikely :: FaceAnnotationSurpriseLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FASLUnlikely :: FaceAnnotationSurpriseLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FASLPossible :: FaceAnnotationSurpriseLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FASLLikely :: FaceAnnotationSurpriseLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FASLVeryLikely :: FaceAnnotationSurpriseLikelihood
data SafeSearchAnnotation

-- | Creates a value of <a>SafeSearchAnnotation</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>ssaSpoof</a></li>
--   <li><a>ssaAdult</a></li>
--   <li><a>ssaMedical</a></li>
--   <li><a>ssaViolence</a></li>
--   </ul>
safeSearchAnnotation :: SafeSearchAnnotation

-- | Spoof likelihood. The likelihood that an modification was made to the
--   image's canonical version to make it appear funny or offensive.
ssaSpoof :: Lens' SafeSearchAnnotation (Maybe SafeSearchAnnotationSpoof)

-- | Represents the adult content likelihood for the image.
ssaAdult :: Lens' SafeSearchAnnotation (Maybe SafeSearchAnnotationAdult)

-- | Likelihood that this is a medical image.
ssaMedical :: Lens' SafeSearchAnnotation (Maybe SafeSearchAnnotationMedical)

-- | Violence likelihood.
ssaViolence :: Lens' SafeSearchAnnotation (Maybe SafeSearchAnnotationViolence)

-- | Sorrow likelihood.
data FaceAnnotationSorrowLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FUnknown :: FaceAnnotationSorrowLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FVeryUnlikely :: FaceAnnotationSorrowLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FUnlikely :: FaceAnnotationSorrowLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FPossible :: FaceAnnotationSorrowLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FLikely :: FaceAnnotationSorrowLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FVeryLikely :: FaceAnnotationSorrowLikelihood

-- | Joy likelihood.
data FaceAnnotationJoyLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FAJLUnknown :: FaceAnnotationJoyLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FAJLVeryUnlikely :: FaceAnnotationJoyLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FAJLUnlikely :: FaceAnnotationJoyLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FAJLPossible :: FaceAnnotationJoyLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FAJLLikely :: FaceAnnotationJoyLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FAJLVeryLikely :: FaceAnnotationJoyLikelihood

-- | Image context and/or feature-specific parameters.
--   
--   <i>See:</i> <a>imageContext</a> smart constructor.
data ImageContext

-- | Creates a value of <a>ImageContext</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>icLanguageHints</a></li>
--   <li><a>icLatLongRect</a></li>
--   </ul>
imageContext :: ImageContext

-- | List of languages to use for TEXT_DETECTION. In most cases, an empty
--   value yields the best results since it enables automatic language
--   detection. For languages based on the Latin alphabet, setting
--   `language_hints` is not needed. In rare cases, when the language of
--   the text in the image is known, setting a hint will help get better
--   results (although it will be a significant hindrance if the hint is
--   wrong). Text detection returns an error if one or more of the
--   specified languages is not one of the <a>supported languages</a>.
icLanguageHints :: Lens' ImageContext [Text]

-- | lat/long rectangle that specifies the location of the image.
icLatLongRect :: Lens' ImageContext (Maybe LatLongRect)

-- | Set of dominant colors and their corresponding scores.
--   
--   <i>See:</i> <a>dominantColorsAnnotation</a> smart constructor.
data DominantColorsAnnotation

-- | Creates a value of <a>DominantColorsAnnotation</a> with the minimum
--   fields required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>dcaColors</a></li>
--   </ul>
dominantColorsAnnotation :: DominantColorsAnnotation

-- | RGB color values with their score and pixel fraction.
dcaColors :: Lens' DominantColorsAnnotation [ColorInfo]

-- | Rectangle determined by min and max `LatLng` pairs.
--   
--   <i>See:</i> <a>latLongRect</a> smart constructor.
data LatLongRect

-- | Creates a value of <a>LatLongRect</a> with the minimum fields required
--   to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>llrMaxLatLng</a></li>
--   <li><a>llrMinLatLng</a></li>
--   </ul>
latLongRect :: LatLongRect

-- | Max lat/long pair.
llrMaxLatLng :: Lens' LatLongRect (Maybe LatLng)

-- | Min lat/long pair.
llrMinLatLng :: Lens' LatLongRect (Maybe LatLng)

-- | Response to a batch image annotation request.
--   
--   <i>See:</i> <a>batchAnnotateImagesResponse</a> smart constructor.
data BatchAnnotateImagesResponse

-- | Creates a value of <a>BatchAnnotateImagesResponse</a> with the minimum
--   fields required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>bairResponses</a></li>
--   </ul>
batchAnnotateImagesResponse :: BatchAnnotateImagesResponse

-- | Individual responses to image annotation requests within the batch.
bairResponses :: Lens' BatchAnnotateImagesResponse [AnnotateImageResponse]

-- | A 3D position in the image, used primarily for Face detection
--   landmarks. A valid Position must have both x and y coordinates. The
--   position coordinates are in the same scale as the original image.
--   
--   <i>See:</i> <a>position</a> smart constructor.
data Position

-- | Creates a value of <a>Position</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>pZ</a></li>
--   <li><a>pX</a></li>
--   <li><a>pY</a></li>
--   </ul>
position :: Position

-- | Z coordinate (or depth).
pZ :: Lens' Position (Maybe Double)

-- | X coordinate.
pX :: Lens' Position (Maybe Double)

-- | Y coordinate.
pY :: Lens' Position (Maybe Double)


-- | Run image detection and annotation for a batch of images.
--   
--   <i>See:</i> <a>Google Cloud Vision API Reference</a> for
--   <tt>vision.images.annotate</tt>.
module Network.Google.Resource.Vision.Images.Annotate

-- | A resource alias for <tt>vision.images.annotate</tt> method which the
--   <a>ImagesAnnotate</a> request conforms to.
type ImagesAnnotateResource = "v1" :> ("images:annotate" :> (QueryParam "$.xgafv" Xgafv :> (QueryParam "upload_protocol" Text :> (QueryParam "pp" Bool :> (QueryParam "access_token" Text :> (QueryParam "uploadType" Text :> (QueryParam "bearer_token" Text :> (QueryParam "callback" Text :> (QueryParam "alt" AltJSON :> (ReqBody '[JSON] BatchAnnotateImagesRequest :> Post '[JSON] BatchAnnotateImagesResponse))))))))))

-- | Creates a value of <a>ImagesAnnotate</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>iaXgafv</a></li>
--   <li><a>iaUploadProtocol</a></li>
--   <li><a>iaPp</a></li>
--   <li><a>iaAccessToken</a></li>
--   <li><a>iaUploadType</a></li>
--   <li><a>iaPayload</a></li>
--   <li><a>iaBearerToken</a></li>
--   <li><a>iaCallback</a></li>
--   </ul>
imagesAnnotate :: BatchAnnotateImagesRequest -> ImagesAnnotate

-- | Run image detection and annotation for a batch of images.
--   
--   <i>See:</i> <a>imagesAnnotate</a> smart constructor.
data ImagesAnnotate

-- | V1 error format.
iaXgafv :: Lens' ImagesAnnotate (Maybe Xgafv)

-- | Upload protocol for media (e.g. "raw", "multipart").
iaUploadProtocol :: Lens' ImagesAnnotate (Maybe Text)

-- | Pretty-print response.
iaPp :: Lens' ImagesAnnotate Bool

-- | OAuth access token.
iaAccessToken :: Lens' ImagesAnnotate (Maybe Text)

-- | Legacy upload protocol for media (e.g. "media", "multipart").
iaUploadType :: Lens' ImagesAnnotate (Maybe Text)

-- | Multipart request metadata.
iaPayload :: Lens' ImagesAnnotate BatchAnnotateImagesRequest

-- | OAuth bearer token.
iaBearerToken :: Lens' ImagesAnnotate (Maybe Text)

-- | JSONP
iaCallback :: Lens' ImagesAnnotate (Maybe Text)
instance GHC.Generics.Generic Network.Google.Resource.Vision.Images.Annotate.ImagesAnnotate
instance Data.Data.Data Network.Google.Resource.Vision.Images.Annotate.ImagesAnnotate
instance GHC.Show.Show Network.Google.Resource.Vision.Images.Annotate.ImagesAnnotate
instance GHC.Classes.Eq Network.Google.Resource.Vision.Images.Annotate.ImagesAnnotate
instance Network.Google.Types.GoogleRequest Network.Google.Resource.Vision.Images.Annotate.ImagesAnnotate


-- | Integrates Google Vision features, including image labeling, face,
--   logo, and landmark detection, optical character recognition (OCR), and
--   detection of explicit content, into applications.
--   
--   <i>See:</i> <a>Google Cloud Vision API Reference</a>
module Network.Google.Vision

-- | Default request referring to version <tt>v1</tt> of the Google Cloud
--   Vision API. This contains the host and root path used as a starting
--   point for constructing service requests.
visionService :: ServiceConfig

-- | View and manage your data across Google Cloud Platform services
cloudPlatformScope :: Proxy '["https://www.googleapis.com/auth/cloud-platform"]

-- | Represents the entirety of the methods and resources available for the
--   Google Cloud Vision API service.
type VisionAPI = ImagesAnnotateResource

-- | An object representing a latitude/longitude pair. This is expressed as
--   a pair of doubles representing degrees latitude and degrees longitude.
--   Unless specified otherwise, this must conform to the <a>WGS84
--   standard</a>. Values must be within normalized ranges. Example of
--   normalization code in Python: def NormalizeLongitude(longitude):
--   """Wraps decimal degrees longitude to [-180.0, 180.0].""" q, r =
--   divmod(longitude, 360.0) if r &gt; 180.0 or (r == 180.0 and q &lt;=
--   -1.0): return r - 360.0 return r def NormalizeLatLng(latitude,
--   longitude): """Wraps decimal degrees latitude and longitude to [-90.0,
--   90.0] and [-180.0, 180.0], respectively.""" r = latitude % 360.0 if r
--   &lt;= 90.0: return r, NormalizeLongitude(longitude) elif r &gt;=
--   270.0: return r - 360, NormalizeLongitude(longitude) else: return 180
--   - r, NormalizeLongitude(longitude + 180.0) assert 180.0 ==
--   NormalizeLongitude(180.0) assert -180.0 == NormalizeLongitude(-180.0)
--   assert -179.0 == NormalizeLongitude(181.0) assert (0.0, 0.0) ==
--   NormalizeLatLng(360.0, 0.0) assert (0.0, 0.0) ==
--   NormalizeLatLng(-360.0, 0.0) assert (85.0, 180.0) ==
--   NormalizeLatLng(95.0, 0.0) assert (-85.0, -170.0) ==
--   NormalizeLatLng(-95.0, 10.0) assert (90.0, 10.0) ==
--   NormalizeLatLng(90.0, 10.0) assert (-90.0, -10.0) ==
--   NormalizeLatLng(-90.0, -10.0) assert (0.0, -170.0) ==
--   NormalizeLatLng(-180.0, 10.0) assert (0.0, -170.0) ==
--   NormalizeLatLng(180.0, 10.0) assert (-90.0, 10.0) ==
--   NormalizeLatLng(270.0, 10.0) assert (90.0, 10.0) ==
--   NormalizeLatLng(-270.0, 10.0) The code in
--   logs/storage/validator/logs_validator_traits.cc treats this type as if
--   it were annotated as ST_LOCATION.
--   
--   <i>See:</i> <a>latLng</a> smart constructor.
data LatLng

-- | Creates a value of <a>LatLng</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>llLatitude</a></li>
--   <li><a>llLongitude</a></li>
--   </ul>
latLng :: LatLng

-- | The latitude in degrees. It must be in the range [-90.0, +90.0].
llLatitude :: Lens' LatLng (Maybe Double)

-- | The longitude in degrees. It must be in the range [-180.0, +180.0].
llLongitude :: Lens' LatLng (Maybe Double)

-- | Under-exposed likelihood.
data FaceAnnotationUnderExposedLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
Unknown :: FaceAnnotationUnderExposedLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
VeryUnlikely :: FaceAnnotationUnderExposedLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
Unlikely :: FaceAnnotationUnderExposedLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
Possible :: FaceAnnotationUnderExposedLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
Likely :: FaceAnnotationUnderExposedLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
VeryLikely :: FaceAnnotationUnderExposedLikelihood

-- | Users describe the type of Google Cloud Vision API tasks to perform
--   over images by using *Feature*s. Each Feature indicates a type of
--   image detection task to perform. Features encode the Cloud Vision API
--   vertical to operate on and the number of top-scoring results to
--   return.
--   
--   <i>See:</i> <a>feature</a> smart constructor.
data Feature

-- | Creates a value of <a>Feature</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>fType</a></li>
--   <li><a>fMaxResults</a></li>
--   </ul>
feature :: Feature

-- | The feature type.
fType :: Lens' Feature (Maybe FeatureType)

-- | Maximum number of results of this type.
fMaxResults :: Lens' Feature (Maybe Int32)

-- | The `Status` type defines a logical error model that is suitable for
--   different programming environments, including REST APIs and RPC APIs.
--   It is used by <a>gRPC</a>. The error model is designed to be: - Simple
--   to use and understand for most users - Flexible enough to meet
--   unexpected needs # Overview The `Status` message contains three pieces
--   of data: error code, error message, and error details. The error code
--   should be an enum value of google.rpc.Code, but it may accept
--   additional error codes if needed. The error message should be a
--   developer-facing English message that helps developers *understand*
--   and *resolve* the error. If a localized user-facing error message is
--   needed, put the localized message in the error details or localize it
--   in the client. The optional error details may contain arbitrary
--   information about the error. There is a predefined set of error detail
--   types in the package `google.rpc` which can be used for common error
--   conditions. # Language mapping The `Status` message is the logical
--   representation of the error model, but it is not necessarily the
--   actual wire format. When the `Status` message is exposed in different
--   client libraries and different wire protocols, it can be mapped
--   differently. For example, it will likely be mapped to some exceptions
--   in Java, but more likely mapped to some error codes in C. # Other uses
--   The error model and the `Status` message can be used in a variety of
--   environments, either with or without APIs, to provide a consistent
--   developer experience across different environments. Example uses of
--   this error model include: - Partial errors. If a service needs to
--   return partial errors to the client, it may embed the `Status` in the
--   normal response to indicate the partial errors. - Workflow errors. A
--   typical workflow has multiple steps. Each step may have a `Status`
--   message for error reporting purpose. - Batch operations. If a client
--   uses batch request and batch response, the `Status` message should be
--   used directly inside batch response, one for each error sub-response.
--   - Asynchronous operations. If an API call embeds asynchronous
--   operation results in its response, the status of those operations
--   should be represented directly using the `Status` message. - Logging.
--   If some API errors are stored in logs, the message `Status` could be
--   used directly after any stripping needed for security/privacy reasons.
--   
--   <i>See:</i> <a>status</a> smart constructor.
data Status

-- | Creates a value of <a>Status</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>sDetails</a></li>
--   <li><a>sCode</a></li>
--   <li><a>sMessage</a></li>
--   </ul>
status :: Status

-- | A list of messages that carry the error details. There will be a
--   common set of message types for APIs to use.
sDetails :: Lens' Status [StatusDetailsItem]

-- | The status code, which should be an enum value of google.rpc.Code.
sCode :: Lens' Status (Maybe Int32)

-- | A developer-facing error message, which should be in English. Any
--   user-facing error message should be localized and sent in the
--   google.rpc.Status.details field, or localized by the client.
sMessage :: Lens' Status (Maybe Text)

-- | A `Property` consists of a user-supplied name/value pair.
--   
--   <i>See:</i> <a>property</a> smart constructor.
data Property

-- | Creates a value of <a>Property</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>pValue</a></li>
--   <li><a>pName</a></li>
--   </ul>
property :: Property

-- | Value of the property.
pValue :: Lens' Property (Maybe Text)

-- | Name of the property.
pName :: Lens' Property (Maybe Text)

-- | Client image to perform Google Cloud Vision API tasks over.
--   
--   <i>See:</i> <a>image</a> smart constructor.
data Image

-- | Creates a value of <a>Image</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>iContent</a></li>
--   <li><a>iSource</a></li>
--   </ul>
image :: Image

-- | Image content, represented as a stream of bytes. Note: as with all
--   `bytes` fields, protobuffers use a pure binary representation, whereas
--   JSON representations use base64.
iContent :: Lens' Image (Maybe ByteString)

-- | Google Cloud Storage image location. If both `content` and `source`
--   are provided for an image, `content` takes precedence and is used to
--   perform the image annotation request.
iSource :: Lens' Image (Maybe ImageSource)

-- | 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
--   &lt;= x &lt; width` or `0 &lt;= y &lt; height`.
--   
--   <i>See:</i> <a>landmark</a> smart constructor.
data Landmark

-- | Creates a value of <a>Landmark</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>lType</a></li>
--   <li><a>lPosition</a></li>
--   </ul>
landmark :: Landmark

-- | Face landmark type.
lType :: Lens' Landmark (Maybe LandmarkType)

-- | Face landmark position.
lPosition :: Lens' Landmark (Maybe Position)

-- | Represents a color in the RGBA color space. This representation is
--   designed for simplicity of conversion to/from color representations in
--   various languages over compactness; for example, the fields of this
--   representation can be trivially provided to the constructor of
--   "java.awt.Color" in Java; it can also be trivially provided to
--   UIColor's "+colorWithRed:green:blue:alpha" method in iOS; and, with
--   just a little work, it can be easily formatted into a CSS "rgba()"
--   string in JavaScript, as well. Here are some examples: Example (Java):
--   import com.google.type.Color; // ... public static java.awt.Color
--   fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ?
--   protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color(
--   protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(),
--   alpha); } public static Color toProto(java.awt.Color color) { float
--   red = (float) color.getRed(); float green = (float) color.getGreen();
--   float blue = (float) color.getBlue(); float denominator = 255.0;
--   Color.Builder resultBuilder = Color .newBuilder() .setRed(red /
--   denominator) .setGreen(green / denominator) .setBlue(blue /
--   denominator); int alpha = color.getAlpha(); if (alpha != 255) {
--   result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) /
--   denominator) .build()); } return resultBuilder.build(); } // ...
--   Example (iOS / Obj-C): // ... static UIColor* fromProto(Color*
--   protocolor) { float red = [protocolor red]; float green = [protocolor
--   green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper =
--   [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) {
--   alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red
--   green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor*
--   color) { CGFloat red, green, blue, alpha; if (![color getRed:&amp;red
--   green:&amp;green blue:&amp;blue alpha:&amp;alpha]) { return nil; }
--   Color* result = [Color alloc] init]; [result setRed:red]; [result
--   setGreen:green]; [result setBlue:blue]; if (alpha &lt;= 0.9999) {
--   [result setAlpha:floatWrapperWithValue(alpha)]; } [result
--   autorelease]; return result; } // ... Example (JavaScript): // ... var
--   protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red ||
--   0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac =
--   rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green
--   = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255);
--   if (!('alpha' in rgb_color)) { return rgbToCssColor_(red, green,
--   blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams =
--   [red, green, blue].join(','); return ['rgba(', rgbParams, ',',
--   alphaFrac, ')'].join(''); }; var rgbToCssColor_ = function(red, green,
--   blue) { var rgbNumber = new Number((red &lt;&lt; 16) | (green &lt;&lt;
--   8) | blue); var hexString = rgbNumber.toString(16); var missingZeros =
--   6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i
--   &lt; missingZeros; i++) { resultBuilder.push('0'); }
--   resultBuilder.push(hexString); return resultBuilder.join(''); }; //
--   ...
--   
--   <i>See:</i> <a>color</a> smart constructor.
data Color

-- | Creates a value of <a>Color</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>cRed</a></li>
--   <li><a>cAlpha</a></li>
--   <li><a>cGreen</a></li>
--   <li><a>cBlue</a></li>
--   </ul>
color :: Color

-- | The amount of red in the color as a value in the interval [0, 1].
cRed :: Lens' Color (Maybe Double)

-- | The fraction of this color that should be applied to the pixel. That
--   is, the final pixel color is defined by the equation: pixel color =
--   alpha * (this color) + (1.0 - alpha) * (background color) This means
--   that a value of 1.0 corresponds to a solid color, whereas a value of
--   0.0 corresponds to a completely transparent color. This uses a wrapper
--   message rather than a simple float scalar so that it is possible to
--   distinguish between a default value and the value being unset. If
--   omitted, this color object is to be rendered as a solid color (as if
--   the alpha value had been explicitly given with a value of 1.0).
cAlpha :: Lens' Color (Maybe Double)

-- | The amount of green in the color as a value in the interval [0, 1].
cGreen :: Lens' Color (Maybe Double)

-- | The amount of blue in the color as a value in the interval [0, 1].
cBlue :: Lens' Color (Maybe Double)

-- | Headwear likelihood.
data FaceAnnotationHeadwearLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FAHLUnknown :: FaceAnnotationHeadwearLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FAHLVeryUnlikely :: FaceAnnotationHeadwearLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FAHLUnlikely :: FaceAnnotationHeadwearLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FAHLPossible :: FaceAnnotationHeadwearLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FAHLLikely :: FaceAnnotationHeadwearLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FAHLVeryLikely :: FaceAnnotationHeadwearLikelihood

-- | A bounding polygon for the detected image annotation.
--   
--   <i>See:</i> <a>boundingPoly</a> smart constructor.
data BoundingPoly

-- | Creates a value of <a>BoundingPoly</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>bpVertices</a></li>
--   </ul>
boundingPoly :: BoundingPoly

-- | The bounding polygon vertices.
bpVertices :: Lens' BoundingPoly [Vertex]

-- | Represents the adult content likelihood for the image.
data SafeSearchAnnotationAdult

-- | <tt>UNKNOWN</tt> Unknown likelihood.
SSAAUnknown :: SafeSearchAnnotationAdult

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
SSAAVeryUnlikely :: SafeSearchAnnotationAdult

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
SSAAUnlikely :: SafeSearchAnnotationAdult

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
SSAAPossible :: SafeSearchAnnotationAdult

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
SSAALikely :: SafeSearchAnnotationAdult

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
SSAAVeryLikely :: SafeSearchAnnotationAdult

-- | A vertex represents a 2D point in the image. NOTE: the vertex
--   coordinates are in the same scale as the original image.
--   
--   <i>See:</i> <a>vertex</a> smart constructor.
data Vertex

-- | Creates a value of <a>Vertex</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>vX</a></li>
--   <li><a>vY</a></li>
--   </ul>
vertex :: Vertex

-- | X coordinate.
vX :: Lens' Vertex (Maybe Int32)

-- | Y coordinate.
vY :: Lens' Vertex (Maybe Int32)

-- | Anger likelihood.
data FaceAnnotationAngerLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FAALUnknown :: FaceAnnotationAngerLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FAALVeryUnlikely :: FaceAnnotationAngerLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FAALUnlikely :: FaceAnnotationAngerLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FAALPossible :: FaceAnnotationAngerLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FAALLikely :: FaceAnnotationAngerLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FAALVeryLikely :: FaceAnnotationAngerLikelihood

-- | Detected entity location information.
--   
--   <i>See:</i> <a>locationInfo</a> smart constructor.
data LocationInfo

-- | Creates a value of <a>LocationInfo</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>liLatLng</a></li>
--   </ul>
locationInfo :: LocationInfo

-- | lat/long location coordinates.
liLatLng :: Lens' LocationInfo (Maybe LatLng)

-- | Likelihood that this is a medical image.
data SafeSearchAnnotationMedical

-- | <tt>UNKNOWN</tt> Unknown likelihood.
SSAMUnknown :: SafeSearchAnnotationMedical

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
SSAMVeryUnlikely :: SafeSearchAnnotationMedical

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
SSAMUnlikely :: SafeSearchAnnotationMedical

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
SSAMPossible :: SafeSearchAnnotationMedical

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
SSAMLikely :: SafeSearchAnnotationMedical

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
SSAMVeryLikely :: SafeSearchAnnotationMedical
data StatusDetailsItem

-- | Creates a value of <a>StatusDetailsItem</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>sdiAddtional</a></li>
--   </ul>
statusDetailsItem :: HashMap Text JSONValue -> StatusDetailsItem

-- | Properties of the object. Contains field 'type with type URL.
sdiAddtional :: Lens' StatusDetailsItem (HashMap Text JSONValue)

-- | Multiple image annotation requests are batched into a single service
--   call.
--   
--   <i>See:</i> <a>batchAnnotateImagesRequest</a> smart constructor.
data BatchAnnotateImagesRequest

-- | Creates a value of <a>BatchAnnotateImagesRequest</a> with the minimum
--   fields required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>bairRequests</a></li>
--   </ul>
batchAnnotateImagesRequest :: BatchAnnotateImagesRequest

-- | Individual image annotation requests for this batch.
bairRequests :: Lens' BatchAnnotateImagesRequest [AnnotateImageRequest]

-- | Color information consists of RGB channels, score, and the fraction of
--   the image that the color occupies in the image.
--   
--   <i>See:</i> <a>colorInfo</a> smart constructor.
data ColorInfo

-- | Creates a value of <a>ColorInfo</a> with the minimum fields required
--   to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>ciColor</a></li>
--   <li><a>ciScore</a></li>
--   <li><a>ciPixelFraction</a></li>
--   </ul>
colorInfo :: ColorInfo

-- | RGB components of the color.
ciColor :: Lens' ColorInfo (Maybe Color)

-- | Image-specific score for this color. Value in range [0, 1].
ciScore :: Lens' ColorInfo (Maybe Double)

-- | The fraction of pixels the color occupies in the image. Value in range
--   [0, 1].
ciPixelFraction :: Lens' ColorInfo (Maybe Double)

-- | Blurred likelihood.
data FaceAnnotationBlurredLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FABLUnknown :: FaceAnnotationBlurredLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FABLVeryUnlikely :: FaceAnnotationBlurredLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FABLUnlikely :: FaceAnnotationBlurredLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FABLPossible :: FaceAnnotationBlurredLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FABLLikely :: FaceAnnotationBlurredLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FABLVeryLikely :: FaceAnnotationBlurredLikelihood

-- | Response to an image annotation request.
--   
--   <i>See:</i> <a>annotateImageResponse</a> smart constructor.
data AnnotateImageResponse

-- | Creates a value of <a>AnnotateImageResponse</a> with the minimum
--   fields required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>airLogoAnnotations</a></li>
--   <li><a>airLabelAnnotations</a></li>
--   <li><a>airFaceAnnotations</a></li>
--   <li><a>airError</a></li>
--   <li><a>airSafeSearchAnnotation</a></li>
--   <li><a>airLandmarkAnnotations</a></li>
--   <li><a>airTextAnnotations</a></li>
--   <li><a>airImagePropertiesAnnotation</a></li>
--   </ul>
annotateImageResponse :: AnnotateImageResponse

-- | If present, logo detection has completed successfully.
airLogoAnnotations :: Lens' AnnotateImageResponse [EntityAnnotation]

-- | If present, label detection has completed successfully.
airLabelAnnotations :: Lens' AnnotateImageResponse [EntityAnnotation]

-- | If present, face detection has completed successfully.
airFaceAnnotations :: Lens' AnnotateImageResponse [FaceAnnotation]

-- | If set, represents the error message for the operation. Note that
--   filled-in image annotations are guaranteed to be correct, even when
--   `error` is set.
airError :: Lens' AnnotateImageResponse (Maybe Status)

-- | If present, safe-search annotation has completed successfully.
airSafeSearchAnnotation :: Lens' AnnotateImageResponse (Maybe SafeSearchAnnotation)

-- | If present, landmark detection has completed successfully.
airLandmarkAnnotations :: Lens' AnnotateImageResponse [EntityAnnotation]

-- | If present, text (OCR) detection has completed successfully.
airTextAnnotations :: Lens' AnnotateImageResponse [EntityAnnotation]

-- | If present, image properties were extracted successfully.
airImagePropertiesAnnotation :: Lens' AnnotateImageResponse (Maybe ImageProperties)

-- | Stores image properties, such as dominant colors.
--   
--   <i>See:</i> <a>imageProperties</a> smart constructor.
data ImageProperties

-- | Creates a value of <a>ImageProperties</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>ipDominantColors</a></li>
--   </ul>
imageProperties :: ImageProperties

-- | If present, dominant colors completed successfully.
ipDominantColors :: Lens' ImageProperties (Maybe DominantColorsAnnotation)

-- | A face annotation object contains the results of face detection.
--   
--   <i>See:</i> <a>faceAnnotation</a> smart constructor.
data FaceAnnotation

-- | Creates a value of <a>FaceAnnotation</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>faTiltAngle</a></li>
--   <li><a>faBlurredLikelihood</a></li>
--   <li><a>faBoundingPoly</a></li>
--   <li><a>faSurpriseLikelihood</a></li>
--   <li><a>faLandmarkingConfidence</a></li>
--   <li><a>faPanAngle</a></li>
--   <li><a>faRollAngle</a></li>
--   <li><a>faUnderExposedLikelihood</a></li>
--   <li><a>faFdBoundingPoly</a></li>
--   <li><a>faAngerLikelihood</a></li>
--   <li><a>faDetectionConfidence</a></li>
--   <li><a>faHeadwearLikelihood</a></li>
--   <li><a>faSorrowLikelihood</a></li>
--   <li><a>faJoyLikelihood</a></li>
--   <li><a>faLandmarks</a></li>
--   </ul>
faceAnnotation :: FaceAnnotation

-- | Pitch angle, which indicates the upwards/downwards angle that the face
--   is pointing relative to the image's horizontal plane. Range
--   [-180,180].
faTiltAngle :: Lens' FaceAnnotation (Maybe Double)

-- | Blurred likelihood.
faBlurredLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationBlurredLikelihood)

-- | 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.
faBoundingPoly :: Lens' FaceAnnotation (Maybe BoundingPoly)

-- | Surprise likelihood.
faSurpriseLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationSurpriseLikelihood)

-- | Face landmarking confidence. Range [0, 1].
faLandmarkingConfidence :: Lens' FaceAnnotation (Maybe Double)

-- | 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].
faPanAngle :: Lens' FaceAnnotation (Maybe Double)

-- | 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].
faRollAngle :: Lens' FaceAnnotation (Maybe Double)

-- | Under-exposed likelihood.
faUnderExposedLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationUnderExposedLikelihood)

-- | 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 <tt>fd</tt> (face detection) prefix.
faFdBoundingPoly :: Lens' FaceAnnotation (Maybe BoundingPoly)

-- | Anger likelihood.
faAngerLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationAngerLikelihood)

-- | Detection confidence. Range [0, 1].
faDetectionConfidence :: Lens' FaceAnnotation (Maybe Double)

-- | Headwear likelihood.
faHeadwearLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationHeadwearLikelihood)

-- | Sorrow likelihood.
faSorrowLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationSorrowLikelihood)

-- | Joy likelihood.
faJoyLikelihood :: Lens' FaceAnnotation (Maybe FaceAnnotationJoyLikelihood)

-- | Detected face landmarks.
faLandmarks :: Lens' FaceAnnotation [Landmark]

-- | Violence likelihood.
data SafeSearchAnnotationViolence

-- | <tt>UNKNOWN</tt> Unknown likelihood.
SSAVUnknown :: SafeSearchAnnotationViolence

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
SSAVVeryUnlikely :: SafeSearchAnnotationViolence

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
SSAVUnlikely :: SafeSearchAnnotationViolence

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
SSAVPossible :: SafeSearchAnnotationViolence

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
SSAVLikely :: SafeSearchAnnotationViolence

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
SSAVVeryLikely :: SafeSearchAnnotationViolence

-- | Set of detected entity features.
--   
--   <i>See:</i> <a>entityAnnotation</a> smart constructor.
data EntityAnnotation

-- | Creates a value of <a>EntityAnnotation</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>eaScore</a></li>
--   <li><a>eaTopicality</a></li>
--   <li><a>eaLocale</a></li>
--   <li><a>eaBoundingPoly</a></li>
--   <li><a>eaConfidence</a></li>
--   <li><a>eaMid</a></li>
--   <li><a>eaLocations</a></li>
--   <li><a>eaDescription</a></li>
--   <li><a>eaProperties</a></li>
--   </ul>
entityAnnotation :: EntityAnnotation

-- | Overall score of the result. Range [0, 1].
eaScore :: Lens' EntityAnnotation (Maybe Double)

-- | The relevancy of the ICA (Image Content Annotation) label to the
--   image. For example, the relevancy of "tower" is likely higher to an
--   image containing the detected "Eiffel Tower" than to an image
--   containing a detected distant towering building, even though the
--   confidence that there is a tower in each image may be the same. Range
--   [0, 1].
eaTopicality :: Lens' EntityAnnotation (Maybe Double)

-- | The language code for the locale in which the entity textual
--   `description` is expressed.
eaLocale :: Lens' EntityAnnotation (Maybe Text)

-- | Image region to which this entity belongs. Currently not produced for
--   `LABEL_DETECTION` features. For `TEXT_DETECTION` (OCR),
--   `boundingPoly`s are produced for the entire text detected in an image
--   region, followed by `boundingPoly`s for each word within the detected
--   text.
eaBoundingPoly :: Lens' EntityAnnotation (Maybe BoundingPoly)

-- | The accuracy of the entity detection in an image. For example, for an
--   image in which the "Eiffel Tower" entity is detected, this field
--   represents the confidence that there is a tower in the query image.
--   Range [0, 1].
eaConfidence :: Lens' EntityAnnotation (Maybe Double)

-- | Opaque entity ID. Some IDs may be available in <a>Google Knowledge
--   Graph Search API</a>.
eaMid :: Lens' EntityAnnotation (Maybe Text)

-- | The location information for the detected entity. Multiple
--   `LocationInfo` elements can be present because one location may
--   indicate the location of the scene in the image, and another location
--   may indicate the location of the place where the image was taken.
--   Location information is usually present for landmarks.
eaLocations :: Lens' EntityAnnotation [LocationInfo]

-- | Entity textual description, expressed in its `locale` language.
eaDescription :: Lens' EntityAnnotation (Maybe Text)

-- | Some entities may have optional user-supplied `Property` (name/value)
--   fields, such a score or string that qualifies the entity.
eaProperties :: Lens' EntityAnnotation [Property]

-- | The feature type.
data FeatureType

-- | <tt>TYPE_UNSPECIFIED</tt> Unspecified feature type.
TypeUnspecified :: FeatureType

-- | <tt>FACE_DETECTION</tt> Run face detection.
FaceDetection :: FeatureType

-- | <tt>LANDMARK_DETECTION</tt> Run landmark detection.
LandmarkDetection :: FeatureType

-- | <tt>LOGO_DETECTION</tt> Run logo detection.
LogoDetection :: FeatureType

-- | <tt>LABEL_DETECTION</tt> Run label detection.
LabelDetection :: FeatureType

-- | <tt>TEXT_DETECTION</tt> Run OCR.
TextDetection :: FeatureType

-- | <tt>SAFE_SEARCH_DETECTION</tt> Run computer vision models to compute
--   image safe-search properties.
SafeSearchDetection :: FeatureType

-- | <tt>IMAGE_PROPERTIES</tt> Compute a set of image properties, such as
--   the image's dominant colors.
ImageProperties :: FeatureType

-- | Request for performing Google Cloud Vision API tasks over a
--   user-provided image, with user-requested features.
--   
--   <i>See:</i> <a>annotateImageRequest</a> smart constructor.
data AnnotateImageRequest

-- | Creates a value of <a>AnnotateImageRequest</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>airImage</a></li>
--   <li><a>airFeatures</a></li>
--   <li><a>airImageContext</a></li>
--   </ul>
annotateImageRequest :: AnnotateImageRequest

-- | The image to be processed.
airImage :: Lens' AnnotateImageRequest (Maybe Image)

-- | Requested features.
airFeatures :: Lens' AnnotateImageRequest [Feature]

-- | Additional context that may accompany the image.
airImageContext :: Lens' AnnotateImageRequest (Maybe ImageContext)

-- | Face landmark type.
data LandmarkType

-- | <tt>UNKNOWN_LANDMARK</tt> Unknown face landmark detected. Should not
--   be filled.
UnknownLandmark :: LandmarkType

-- | <tt>LEFT_EYE</tt> Left eye.
LeftEye :: LandmarkType

-- | <tt>RIGHT_EYE</tt> Right eye.
RightEye :: LandmarkType

-- | <tt>LEFT_OF_LEFT_EYEBROW</tt> Left of left eyebrow.
LeftOfLeftEyebrow :: LandmarkType

-- | <tt>RIGHT_OF_LEFT_EYEBROW</tt> Right of left eyebrow.
RightOfLeftEyebrow :: LandmarkType

-- | <tt>LEFT_OF_RIGHT_EYEBROW</tt> Left of right eyebrow.
LeftOfRightEyebrow :: LandmarkType

-- | <tt>RIGHT_OF_RIGHT_EYEBROW</tt> Right of right eyebrow.
RightOfRightEyebrow :: LandmarkType

-- | <tt>MIDPOINT_BETWEEN_EYES</tt> Midpoint between eyes.
MidpointBetweenEyes :: LandmarkType

-- | <tt>NOSE_TIP</tt> Nose tip.
NoseTip :: LandmarkType

-- | <tt>UPPER_LIP</tt> Upper lip.
UpperLip :: LandmarkType

-- | <tt>LOWER_LIP</tt> Lower lip.
LowerLip :: LandmarkType

-- | <tt>MOUTH_LEFT</tt> Mouth left.
MouthLeft :: LandmarkType

-- | <tt>MOUTH_RIGHT</tt> Mouth right.
MouthRight :: LandmarkType

-- | <tt>MOUTH_CENTER</tt> Mouth center.
MouthCenter :: LandmarkType

-- | <tt>NOSE_BOTTOM_RIGHT</tt> Nose, bottom right.
NoseBottomRight :: LandmarkType

-- | <tt>NOSE_BOTTOM_LEFT</tt> Nose, bottom left.
NoseBottomLeft :: LandmarkType

-- | <tt>NOSE_BOTTOM_CENTER</tt> Nose, bottom center.
NoseBottomCenter :: LandmarkType

-- | <tt>LEFT_EYE_TOP_BOUNDARY</tt> Left eye, top boundary.
LeftEyeTopBoundary :: LandmarkType

-- | <tt>LEFT_EYE_RIGHT_CORNER</tt> Left eye, right corner.
LeftEyeRightCorner :: LandmarkType

-- | <tt>LEFT_EYE_BOTTOM_BOUNDARY</tt> Left eye, bottom boundary.
LeftEyeBottomBoundary :: LandmarkType

-- | <tt>LEFT_EYE_LEFT_CORNER</tt> Left eye, left corner.
LeftEyeLeftCorner :: LandmarkType

-- | <tt>RIGHT_EYE_TOP_BOUNDARY</tt> Right eye, top boundary.
RightEyeTopBoundary :: LandmarkType

-- | <tt>RIGHT_EYE_RIGHT_CORNER</tt> Right eye, right corner.
RightEyeRightCorner :: LandmarkType

-- | <tt>RIGHT_EYE_BOTTOM_BOUNDARY</tt> Right eye, bottom boundary.
RightEyeBottomBoundary :: LandmarkType

-- | <tt>RIGHT_EYE_LEFT_CORNER</tt> Right eye, left corner.
RightEyeLeftCorner :: LandmarkType

-- | <tt>LEFT_EYEBROW_UPPER_MIDPOINT</tt> Left eyebrow, upper midpoint.
LeftEyebrowUpperMidpoint :: LandmarkType

-- | <tt>RIGHT_EYEBROW_UPPER_MIDPOINT</tt> Right eyebrow, upper midpoint.
RightEyebrowUpperMidpoint :: LandmarkType

-- | <tt>LEFT_EAR_TRAGION</tt> Left ear tragion.
LeftEarTragion :: LandmarkType

-- | <tt>RIGHT_EAR_TRAGION</tt> Right ear tragion.
RightEarTragion :: LandmarkType

-- | <tt>LEFT_EYE_PUPIL</tt> Left eye pupil.
LeftEyePupil :: LandmarkType

-- | <tt>RIGHT_EYE_PUPIL</tt> Right eye pupil.
RightEyePupil :: LandmarkType

-- | <tt>FOREHEAD_GLABELLA</tt> Forehead glabella.
ForeheadGlabella :: LandmarkType

-- | <tt>CHIN_GNATHION</tt> Chin gnathion.
ChinGnathion :: LandmarkType

-- | <tt>CHIN_LEFT_GONION</tt> Chin left gonion.
ChinLeftGonion :: LandmarkType

-- | <tt>CHIN_RIGHT_GONION</tt> Chin right gonion.
ChinRightGonion :: LandmarkType

-- | V1 error format.
data Xgafv

-- | <tt>1</tt> v1 error format
X1 :: Xgafv

-- | <tt>2</tt> v2 error format
X2 :: Xgafv

-- | External image source (Google Cloud Storage image location).
--   
--   <i>See:</i> <a>imageSource</a> smart constructor.
data ImageSource

-- | Creates a value of <a>ImageSource</a> with the minimum fields required
--   to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>isGcsImageURI</a></li>
--   </ul>
imageSource :: ImageSource

-- | Google Cloud Storage image URI, which must be in the following form:
--   `gs://bucket_name/object_name` (for details, see <a>Google Cloud
--   Storage Request URIs</a>). NOTE: Cloud Storage object versioning is
--   not supported.
isGcsImageURI :: Lens' ImageSource (Maybe Text)

-- | Spoof likelihood. The likelihood that an modification was made to the
--   image's canonical version to make it appear funny or offensive.
data SafeSearchAnnotationSpoof

-- | <tt>UNKNOWN</tt> Unknown likelihood.
SSASUnknown :: SafeSearchAnnotationSpoof

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
SSASVeryUnlikely :: SafeSearchAnnotationSpoof

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
SSASUnlikely :: SafeSearchAnnotationSpoof

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
SSASPossible :: SafeSearchAnnotationSpoof

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
SSASLikely :: SafeSearchAnnotationSpoof

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
SSASVeryLikely :: SafeSearchAnnotationSpoof

-- | Surprise likelihood.
data FaceAnnotationSurpriseLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FASLUnknown :: FaceAnnotationSurpriseLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FASLVeryUnlikely :: FaceAnnotationSurpriseLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FASLUnlikely :: FaceAnnotationSurpriseLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FASLPossible :: FaceAnnotationSurpriseLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FASLLikely :: FaceAnnotationSurpriseLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FASLVeryLikely :: FaceAnnotationSurpriseLikelihood
data SafeSearchAnnotation

-- | Creates a value of <a>SafeSearchAnnotation</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>ssaSpoof</a></li>
--   <li><a>ssaAdult</a></li>
--   <li><a>ssaMedical</a></li>
--   <li><a>ssaViolence</a></li>
--   </ul>
safeSearchAnnotation :: SafeSearchAnnotation

-- | Spoof likelihood. The likelihood that an modification was made to the
--   image's canonical version to make it appear funny or offensive.
ssaSpoof :: Lens' SafeSearchAnnotation (Maybe SafeSearchAnnotationSpoof)

-- | Represents the adult content likelihood for the image.
ssaAdult :: Lens' SafeSearchAnnotation (Maybe SafeSearchAnnotationAdult)

-- | Likelihood that this is a medical image.
ssaMedical :: Lens' SafeSearchAnnotation (Maybe SafeSearchAnnotationMedical)

-- | Violence likelihood.
ssaViolence :: Lens' SafeSearchAnnotation (Maybe SafeSearchAnnotationViolence)

-- | Sorrow likelihood.
data FaceAnnotationSorrowLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FUnknown :: FaceAnnotationSorrowLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FVeryUnlikely :: FaceAnnotationSorrowLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FUnlikely :: FaceAnnotationSorrowLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FPossible :: FaceAnnotationSorrowLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FLikely :: FaceAnnotationSorrowLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FVeryLikely :: FaceAnnotationSorrowLikelihood

-- | Joy likelihood.
data FaceAnnotationJoyLikelihood

-- | <tt>UNKNOWN</tt> Unknown likelihood.
FAJLUnknown :: FaceAnnotationJoyLikelihood

-- | <tt>VERY_UNLIKELY</tt> It is very unlikely that the image belongs to
--   the specified vertical.
FAJLVeryUnlikely :: FaceAnnotationJoyLikelihood

-- | <tt>UNLIKELY</tt> It is unlikely that the image belongs to the
--   specified vertical.
FAJLUnlikely :: FaceAnnotationJoyLikelihood

-- | <tt>POSSIBLE</tt> It is possible that the image belongs to the
--   specified vertical.
FAJLPossible :: FaceAnnotationJoyLikelihood

-- | <tt>LIKELY</tt> It is likely that the image belongs to the specified
--   vertical.
FAJLLikely :: FaceAnnotationJoyLikelihood

-- | <tt>VERY_LIKELY</tt> It is very likely that the image belongs to the
--   specified vertical.
FAJLVeryLikely :: FaceAnnotationJoyLikelihood

-- | Image context and/or feature-specific parameters.
--   
--   <i>See:</i> <a>imageContext</a> smart constructor.
data ImageContext

-- | Creates a value of <a>ImageContext</a> with the minimum fields
--   required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>icLanguageHints</a></li>
--   <li><a>icLatLongRect</a></li>
--   </ul>
imageContext :: ImageContext

-- | List of languages to use for TEXT_DETECTION. In most cases, an empty
--   value yields the best results since it enables automatic language
--   detection. For languages based on the Latin alphabet, setting
--   `language_hints` is not needed. In rare cases, when the language of
--   the text in the image is known, setting a hint will help get better
--   results (although it will be a significant hindrance if the hint is
--   wrong). Text detection returns an error if one or more of the
--   specified languages is not one of the <a>supported languages</a>.
icLanguageHints :: Lens' ImageContext [Text]

-- | lat/long rectangle that specifies the location of the image.
icLatLongRect :: Lens' ImageContext (Maybe LatLongRect)

-- | Set of dominant colors and their corresponding scores.
--   
--   <i>See:</i> <a>dominantColorsAnnotation</a> smart constructor.
data DominantColorsAnnotation

-- | Creates a value of <a>DominantColorsAnnotation</a> with the minimum
--   fields required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>dcaColors</a></li>
--   </ul>
dominantColorsAnnotation :: DominantColorsAnnotation

-- | RGB color values with their score and pixel fraction.
dcaColors :: Lens' DominantColorsAnnotation [ColorInfo]

-- | Rectangle determined by min and max `LatLng` pairs.
--   
--   <i>See:</i> <a>latLongRect</a> smart constructor.
data LatLongRect

-- | Creates a value of <a>LatLongRect</a> with the minimum fields required
--   to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>llrMaxLatLng</a></li>
--   <li><a>llrMinLatLng</a></li>
--   </ul>
latLongRect :: LatLongRect

-- | Max lat/long pair.
llrMaxLatLng :: Lens' LatLongRect (Maybe LatLng)

-- | Min lat/long pair.
llrMinLatLng :: Lens' LatLongRect (Maybe LatLng)

-- | Response to a batch image annotation request.
--   
--   <i>See:</i> <a>batchAnnotateImagesResponse</a> smart constructor.
data BatchAnnotateImagesResponse

-- | Creates a value of <a>BatchAnnotateImagesResponse</a> with the minimum
--   fields required to make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>bairResponses</a></li>
--   </ul>
batchAnnotateImagesResponse :: BatchAnnotateImagesResponse

-- | Individual responses to image annotation requests within the batch.
bairResponses :: Lens' BatchAnnotateImagesResponse [AnnotateImageResponse]

-- | A 3D position in the image, used primarily for Face detection
--   landmarks. A valid Position must have both x and y coordinates. The
--   position coordinates are in the same scale as the original image.
--   
--   <i>See:</i> <a>position</a> smart constructor.
data Position

-- | Creates a value of <a>Position</a> with the minimum fields required to
--   make a request.
--   
--   Use one of the following lenses to modify other fields as desired:
--   
--   <ul>
--   <li><a>pZ</a></li>
--   <li><a>pX</a></li>
--   <li><a>pY</a></li>
--   </ul>
position :: Position

-- | Z coordinate (or depth).
pZ :: Lens' Position (Maybe Double)

-- | X coordinate.
pX :: Lens' Position (Maybe Double)

-- | Y coordinate.
pY :: Lens' Position (Maybe Double)
