Estás viendo la documentación de Apigee Edge.
Ir a la documentación de
Apigee X. info
Versión: 2.0.2
Descubre el contenido y el texto de las imágenes con modelos de aprendizaje automático.
En este contenido, se proporciona información de referencia para configurar y usar esta extensión. Antes de usar esta extensión desde un proxy de API, debes hacer lo siguiente:
Habilita la API de Cloud Vision para tu cuenta de servicio.
Si usarás Cloud Storage como fuente de tus imágenes, también deberás otorgar acceso a esta extensión a Cloud Storage, como se describe en la referencia de la extensión de Google Cloud Storage.
Cuando tengas una cuenta de servicio con permiso para Cloud Vision (y Cloud Storage, si lo usas), usa la consola de Google Cloud para generar una clave para la cuenta de servicio.
Usa el contenido del archivo JSON de la clave resultante cuando agregues y configures la extensión con la referencia de configuración.
Acerca de Cloud Vision
La API de Google Cloud Vision usa modelos de aprendizaje automático para analizar imágenes. Puedes entrenar un modelo para que lo use la API o usar el modelo integrado.
Con el modelo integrado, Cloud Vision clasifica las imágenes en categorías como "rascacielos", "velero", "león" o "Torre Eiffel". Detecta objetos, rostros, logotipos y puntos de referencia en imágenes, y localiza palabras contenidas en ellas.
Ejemplos
En los siguientes ejemplos, se ilustra cómo configurar la compatibilidad con las acciones de la extensión de Cloud Vision con la política ExtensionCallout.
Detectar etiquetas
En el siguiente ejemplo, la acción detectLabels de la extensión obtiene la imagen en image_uri y la pasa a la API de Cloud Vision para su análisis. La API examinará la imagen y determinará qué etiquetas se aplican a su contenido.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Cloud-Vision-Extension">
<DisplayName>Cloud Vision Extension</DisplayName>
<Connector>cloud-vision-extension-example</Connector>
<Action>detectLabels</Action>
<Input><![CDATA[
{
"image_uri" : "gs://cloud-vision-example/empire-state-building.jpg"
}
]]></Input>
<Output>vision.labels.retrieved</Output>
</ConnectorCallout>
La siguiente política de Assign Message usa el valor de la variable que almacena la respuesta de la extensión para asignar la carga útil de la respuesta.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-Image-Labels">
<DisplayName>Get Image Labels</DisplayName>
<AssignTo type="response" createNew="false"/>
<Set>
<Payload contentType="application/json">{vision.labels.retrieved}</Payload>
</Set>
</AssignMessage>
Dada una imagen de un área urbana con un edificio muy alto, es posible que recibas una respuesta como la siguiente:
{
"labels": [
{
"locations": [
],
"properties": [
],
"mid": "/m/0j_s4",
"locale": "",
"description": "metropolitan area",
"score": 0.9868549704551697,
"confidence": 0,
"topicality": 0.9868549704551697,
"boundingPoly": null
},
{
"locations": [
],
"properties": [
],
"mid": "/m/079cl",
"locale": "",
"description": "skyscraper",
"score": 0.966157853603363,
"confidence": 0,
"topicality": 0.966157853603363,
"boundingPoly": null
}
]
}
Detectar texto
En el siguiente ejemplo, la acción de extensiones detectText obtiene la imagen en image_uri y la pasa a la API de Cloud Vision para su análisis. La API examinará la imagen y, luego, identificará el texto que contiene.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Cloud-Vision-Text">
<DisplayName>Cloud Vision Text</DisplayName>
<Connector>cloud-vision-extension-example</Connector>
<Action>detectText</Action>
<Input><![CDATA[
{
"image_uri" : "gs://cloud-vision-example/parking-signs1.jpg"
}
]]></Input>
<Output>vision.text.retrieved</Output>
</ConnectorCallout>
La siguiente política de Assign Message usa el valor de la variable que almacena la respuesta de la extensión para asignar la carga útil de la respuesta.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-Image-Text">
<DisplayName>Get Image Text</DisplayName>
<AssignTo type="response" createNew="false"/>
<Set>
<Payload contentType="application/json">{vision.text.retrieved}</Payload>
</Set>
</AssignMessage>
Dada una imagen que contiene señales en un estacionamiento, es posible que recibas una respuesta como la siguiente:
{
"text": [
{
"locations": [
],
"properties": [
],
"mid": "",
"locale": "en",
"description": "RESERVED\nVISITORPARKING\nPARKING\nONLY>\n$150 FINE\n",
"score": 0,
"confidence": 0,
"topicality": 0,
"boundingPoly": {
"vertices": [
{
"x": 64,
"y": 56
},
{
"x": 378,
"y": 56
},
{
"x": 378,
"y": 218
},
{
"x": 64,
"y": 218
}
]
}
},
{
"locations": [
],
"properties": [
],
"mid": "",
"locale": "",
"description": "RESERVED",
"score": 0,
"confidence": 0,
"topicality": 0,
"boundingPoly": {
"vertices": [
{
"x": 243,
"y": 56
},
{
"x": 378,
"y": 56
},
{
"x": 378,
"y": 84
},
{
"x": 243,
"y": 84
}
]
}
}
]
}
Acciones
detectLabels
Detecta y extrae información sobre las entidades dentro de la imagen especificada. Las entidades detectadas abarcan un amplio grupo de categorías. Por ejemplo, usa esta acción para identificar objetos, ubicaciones, actividades, especies animales, productos y mucho más.
Además, asegúrate de consultar la documentación de la API de Cloud Vision.
Parámetros de solicitud
| Parámetro | Descripción | Tipo | Predeterminado | Obligatorio |
|---|---|---|---|---|
| image_uri | Es la fuente de la imagen. Puede ser de Internet o de Google Cloud Storage (formato: gs://bucketname/filename). Si la fuente es Google Cloud Storage, el archivo de imagen debe ser público. |
String | Ninguno | Sí. |
Sintaxis
<Input><![CDATA[{
"image_uri" : "uri-of-image-to-analyze"
}
]]></Input>
Ejemplo
En el siguiente ejemplo, la acción detectLabels de la extensión envía la imagen especificada a la API de Vision para su análisis.
<Input><![CDATA[
{
"image_uri" : "gs://cloud-vision-example/empire-state-building.jpg"
}
]]></Input>
Respuesta
Objeto que contiene un array labels de etiquetas que representan las entidades detectadas en la imagen. Para obtener más información, consulta Detecta etiquetas.
detectText
Detecta y extrae texto de la imagen especificada.
Parámetros de solicitud
| Parámetro | Descripción | Tipo | Predeterminado | Obligatorio |
|---|---|---|---|---|
| image_uri | Es la fuente de la imagen. Puede ser de Internet o de Google Cloud Storage (formato: gs://bucketname/filename). Si la fuente es Google Cloud Storage, el archivo de imagen debe ser público. |
String | Ninguno | Sí. |
Sintaxis
<Input><![CDATA[
{
"image_uri" : "uri-of-image-to-analyze"
}
]]></Input>
Ejemplo
En el siguiente ejemplo, la acción detectText de la extensión envía la imagen especificada a la API de Vision para su análisis.
<Input><![CDATA[
{
"image_uri" : "gs://cloud-vision-example/parking-signs1.jpg"
}
]]></Input>
Respuesta
Objeto que contiene un array text del texto detectado. Para obtener más información, consulta Detecta etiquetas.
Referencia de configuración
Usa la siguiente información cuando configures e implementes esta extensión para usarla en proxies de API. Si deseas conocer los pasos para configurar una extensión con la consola de Apigee, consulta Cómo agregar y configurar una extensión.
Propiedades comunes de las extensiones
Las siguientes propiedades están presentes para cada extensión.
| Propiedad | Descripción | Predeterminado | Obligatorio |
|---|---|---|---|
name |
Nombre que asignas a esta configuración de la extensión. | Ninguna | Sí |
packageName |
Nombre del paquete de extensiones proporcionado por Apigee Edge. | Ninguna | Sí |
version |
El número de versión del paquete de extensiones desde el que quieres configurar la extensión. | Ninguna | Sí |
configuration |
Es un valor de configuración específico para la extensión que agregas. Consulta Propiedades para este paquete de extensiones | Ninguna | Sí |