help_text:
  language_hints: |
    Language hints can be provided to Google Cloud Vision API. 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. Text detection returns an error if one or
    more of the specified languages is not one of the supported languages.
    (See https://cloud.google.com/vision/docs/languages.) To provide language
    hints run:

      $ {command} --language-hints ja,ko

request:
  collection: vision.images
  method: annotate
  api_version: v1

response:
  error:
    field: responses.error
    code: code
    message: message

args:
  image_field:
    api_field: requests.image
    arg_name: image_path
    is_positional: true
    help_text: |
      Path to the image to be analyzed. This can be either a local path
      or a URL. If you provide a local file, the contents will be sent
      directly to Google Cloud Vision. If you provide a URL, it must be in
      Google Cloud Storage format (gs://bucket/object) or an HTTP URL
      (http://... or https://...)
    processor: googlecloudsdk.command_lib.ml.vision.util:GetImageFromPath

  language_hints_field:
    api_field: requests.imageContext.languageHints
    arg_name: language-hints
    help_text: List of languages to use for text detection.

  max_results_field:
    api_field: requests.features.maxResults
    arg_name: max-results
    help_text: Maximum number of results to be provided.

  model_field:
    api_field: requests.features.model
    arg_name: model-version
    default: builtin/stable
    release_tracks: [ALPHA, BETA]
    help_text: |
      Model version to use for the feature.
    type: str
    choices:
    - arg_value: builtin/stable
      enum_value: builtin/stable
    - arg_value: builtin/latest
      enum_value: builtin/latest
