Inicio rápido: Análisis de imágenes remotas mediante la API REST Computer Vision con Node.jsQuickstart: Analyze a remote image using the Computer Vision REST API with Node.js

En esta guía de inicio rápido, analizará una imagen remota almacenada para extraer características visuales con la API de REST Computer Vision.In this quickstart, you analyze a remotely stored image to extract visual features by using Computer Vision's REST API. Con el método de análisis de imagen, puede extraer características visuales basadas en el contenido de una imagen.With the Analyze Image method, you can extract visual features based on image content.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Requisitos previosPrerequisites

  • Debe tener instalado Node.js 4.x o una versión posterior.You must have Node.js 4.x or later installed.
  • Debe tener npm instalado.You must have npm installed.
  • Debe tener una clave de suscripción para Computer Vision.You must have a subscription key for Computer Vision. Puede obtener una clave de evaluación gratuita en la página Pruebe Cognitive Services.You can get a free trial key from Try Cognitive Services. O bien, siga las instrucciones que se indican en Creación de una cuenta de Cognitive Services para suscribirse a Computer Vision y obtener su clave.Or, follow the instructions in Create a Cognitive Services account to subscribe to Computer Vision and get your key. Después, cree variables de entorno para la cadena de punto de conexión del servicio y la clave denominadas COMPUTER_VISION_SUBSCRIPTION_KEY y COMPUTER_VISION_ENDPOINT, respectivamente.Then, create environment variables for the key and service endpoint string, named COMPUTER_VISION_SUBSCRIPTION_KEY and COMPUTER_VISION_ENDPOINT, respectively.

Creación y ejecución del ejemploCreate and run the sample

Para crear y ejecutar el ejemplo, siga estos pasos:To create and run the sample, do the following steps:

  1. Instale el paquete request de npm.Install the npm request package.

    1. Abra una ventana del símbolo del sistema como administrador.Open a command prompt window as an administrator.

    2. Ejecute el siguiente comando:Run the following command:

      npm install request
      
    3. Una vez que el paquete se haya instalado correctamente, cierre la ventana del símbolo del sistema.After the package is successfully installed, close the command prompt window.

  2. Copie el código siguiente en un editor de texto.Copy the following code into a text editor.

  3. También puede reemplazar el valor de imageUrl por la dirección URL de una imagen diferente que desee analizar.Optionally, replace the value of imageUrl with the URL of a different image that you want to analyze.

  4. Si lo desea, reemplace el valor del parámetro de la solicitud language por un idioma diferente.Optionally, replace the value of the language request parameter with a different language.

  5. Guarde el código como un archivo con una extensión .js.Save the code as a file with a .js extension. Por ejemplo, analyze-image.js.For example, analyze-image.js.

  6. Abra una ventana de símbolo del sistema.Open a command prompt window.

  7. En el símbolo del sistema, utilice el comando node para ejecutar el archivo.At the prompt, use the node command to run the file. Por ejemplo, node analyze-image.js.For example, node analyze-image.js.

'use strict';

const request = require('request');

let subscriptionKey = process.env['COMPUTER_VISION_SUBSCRIPTION_KEY'];
let endpoint = process.env['COMPUTER_VISION_ENDPOINT']
if (!subscriptionKey) { throw new Error('Set your environment variables for your subscription key and endpoint.'); }

var uriBase = endpoint + 'vision/v2.0/analyze';

const imageUrl =
    'https://upload.wikimedia.org/wikipedia/commons/3/3c/Shaki_waterfall.jpg';

// Request parameters.
const params = {
    'visualFeatures': 'Categories,Description,Color',
    'details': '',
    'language': 'en'
};

const options = {
    uri: uriBase,
    qs: params,
    body: '{"url": ' + '"' + imageUrl + '"}',
    headers: {
        'Content-Type': 'application/json',
        'Ocp-Apim-Subscription-Key' : subscriptionKey
    }
};

request.post(options, (error, response, body) => {
  if (error) {
    console.log('Error: ', error);
    return;
  }
  let jsonResponse = JSON.stringify(JSON.parse(body), null, '  ');
  console.log('JSON Response\n');
  console.log(jsonResponse);
});

Examen de la respuestaExamine the response

Se devuelve una respuesta correcta en JSON.A successful response is returned in JSON. El ejemplo analiza y muestra una respuesta correcta en la ventana del símbolo del sistema, parecida a la del ejemplo siguiente:The sample parses and displays a successful response in the command prompt window, similar to the following example:

{
  "categories": [
    {
      "name": "outdoor_water",
      "score": 0.9921875,
      "detail": {
        "landmarks": []
      }
    }
  ],
  "description": {
    "tags": [
      "nature",
      "water",
      "waterfall",
      "outdoor",
      "rock",
      "mountain",
      "rocky",
      "grass",
      "hill",
      "covered",
      "hillside",
      "standing",
      "side",
      "group",
      "walking",
      "white",
      "man",
      "large",
      "snow",
      "grazing",
      "forest",
      "slope",
      "herd",
      "river",
      "giraffe",
      "field"
    ],
    "captions": [
      {
        "text": "a large waterfall over a rocky cliff",
        "confidence": 0.916458423253597
      }
    ]
  },
  "color": {
    "dominantColorForeground": "Grey",
    "dominantColorBackground": "Green",
    "dominantColors": [
      "Grey",
      "Green"
    ],
    "accentColor": "4D5E2F",
    "isBwImg": false
  },
  "requestId": "81b4e400-e3c1-41f1-9020-e6871ad9f0ed",
  "metadata": {
    "height": 959,
    "width": 1280,
    "format": "Jpeg"
  }
}

Limpieza de recursosClean up resources

Cuando ya no sea necesario, elimine el archivo y después desinstale el paquete request de npm.When no longer needed, delete the file, and then uninstall the npm request package. Para desinstalar el paquete, realice los siguientes pasos:To uninstall the package, do the following steps:

  1. Abra una ventana del símbolo del sistema como administrador.Open a command prompt window as an administrator.

  2. Ejecute el siguiente comando:Run the following command:

    npm uninstall request
    
  3. Una vez que el paquete se haya desinstalado correctamente, cierre la ventana del símbolo del sistema.After the package is successfully uninstalled, close the command prompt window.

Pasos siguientesNext steps

Explore las versiones de Computer Vision API que se usan para analizar una imagen, detectar personajes y sitios emblemáticos, crear una miniatura y extraer texto impreso y escrito a mano.Explore the Computer Vision APIs used to analyze an image, detect celebrities and landmarks, create a thumbnail, and extract printed and handwritten text. Para experimentar rápidamente con la versión de Computer Vision API, pruebe la consola de pruebas de Open API.To rapidly experiment with the Computer Vision API, try the Open API testing console.