Guida introduttiva: Analizzare un'immagine remota usando l'API REST di Visione artificiale con Node.jsQuickstart: Analyze a remote image using the Computer Vision REST API with Node.js

In questa guida introduttiva si analizza un'immagine archiviata in remoto per estrarre le caratteristiche visive usando l'API REST di Visione artificiale.In this quickstart, you analyze a remotely stored image to extract visual features by using Computer Vision's REST API. Con il metodo Analyze Image è possibile estrarre caratteristiche visive in base al contenuto di un'immagine.With the Analyze Image method, you can extract visual features based on image content.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

PrerequisitiPrerequisites

  • È necessario aver installato Node.js 4.x o versione successiva.You must have Node.js 4.x or later installed.
  • È necessario aver installato npm.You must have npm installed.
  • È necessario avere una chiave di sottoscrizione per Visione artificiale.You must have a subscription key for Computer Vision. È possibile ottenere una chiave della versione di valutazione gratuita nella pagina Prova Servizi cognitivi.You can get a free trial key from Try Cognitive Services. Oppure seguire le istruzioni riportate in Creare un account Servizi cognitivi per sottoscrivere Visione artificiale e ottenere la chiave.Or, follow the instructions in Create a Cognitive Services account to subscribe to Computer Vision and get your key. Quindi, creare le variabili di ambiente per la chiave e per la stringa dell'endpoint di servizio, denominate rispettivamente COMPUTER_VISION_SUBSCRIPTION_KEY e COMPUTER_VISION_ENDPOINT.Then, create environment variables for the key and service endpoint string, named COMPUTER_VISION_SUBSCRIPTION_KEY and COMPUTER_VISION_ENDPOINT, respectively.

Creare ed eseguire l'esempioCreate and run the sample

Per creare ed eseguire l'esempio, seguire questa procedura:To create and run the sample, do the following steps:

  1. Installare il pacchetto request npm.Install the npm request package.

    1. Aprire una finestra del prompt dei comandi come amministratore.Open a command prompt window as an administrator.

    2. Eseguire il comando seguente:Run the following command:

      npm install request
      
    3. Dopo l'installazione del pacchetto, chiudere la finestra del prompt dei comandi.After the package is successfully installed, close the command prompt window.

  2. Copiare il codice seguente in un editor di testo.Copy the following code into a text editor.

  3. Facoltativamente, sostituire il valore di imageUrl con l'URL di un'altra immagine da analizzare.Optionally, replace the value of imageUrl with the URL of a different image that you want to analyze.

  4. Facoltativamente, sostituire il valore del parametro language della richiesta con un'altra lingua.Optionally, replace the value of the language request parameter with a different language.

  5. Salvare il codice in un file con estensione .js.Save the code as a file with a .js extension. Ad esempio: analyze-image.js.For example, analyze-image.js.

  6. Aprire una finestra del prompt dei comandi.Open a command prompt window.

  7. Al prompt usare il comando node per eseguire il file.At the prompt, use the node command to run the file. Ad esempio: 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);
});

Esaminare i risultatiExamine the response

Una risposta con esito positivo viene restituita in JSON.A successful response is returned in JSON. L'esempio analizza e visualizza una risposta con esito positivo nella finestra del prompt dei comandi, come nell'esempio seguente: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"
  }
}

Pulire le risorseClean up resources

Quando non servono più, eliminare il file e quindi disinstallare il pacchetto request npm.When no longer needed, delete the file, and then uninstall the npm request package. Per disinstallare il pacchetto NuGet, seguire questa procedura:To uninstall the package, do the following steps:

  1. Aprire una finestra del prompt dei comandi come amministratore.Open a command prompt window as an administrator.

  2. Eseguire il comando seguente:Run the following command:

    npm uninstall request
    
  3. Dopo la disinstallazione del pacchetto, chiudere la finestra del prompt dei comandi.After the package is successfully uninstalled, close the command prompt window.

Passaggi successiviNext steps

Esaminare le API Visione artificiale usate per analizzare un'immagine, rilevare celebrità e luoghi di interesse, creare un'anteprima ed estrarre testo scritto a mano e stampato.Explore the Computer Vision APIs used to analyze an image, detect celebrities and landmarks, create a thumbnail, and extract printed and handwritten text. Per sperimentare rapidamente l'API Visione artificiale, provare la console di test dell'API.To rapidly experiment with the Computer Vision API, try the Open API testing console.