Method: images.annotate

Ejecuta la detección y la anotación de imágenes en un lote de imágenes.

Solicitud HTTP

POST https://vision.googleapis.com/v1p3beta1/images:annotate

La URL utiliza la sintaxis de transcodificación a gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos que presentan la siguiente estructura:

Representación JSON 
{
  "requests": [
    {
      object(AnnotateImageRequest)
    }
  ]
}
Campos
requests[]

object(AnnotateImageRequest)

Solicitudes de anotación de imágenes individuales de este lote.

Cuerpo de la respuesta

Si la solicitud se realiza correctamente, el cuerpo de la respuesta proporciona datos con la siguiente estructura:

Respuesta a una solicitud de anotación de imágenes por lotes.

Representación JSON 
{
  "responses": [
    {
      object(AnnotateImageResponse)
    }
  ]
}
Campos
responses[]

object(AnnotateImageResponse)

Respuestas individuales a las solicitudes de anotación de imágenes del lote.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Para obtener más información, consulta el artículo Descripción general de la autenticación.

AnnotateImageRequest

Solicitud para realizar tareas de la API Cloud Vision en una imagen proporcionada por el usuario, con las funciones solicitadas por el usuario.

Representación JSON 
{
  "image": {
    object(Image)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  }
}
Campos
image

object(Image)

La imagen que se va a procesar.

features[]

object(Feature)

Funciones solicitadas.

imageContext

object(ImageContext)

Contexto adicional que puede acompañar a la imagen.

Imagen

Imagen de cliente para realizar tareas de la API Cloud Vision de Google.

Representación JSON 
{
  "content": string,
  "source": {
    object(ImageSource)
  }
}
Campos
content

string (bytes format)

Contenido de la imagen, representado como un flujo de bytes. Nota: Al igual que con todos los campos bytes, los protobuffers usan una representación binaria pura, mientras que las representaciones JSON usan base64.

Cadena codificada en base64.
source

object(ImageSource)

Ubicación de la imagen en Google Cloud Storage o URL de la imagen de acceso público. Si se proporcionan content y source para una imagen, content tiene prioridad y se usa para realizar la solicitud de anotación de la imagen.

ImageSource

Fuente de imagen externa (Google Cloud Storage o ubicación de imagen de URL web).

Representación JSON 
{
  "gcsImageUri": string,
  "imageUri": string
}
Campos
gcsImageUri

string

Usa imageUri en su lugar.

El URI de Google Cloud Storage con el formato gs://bucket_name/object_name. No se admite el control de versiones de objetos. Consulta más información sobre los URIs de solicitud de Google Cloud Storage.
imageUri

string

URI de la imagen de origen. Puede ser:

  1. Un URI de Google Cloud Storage con el formato gs://bucket_name/object_name. No se admite el control de versiones de objetos. Consulta más información sobre los URIs de solicitud de Google Cloud Storage.

  2. Una URL HTTP o HTTPS de una imagen de acceso público. Cuando se obtienen imágenes de URLs HTTP o HTTPS, Google no puede garantizar que la solicitud se complete. Es posible que tu solicitud falle si el host especificado la deniega (por ejemplo, debido a la limitación de solicitudes o a la prevención de ataques DoS) o si Google limita las solicitudes al sitio para evitar abusos. No debes depender de imágenes alojadas externamente para las aplicaciones de producción.

Si se especifican tanto gcsImageUri como imageUri, imageUri tiene prioridad.

AnnotateImageResponse

Respuesta a una solicitud de anotación de imagen.

Representación JSON 
{
  "faceAnnotations": [
    {
      object(FaceAnnotation)
    }
  ],
  "landmarkAnnotations": [
    {
      object(EntityAnnotation)
    }
  ],
  "logoAnnotations": [
    {
      object(EntityAnnotation)
    }
  ],
  "labelAnnotations": [
    {
      object(EntityAnnotation)
    }
  ],
  "localizedObjectAnnotations": [
    {
      object(LocalizedObjectAnnotation)
    }
  ],
  "textAnnotations": [
    {
      object(EntityAnnotation)
    }
  ],
  "fullTextAnnotation": {
    object(TextAnnotation)
  },
  "safeSearchAnnotation": {
    object(SafeSearchAnnotation)
  },
  "imagePropertiesAnnotation": {
    object(ImageProperties)
  },
  "cropHintsAnnotation": {
    object(CropHintsAnnotation)
  },
  "webDetection": {
    object(WebDetection)
  },
  "productSearchResults": {
    object(ProductSearchResults)
  },
  "error": {
    object(Status)
  },
  "context": {
    object(ImageAnnotationContext)
  }
}
Campos
faceAnnotations[]

object(FaceAnnotation)

Si está presente, la detección facial se ha completado correctamente.

landmarkAnnotations[]

object(EntityAnnotation)

Si está presente, la detección de monumentos se ha completado correctamente.

logoAnnotations[]

object(EntityAnnotation)

Si está presente, la detección del logotipo se ha completado correctamente.

labelAnnotations[]

object(EntityAnnotation)

Si está presente, significa que la detección de etiquetas se ha completado correctamente.

localizedObjectAnnotations[]

object(LocalizedObjectAnnotation)

Si está presente, la detección de objetos localizada se ha completado correctamente. Se ordenarán de forma descendente por puntuación de confianza.

textAnnotations[]

object(EntityAnnotation)

Si está presente, la detección de texto (OCR) se ha completado correctamente.

fullTextAnnotation

object(TextAnnotation)

Si está presente, la detección de texto (OCR) o la detección de texto en documentos (OCR) se ha completado correctamente. Esta anotación proporciona la jerarquía estructural del texto detectado por OCR.

safeSearchAnnotation

object(SafeSearchAnnotation)

Si está presente, la anotación de búsqueda segura se ha completado correctamente.

imagePropertiesAnnotation

object(ImageProperties)

Si está presente, las propiedades de la imagen se han extraído correctamente.

cropHintsAnnotation

object(CropHintsAnnotation)

Si está presente, las sugerencias de recorte se han completado correctamente.

webDetection

object(WebDetection)

Si está presente, la detección web se ha completado correctamente.

productSearchResults

object(ProductSearchResults)

Si está presente, la búsqueda de productos se ha completado correctamente.

error

object(Status)

Si se define, representa el mensaje de error de la operación. Ten en cuenta que las anotaciones de imagen rellenadas son correctas, incluso cuando se ha definido error.

context

object(ImageAnnotationContext)

Si está presente, se necesita información contextual para saber de dónde procede la imagen.

FaceAnnotation

Un objeto de anotación de cara contiene los resultados de la detección de caras.

Representación JSON 
{
  "boundingPoly": {
    object(BoundingPoly)
  },
  "fdBoundingPoly": {
    object(BoundingPoly)
  },
  "landmarks": [
    {
      object(Landmark)
    }
  ],
  "rollAngle": number,
  "panAngle": number,
  "tiltAngle": number,
  "detectionConfidence": number,
  "landmarkingConfidence": number,
  "joyLikelihood": enum(Likelihood),
  "sorrowLikelihood": enum(Likelihood),
  "angerLikelihood": enum(Likelihood),
  "surpriseLikelihood": enum(Likelihood),
  "underExposedLikelihood": enum(Likelihood),
  "blurredLikelihood": enum(Likelihood),
  "headwearLikelihood": enum(Likelihood)
}
Campos
boundingPoly

object(BoundingPoly)

Polígono delimitador alrededor de la cara. Las coordenadas del cuadro delimitador están en la escala de la imagen original, tal como se devuelve en ImageParams. El cuadro delimitador se calcula para "encuadrar" la cara de acuerdo con las expectativas de los humanos. Se basa en los resultados de los puntos de referencia. Ten en cuenta que es posible que no se generen una o varias coordenadas X o Y en BoundingPoly (el polígono no tendrá límites) si solo aparece una parte de la cara en la imagen que se va a anotar.

fdBoundingPoly

object(BoundingPoly)

El polígono envolvente fdBoundingPoly es más ajustado que el boundingPoly y solo incluye la parte de la cara que corresponde a la piel. Normalmente, se usa para eliminar la cara de cualquier análisis de imagen que detecte la "cantidad de piel" visible en una imagen. No se basa en los resultados de los puntos de referencia, sino solo en la detección inicial de la cara, por lo que

fd

(detección de caras).
landmarks[]

object(Landmark)

Puntos de referencia de la cara detectados.

rollAngle

number

Ángulo de inclinación, que indica el grado de rotación de la cara en el sentido de las agujas del reloj o en el contrario con respecto a la vertical de la imagen en torno al eje perpendicular a la cara. Intervalo [-180,180].

panAngle

number

Ángulo de guiño, que indica el ángulo hacia la izquierda o hacia la derecha al que mira la cara con respecto al plano vertical perpendicular a la imagen. Intervalo [-180,180].

tiltAngle

number

Ángulo de inclinación, que indica el ángulo hacia arriba o hacia abajo al que apunta la cara con respecto al plano horizontal de la imagen. Intervalo [-180,180].

detectionConfidence

number

Confianza de detección. Intervalo [0, 1].

landmarkingConfidence

number

Confianza de los puntos de referencia faciales. Intervalo [0, 1].

joyLikelihood

enum(Likelihood)

Probabilidad de alegría.

sorrowLikelihood

enum(Likelihood)

Probabilidad de tristeza.

angerLikelihood

enum(Likelihood)

Probabilidad de enfado.

surpriseLikelihood

enum(Likelihood)

Probabilidad de sorpresa.

underExposedLikelihood

enum(Likelihood)

Probabilidad de que no se muestren suficientes anuncios.

blurredLikelihood

enum(Likelihood)

Probabilidad de desenfoque.

headwearLikelihood

enum(Likelihood)

Probabilidad de llevar accesorios para la cabeza.

Punto de referencia

Un punto de referencia específico de la cara (por ejemplo, un rasgo facial).

Representación JSON 
{
  "type": enum(Type),
  "position": {
    object(Position)
  }
}
Campos
type

enum(Type)

Tipo de punto de referencia facial.

position

object(Position)

Posición de los puntos de referencia de la cara.

Tipo

Tipo de punto de referencia (característica) facial. La izquierda y la derecha se definen desde el punto de vista de la persona que ve la imagen, sin tener en cuenta las proyecciones de espejo típicas de las fotos. Por lo tanto, LEFT_EYE suele ser el ojo derecho de la persona.

Enumeraciones
UNKNOWN_LANDMARK Se ha detectado un punto de referencia facial desconocido. No debe rellenarse.
LEFT_EYE Ojo izquierdo.
RIGHT_EYE Ojo derecho.
LEFT_OF_LEFT_EYEBROW A la izquierda de la ceja izquierda.
RIGHT_OF_LEFT_EYEBROW A la derecha de la ceja izquierda.
LEFT_OF_RIGHT_EYEBROW A la izquierda de la ceja derecha.
RIGHT_OF_RIGHT_EYEBROW Derecha de la ceja derecha.
MIDPOINT_BETWEEN_EYES Punto medio entre los ojos.
NOSE_TIP Punta de la nariz.
UPPER_LIP Labio superior.
LOWER_LIP Labio inferior.
MOUTH_LEFT Boca a la izquierda.
MOUTH_RIGHT Boca a la derecha.
MOUTH_CENTER Centro de la boca.
NOSE_BOTTOM_RIGHT Nariz, abajo a la derecha.
NOSE_BOTTOM_LEFT Nariz, abajo a la izquierda.
NOSE_BOTTOM_CENTER Nariz, parte inferior central.
LEFT_EYE_TOP_BOUNDARY Borde superior del ojo izquierdo.
LEFT_EYE_RIGHT_CORNER Ojo izquierdo, esquina derecha.
LEFT_EYE_BOTTOM_BOUNDARY Borde inferior del ojo izquierdo.
LEFT_EYE_LEFT_CORNER Ojo izquierdo, esquina izquierda.
RIGHT_EYE_TOP_BOUNDARY Borde superior del ojo derecho.
RIGHT_EYE_RIGHT_CORNER Ojo derecho, esquina derecha.
RIGHT_EYE_BOTTOM_BOUNDARY Ojo derecho, límite inferior.
RIGHT_EYE_LEFT_CORNER Ojo derecho, esquina izquierda.
LEFT_EYEBROW_UPPER_MIDPOINT Parte superior central de la ceja izquierda.
RIGHT_EYEBROW_UPPER_MIDPOINT Cejas derecha, punto medio superior.
LEFT_EAR_TRAGION Trago de la oreja izquierda.
RIGHT_EAR_TRAGION Trago de la oreja derecha.
LEFT_EYE_PUPIL Pupila del ojo izquierdo.
RIGHT_EYE_PUPIL Pupila del ojo derecho.
FOREHEAD_GLABELLA Entrecejo.
CHIN_GNATHION Mentón (gnation).
CHIN_LEFT_GONION Mentón izquierdo.
CHIN_RIGHT_GONION Mentón derecho.

Posición

Una posición 3D en la imagen, que se usa principalmente para los puntos de referencia de la detección de caras. Una posición válida debe tener coordenadas x e y. Las coordenadas de posición están en la misma escala que la imagen original.

Representación JSON 
{
  "x": number,
  "y": number,
  "z": number
}
Campos
x

number

Coordenada X.

y

number

Coordenada Y.

z

number

Coordenada Z (o profundidad).

Likelihood

Representación en contenedores de la probabilidad, cuyo objetivo es ofrecer a los clientes resultados muy estables en las actualizaciones del modelo.

Enumeraciones
UNKNOWN Probabilidad desconocida.
VERY_UNLIKELY Es muy poco probable que la imagen pertenezca a la vertical especificada.
UNLIKELY Es poco probable que la imagen pertenezca al vertical especificado.
POSSIBLE Es posible que la imagen pertenezca a la vertical especificada.
LIKELY Es probable que la imagen pertenezca al vertical especificado.
VERY_LIKELY Es muy probable que la imagen pertenezca al vertical especificado.

EntityAnnotation

Conjunto de características de la entidad detectada.

Representación JSON 
{
  "mid": string,
  "locale": string,
  "description": string,
  "score": number,
  "confidence": number,
  "topicality": number,
  "boundingPoly": {
    object(BoundingPoly)
  },
  "locations": [
    {
      object(LocationInfo)
    }
  ],
  "properties": [
    {
      object(Property)
    }
  ]
}
Campos
mid

string

ID de entidad opaco. Algunos IDs pueden estar disponibles en la API Search de gráfico de conocimiento de Google.

locale

string

Código de idioma de la configuración regional en la que se expresa el texto de la entidad description.

description

string

Descripción textual de la entidad, expresada en su idioma locale.

score

number

Puntuación general del resultado. Intervalo [0, 1].

confidence
(deprecated)

number

Obsoleto. En su lugar, usa score. La precisión de la detección de entidades en una imagen. Por ejemplo, en una imagen en la que se detecta la entidad "Torre Eiffel", este campo representa la confianza de que hay una torre en la imagen de la consulta. Intervalo [0, 1].
topicality

number

La relevancia de la etiqueta ICA (anotación de contenido de imagen) para la imagen. Por ejemplo, la relevancia de "torre" es probablemente mayor para una imagen que contiene la "Torre Eiffel" detectada que para una imagen que contiene un edificio alto detectado a lo lejos, aunque la confianza de que hay una torre en cada imagen sea la misma. Intervalo [0, 1].

boundingPoly

object(BoundingPoly)

Región de la imagen a la que pertenece esta entidad. No se ha producido para las funciones de LABEL_DETECTION.

locations[]

object(LocationInfo)

Información de la ubicación de la entidad detectada. Puede haber varios elementos LocationInfo, ya que una ubicación puede indicar el lugar de la escena de la imagen y otra, el lugar donde se tomó la imagen. La información de ubicación suele estar disponible para los puntos de referencia.

properties[]

object(Property)

Algunas entidades pueden tener campos Property (nombre/valor) opcionales proporcionados por el usuario, como una puntuación o una cadena que califique a la entidad.

LocationInfo

Información de la ubicación de la entidad detectada.

Representación JSON 
{
  "latLng": {
    object(LatLng)
  }
}
Campos
latLng

object(LatLng)

Coordenadas de latitud y longitud de la ubicación.

Propiedad

Un Property consta de un par nombre/valor proporcionado por el usuario.

Representación JSON 
{
  "name": string,
  "value": string,
  "uint64Value": string
}
Campos
name

string

Nombre de la propiedad.

value

string

Valor de la propiedad.

uint64Value

string

Valor de las propiedades numéricas.

LocalizedObjectAnnotation

Conjunto de objetos detectados con cuadros delimitadores.

Representación JSON 
{
  "mid": string,
  "languageCode": string,
  "name": string,
  "score": number,
  "boundingPoly": {
    object(BoundingPoly)
  }
}
Campos
mid

string

ID de objeto que debe coincidir con el MID de EntityAnnotation.

languageCode

string

Se trata del código de idioma BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

name

string

Nombre del objeto, expresado en el idioma languageCode.

score

number

Puntuación del resultado. Intervalo [0, 1].

boundingPoly

object(BoundingPoly)

Región de la imagen a la que pertenece este objeto. Este campo es obligatorio.

TextAnnotation

TextAnnotation contiene una representación estructurada del texto extraído mediante OCR. La jerarquía de una estructura de texto extraída por OCR es la siguiente: TextAnnotation -> Page -> Block -> Paragraph -> Word -> Symbol. Cada componente estructural, empezando por Page, puede tener sus propias propiedades. Las propiedades describen los idiomas detectados, los saltos, etc. Consulta la TextAnnotation.TextPropertydefinición del mensaje que aparece más abajo para obtener más información.

Representación JSON 
{
  "pages": [
    {
      object(Page)
    }
  ],
  "text": string
}
Campos
pages[]

object(Page)

Lista de páginas detectadas por OCR.

text

string

Se ha detectado texto UTF-8 en las páginas.

Página

Página detectada mediante OCR.

Representación JSON 
{
  "property": {
    object(TextProperty)
  },
  "width": number,
  "height": number,
  "blocks": [
    {
      object(Block)
    }
  ],
  "confidence": number
}
Campos
property

object(TextProperty)

Se ha detectado información adicional en la página.

width

number

Ancho de la página. En el caso de los PDFs, la unidad son puntos. En el caso de las imágenes (incluidos los TIFFs), la unidad son los píxeles.

height

number

Altura de la página. En el caso de los PDFs, la unidad son puntos. En el caso de las imágenes (incluidos los TIFFs), la unidad son los píxeles.

blocks[]

object(Block)

Lista de bloques de texto, imágenes, etc. de esta página.

confidence

number

Confianza de los resultados de OCR en la página. Intervalo [0, 1].

TextProperty

Se ha detectado información adicional en el componente estructural.

Representación JSON 
{
  "detectedLanguages": [
    {
      object(DetectedLanguage)
    }
  ],
  "detectedBreak": {
    object(DetectedBreak)
  }
}
Campos
detectedLanguages[]

object(DetectedLanguage)

Lista de idiomas detectados junto con la confianza.

detectedBreak

object(DetectedBreak)

Se ha detectado el inicio o el final de un segmento de texto.

Idioma detectado

Idioma detectado de un componente estructural.

Representación JSON 
{
  "languageCode": string,
  "confidence": number
}
Campos
languageCode

string

Se trata del código de idioma BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

confidence

number

Confianza del idioma detectado. Intervalo [0, 1].

DetectedBreak

Se ha detectado el inicio o el final de un componente estructural.

Representación JSON 
{
  "type": enum(BreakType),
  "isPrefix": boolean
}
Campos
type

enum(BreakType)

Tipo de salto detectado.

isPrefix

boolean

Devuelve el valor true si el salto precede al elemento.

BreakType

Enum para indicar el tipo de salto encontrado. Nueva línea, espacio, etc.

Enumeraciones
UNKNOWN Tipo de etiqueta de salto desconocido.
SPACE Espacio normal.
SURE_SPACE Espacio seguro (muy amplio).
EOL_SURE_SPACE Salto de ajuste de línea.
HYPHEN Guion de final de línea que no está presente en el texto. No se da simultáneamente con SPACE, LEADER_SPACE ni LINE_BREAK.
LINE_BREAK Salto de línea que termina un párrafo.

Bloquear

Elemento lógico de la página.

Representación JSON 
{
  "property": {
    object(TextProperty)
  },
  "boundingBox": {
    object(BoundingPoly)
  },
  "paragraphs": [
    {
      object(Paragraph)
    }
  ],
  "blockType": enum(BlockType),
  "confidence": number
}
Campos
property

object(TextProperty)

Se ha detectado información adicional sobre el bloque.

boundingBox

object(BoundingPoly)

Cuadro delimitador del bloque. Los vértices se indican en el siguiente orden: superior izquierda, superior derecha, inferior derecha e inferior izquierda. Cuando se detecta una rotación del cuadro delimitador, se representa alrededor de la esquina superior izquierda, tal como se define cuando el texto se lee en la orientación "natural". Por ejemplo:

  • Si el texto es horizontal, puede tener este aspecto:
    0----1
    |    |
    3----2
  • Cuando se gira 180 grados alrededor de la esquina superior izquierda, se convierte en lo siguiente:
    2----3
    |    |
    1----0

y el orden de los vértices seguirá siendo (0, 1, 2, 3).
paragraphs[]

object(Paragraph)

Lista de párrafos de este bloque (si el bloque es de tipo texto).

blockType

enum(BlockType)

Tipo de bloque detectado (texto, imagen, etc.) de este bloque.

confidence

number

Confianza de los resultados de OCR en el bloque. Intervalo [0, 1].

Párrafo

Unidad estructural de texto que representa un número de palabras en un orden determinado.

Representación JSON 
{
  "property": {
    object(TextProperty)
  },
  "boundingBox": {
    object(BoundingPoly)
  },
  "words": [
    {
      object(Word)
    }
  ],
  "confidence": number
}
Campos
property

object(TextProperty)

Información adicional detectada en el párrafo.

boundingBox

object(BoundingPoly)

El cuadro delimitador del párrafo. Los vértices se indican en el siguiente orden: superior izquierda, superior derecha, inferior derecha e inferior izquierda. Cuando se detecta una rotación del cuadro delimitador, se representa alrededor de la esquina superior izquierda, tal como se define cuando el texto se lee en la orientación "natural". Por ejemplo: * Si el texto es horizontal, podría tener este aspecto: 0----1 | | 3----2 * Si se gira 180 grados alrededor de la esquina superior izquierda, se convierte en: 2----3 | | 1----0 y el orden de los vértices seguirá siendo (0, 1, 2, 3).

words[]

object(Word)

Lista de palabras de este párrafo.

confidence

number

Confianza de los resultados de OCR del párrafo. Intervalo [0, 1].

Word

Representación de una palabra.

Representación JSON 
{
  "property": {
    object(TextProperty)
  },
  "boundingBox": {
    object(BoundingPoly)
  },
  "symbols": [
    {
      object(Symbol)
    }
  ],
  "confidence": number
}
Campos
property

object(TextProperty)

Se ha detectado información adicional sobre la palabra.

boundingBox

object(BoundingPoly)

El cuadro delimitador de la palabra. Los vértices se indican en el siguiente orden: superior izquierda, superior derecha, inferior derecha e inferior izquierda. Cuando se detecta una rotación del cuadro delimitador, se representa alrededor de la esquina superior izquierda, tal como se define cuando el texto se lee en la orientación "natural". Por ejemplo: * Si el texto es horizontal, podría tener este aspecto: 0----1 | | 3----2 * Si se gira 180 grados alrededor de la esquina superior izquierda, se convierte en: 2----3 | | 1----0 y el orden de los vértices seguirá siendo (0, 1, 2, 3).

symbols[]

object(Symbol)

Lista de símbolos de la palabra. El orden de los símbolos sigue el orden de lectura natural.

confidence

number

Confianza de los resultados de OCR de la palabra. Intervalo [0, 1].

Símbolo

Representación de un solo símbolo.

Representación JSON 
{
  "property": {
    object(TextProperty)
  },
  "boundingBox": {
    object(BoundingPoly)
  },
  "text": string,
  "confidence": number
}
Campos
property

object(TextProperty)

Se ha detectado información adicional sobre el símbolo.

boundingBox

object(BoundingPoly)

Cuadro delimitador del símbolo. Los vértices se indican en el siguiente orden: superior izquierda, superior derecha, inferior derecha e inferior izquierda. Cuando se detecta una rotación del cuadro delimitador, se representa alrededor de la esquina superior izquierda, tal como se define cuando el texto se lee en la orientación "natural". Por ejemplo: * Si el texto es horizontal, podría tener este aspecto: 0----1 | | 3----2 * Si se gira 180 grados alrededor de la esquina superior izquierda, se convierte en: 2----3 | | 1----0 y el orden de los vértices seguirá siendo (0, 1, 2, 3).

text

string

La representación UTF-8 real del símbolo.

confidence

number

Confianza de los resultados de OCR del símbolo. Intervalo [0, 1].

BlockType

Tipo de bloque (texto, imagen, etc.) identificado por el OCR.

Enumeraciones
UNKNOWN Tipo de bloque desconocido.
TEXT Bloque de texto normal.
TABLE Bloque de tabla.
PICTURE Bloque de imagen.
RULER Cuadro de línea horizontal o vertical.
BARCODE Bloque de código de barras.

SafeSearchAnnotation

Conjunto de funciones relacionadas con la imagen, calculadas mediante métodos de visión artificial en verticales de búsqueda segura (por ejemplo, contenido para adultos, falsificaciones, contenido médico o violencia).

Representación JSON 
{
  "adult": enum(Likelihood),
  "spoof": enum(Likelihood),
  "medical": enum(Likelihood),
  "violence": enum(Likelihood),
  "racy": enum(Likelihood)
}
Campos
adult

enum(Likelihood)

Representa la probabilidad de que la imagen incluya contenido para adultos. El contenido para adultos puede incluir elementos como desnudos, imágenes o dibujos pornográficos, o actividades sexuales.

spoof

enum(Likelihood)

Probabilidad de suplantación. Probabilidad de que se haya modificado la versión canónica de la imagen para que parezca divertida u ofensiva.

medical

enum(Likelihood)

Probabilidad de que se trate de una imagen médica.

violence

enum(Likelihood)

Probabilidad de que esta imagen incluya contenido violento.

racy

enum(Likelihood)

Probabilidad de que la imagen de la solicitud incluya contenido subido de tono. El contenido subido de tono puede incluir, entre otros, ropa escasa o transparente, desnudos cubiertos estratégicamente, posturas lascivas o provocativas, o primeros planos de zonas sensibles del cuerpo.

ImageProperties

Almacena propiedades de la imagen, como los colores predominantes.

Representación JSON 
{
  "dominantColors": {
    object(DominantColorsAnnotation)
  }
}
Campos
dominantColors

object(DominantColorsAnnotation)

Si está presente, los colores dominantes se han completado correctamente.

DominantColorsAnnotation

Conjunto de colores predominantes y sus puntuaciones correspondientes.

Representación JSON 
{
  "colors": [
    {
      object(ColorInfo)
    }
  ]
}
Campos
colors[]

object(ColorInfo)

Valores de color RGB con su puntuación y fracción de píxeles.

ColorInfo

La información de color consta de canales RGB, una puntuación y la fracción de la imagen que ocupa el color en la imagen.

Representación JSON 
{
  "color": {
    object(Color)
  },
  "score": number,
  "pixelFraction": number
}
Campos
color

object(Color)

Componentes RGB del color.

score

number

Puntuación específica de la imagen para este color. Valor en el intervalo [0, 1].

pixelFraction

number

La fracción de píxeles que ocupa el color en la imagen. Valor en el intervalo [0, 1].

CropHintsAnnotation

Conjunto de sugerencias de recorte que se usan para generar nuevos recortes al servir imágenes.

Representación JSON 
{
  "cropHints": [
    {
      object(CropHint)
    }
  ]
}
Campos
cropHints[]

object(CropHint)

Resultados de las pistas de recorte.

CropHint

Sugerencia de recorte único que se usa para generar un nuevo recorte al servir una imagen.

Representación JSON 
{
  "boundingPoly": {
    object(BoundingPoly)
  },
  "confidence": number,
  "importanceFraction": number
}
Campos
boundingPoly

object(BoundingPoly)

Polígono delimitador de la zona de recorte. Las coordenadas del cuadro delimitador están en la escala de la imagen original, tal como se devuelve en ImageParams.

confidence

number

Confianza de que se trata de una región destacada. Intervalo [0, 1].

importanceFraction

number

Fracción de la importancia de esta región destacada con respecto a la imagen original.

WebDetection

Información relevante sobre la imagen de Internet.

Representación JSON 
{
  "webEntities": [
    {
      object(WebEntity)
    }
  ],
  "fullMatchingImages": [
    {
      object(WebImage)
    }
  ],
  "partialMatchingImages": [
    {
      object(WebImage)
    }
  ],
  "pagesWithMatchingImages": [
    {
      object(WebPage)
    }
  ],
  "visuallySimilarImages": [
    {
      object(WebImage)
    }
  ],
  "bestGuessLabels": [
    {
      object(WebLabel)
    }
  ]
}
Campos
webEntities[]

object(WebEntity)

Entidades deducidas a partir de imágenes similares en Internet.

fullMatchingImages[]

object(WebImage)

Imágenes que coinciden totalmente de Internet. Puede incluir copias de la imagen de consulta con un tamaño diferente.

partialMatchingImages[]

object(WebImage)

Imágenes coincidentes parciales de Internet. Esas imágenes son lo suficientemente similares como para compartir algunas características de puntos clave. Por ejemplo, es probable que una imagen original tenga coincidencias parciales con sus recortes.

pagesWithMatchingImages[]

object(WebPage)

Páginas web que contienen las imágenes coincidentes de Internet.

visuallySimilarImages[]

object(WebImage)

Los resultados de imágenes visualmente similares.

bestGuessLabels[]

object(WebLabel)

La mejor estimación del servicio sobre el tema de la imagen solicitada. Se infiere a partir de imágenes similares de la Web abierta.

WebEntity

Entidad deducida a partir de imágenes similares en Internet.

Representación JSON 
{
  "entityId": string,
  "score": number,
  "description": string
}
Campos
entityId

string

ID de entidad opaco.

score

number

Puntuación de relevancia general de la entidad. No está normalizada y no se puede comparar entre diferentes consultas de imágenes.

description

string

Descripción canónica de la entidad en inglés.

WebImage

Metadatos de imágenes online.

Representación JSON 
{
  "url": string,
  "score": number
}
Campos
url

string

URL de la imagen de resultado.

score

number

(Obsoleto) Puntuación de relevancia general de la imagen.

WebPage

Metadatos de páginas web.

Representación JSON 
{
  "url": string,
  "score": number,
  "pageTitle": string,
  "fullMatchingImages": [
    {
      object(WebImage)
    }
  ],
  "partialMatchingImages": [
    {
      object(WebImage)
    }
  ]
}
Campos
url

string

La URL de la página web de resultados.

score

number

(Obsoleto) Puntuación de relevancia general de la página web.

pageTitle

string

Título de la página web. Puede contener marcas HTML.

fullMatchingImages[]

object(WebImage)

Imágenes de la página que coinciden por completo. Puede incluir copias de la imagen de consulta con un tamaño diferente.

partialMatchingImages[]

object(WebImage)

Imágenes de la página que coinciden parcialmente. Esas imágenes son lo suficientemente similares como para compartir algunas características de puntos clave. Por ejemplo, es probable que una imagen original tenga coincidencias parciales con sus recortes.

WebLabel

Etiqueta para proporcionar metadatos adicionales para la detección web.

Representación JSON 
{
  "label": string,
  "languageCode": string
}
Campos
label

string

Etiqueta de metadatos adicionales.

languageCode

string

El código de idioma BCP-47 de label, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

ProductSearchResults

Resultados de una solicitud de búsqueda de producto.

Representación JSON 
{
  "indexTime": string,
  "results": [
    {
      object(Result)
    }
  ],
  "productGroupedResults": [
    {
      object(GroupedResult)
    }
  ]
}
Campos
indexTime

string (Timestamp format)

Marca de tiempo del índice que ha proporcionado estos resultados. Los cambios que se hagan después de esa hora no se reflejarán en los resultados actuales.

Marca de tiempo en formato RFC3339 UTC "Zulú", con precisión en nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z"
results[]

object(Result)

Lista de resultados, uno por cada producto coincidente.

productGroupedResults[]

object(GroupedResult)

Lista de resultados agrupados por los productos detectados en la imagen de la consulta. Cada entrada corresponde a un polígono envolvente de la imagen de consulta y contiene los productos coincidentes específicos de esa región. Puede haber coincidencias de productos duplicadas en la unión de todos los resultados por producto.

Resultado

Información sobre un producto.

Representación JSON 
{
  "product": {
    object(Product)
  },
  "score": number,
  "image": string
}
Campos
product

object(Product)

El Producto.

score

number

Nivel de confianza de la coincidencia, que va de 0 (sin confianza) a 1 (confianza total).

image

string

Nombre de recurso de la imagen del producto que más se ajusta a la consulta.

GroupedResult

Información sobre los productos similares a un solo producto de una imagen de consulta.

Representación JSON 
{
  "boundingPoly": {
    object(BoundingPoly)
  },
  "results": [
    {
      object(Result)
    }
  ]
}
Campos
boundingPoly

object(BoundingPoly)

El polígono delimitador que rodea el producto detectado en la imagen de consulta.

results[]

object(Result)

Lista de resultados, uno por cada producto coincidente.

ImageAnnotationContext

Si una imagen se ha generado a partir de un archivo (por ejemplo, un PDF), este mensaje proporciona información sobre la fuente de la imagen.

Representación JSON 
{
  "uri": string,
  "pageNumber": number
}
Campos
uri

string

El URI del archivo usado para generar la imagen.

pageNumber

number

Si el archivo era un PDF o un TIFF, este campo indica el número de página del archivo que se ha usado para generar la imagen.