Snabb start: analysera en fjärravbildning med hjälp av Visuellt innehåll REST API med Node. jsQuickstart: Analyze a remote image using the Computer Vision REST API with Node.js

I den här snabb starten analyserar du en fjärrlagrad avbildning för att extrahera visuella funktioner med hjälp av Visuellt innehåll REST API med Node. js.In this quickstart, you analyze a remotely stored image to extract visual features by using Computer Vision's REST API with Node.js. Med metoden Analyze Image (Analysera bild) kan du extrahera visuella funktioner baserat på bildinnehåll.With the Analyze Image method, you can extract visual features based on image content.

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

KravPrerequisites

  • Du måste ha Node.js 4.x eller senare installerat.You must have Node.js 4.x or later installed.
  • Du måste ha npm installerat.You must have npm installed.
  • Du måste ha en prenumerationsnyckel för Visuellt innehåll.You must have a subscription key for Computer Vision. Du kan få en kostnads fri utvärderings nyckel från Cognitive Services.You can get a free trial key from Try Cognitive Services. Eller följ instruktionerna i skapa ett Cognitive Services konto för att prenumerera på visuellt innehåll och hämta din nyckel.Or, follow the instructions in Create a Cognitive Services account to subscribe to Computer Vision and get your key. Skapa sedan miljövariabler för nyckel-och tjänst slut punkts strängen, med namnet COMPUTER_VISION_SUBSCRIPTION_KEY och COMPUTER_VISION_ENDPOINT.Then, create environment variables for the key and service endpoint string, named COMPUTER_VISION_SUBSCRIPTION_KEY and COMPUTER_VISION_ENDPOINT, respectively.

Skapa och köra exempletCreate and run the sample

Så här skapar du och kör exemplet:To create and run the sample, do the following steps:

  1. Installera npm-paketet request.Install the npm request package.

    1. Öppna ett kommandotolksfönster som administratör.Open a command prompt window as an administrator.

    2. Kör följande kommando:Run the following command:

      npm install request
      
    3. Stäng kommandotolksfönstret när paketet har installerats.After the package is successfully installed, close the command prompt window.

  2. Kopiera följande kod till en textredigerare.Copy the following code into a text editor.

  3. Du kan också ersätta värdet för imageUrl med webbadressen till en annan bild som du vill analysera.Optionally, replace the value of imageUrl with the URL of a different image that you want to analyze.

  4. Du kan också ersätta värdet för parametern language för begäran med ett annat språk.Optionally, replace the value of the language request parameter with a different language.

  5. Spara koden som en fil med tillägget .js.Save the code as a file with a .js extension. Till exempel analyze-image.js.For example, analyze-image.js.

  6. Öppna ett kommandotolksfönster.Open a command prompt window.

  7. Kör filen i kommandotolken med kommandot node.At the prompt, use the node command to run the file. Till exempel 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.1/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);
});

Granska svaretExamine the response

Ett svar som anger att åtgärden lyckades returneras i JSON.A successful response is returned in JSON. Exemplet parsar och visar ett lyckat svar i kommandotolkens fönster enligt följande exempel: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"
  }
}

Rensa resurserClean up resources

När du inte behöver filen längre kan du ta bort den och sedan avinstallera npm-paketet request.When no longer needed, delete the file, and then uninstall the npm request package. Avinstallera paketet på följande sätt:To uninstall the package, do the following steps:

  1. Öppna ett kommandotolksfönster som administratör.Open a command prompt window as an administrator.

  2. Kör följande kommando:Run the following command:

    npm uninstall request
    
  3. Stäng kommandotolksfönstret när paketet har avinstallerats.After the package is successfully uninstalled, close the command prompt window.

Nästa stegNext steps

Utforska API:erna för visuellt innehåll som används för att analysera en bild, identifiera kändisar och landmärken, skapa en miniatyrbild och extrahera tryckt och handskriven text.Explore the Computer Vision APIs used to analyze an image, detect celebrities and landmarks, create a thumbnail, and extract printed and handwritten text. Du kan experimentera med API för visuellt innehåll i Open API-testkonsolen.To rapidly experiment with the Computer Vision API, try the Open API testing console.