Rövid útmutató: A Bing Image Search ügyfélkódtár használata

  • Cikk

Figyelmeztetés

2020. október 30-án a Bing Search API-k átkerültek az Azure AI-szolgáltatásokból a Bing Search Servicesbe. Ez a dokumentáció csak referenciaként szolgál. A frissített dokumentációt a Bing search API dokumentációjában találja. Az új Azure-erőforrások Bing-kereséshez való létrehozásával kapcsolatos útmutatásért lásd: Bing Search-erőforrás létrehozása a Azure Marketplace keresztül.

Ezzel a rövid útmutatóval elvégezheti az első képkeresést a Bing Image Search ügyfélkódtárával.

Az ügyfélkeresési kódtár a REST API burkolója, és ugyanazokat a funkciókat tartalmazza.

Létrehoz egy C#-alkalmazást, amely képkeresési lekérdezést küld, elemzi a JSON-választ, és megjeleníti az első visszaadott kép URL-címét.

Előfeltételek

Lásd még: Az Azure AI-szolgáltatások díjszabása – Bing Search API.

Konzolprojekt létrehozása

Először hozzon létre egy új C#-konzolalkalmazást.

  1. Hozzon létre egy BingImageSearch nevű új konzolmegoldást a Visual Studióban.

  2. A Cognitive Image Search NuGet-csomag hozzáadása

    1. Kattintson a jobb gombbal a projektre a Megoldáskezelő.
    2. Válassza a NuGet-csomagok kezelése lehetőséget.
    3. Keresse meg és válassza a Microsoft.Azure.CognitiveServices.Search.ImageSearch elemet, majd telepítse a csomagot.

Az alkalmazás inicializálása

  1. Cserélje le az összes utasítást a usingProgram.cs fájlban a következő kódra:

    using System;
using System.Linq;
using Microsoft.Azure.CognitiveServices.Search.ImageSearch;
using Microsoft.Azure.CognitiveServices.Search.ImageSearch.Models;

  2. Main A projekt metódusában hozzon létre változókat az érvényes előfizetési kulcshoz, a Bing által visszaadandó képeredményekhez és egy keresési kifejezéshez. Ezután példányosítsa a képkeresési ügyfelet a kulcs használatával.

    static async Task Main(string[] args)
{
    //IMPORTANT: replace this variable with your Cognitive Services subscription key
    string subscriptionKey = "ENTER YOUR KEY HERE";
    //stores the image results returned by Bing
    Images imageResults = null;
    // the image search term to be used in the query
    string searchTerm = "canadian rockies";

    //initialize the client
    //NOTE: If you're using version 1.2.0 or below for the Bing Image Search client library, 
    // use ImageSearchAPI() instead of ImageSearchClient() to initialize your search client.

    var client = new ImageSearchClient(new ApiKeyServiceClientCredentials(subscriptionKey));
}

Keresési lekérdezés küldése az ügyfél használatával

Még mindig a metódusban Main használja az ügyfelet lekérdezési szöveggel való kereséshez:

// make the search request to the Bing Image API, and get the results"
imageResults = await client.Images.SearchAsync(query: searchTerm).Result; //search query

Az első képkeresési eredmény elemzése és megtekintése

Elemezze a válaszban visszaadott képtalálatokat.

Ha a válasz keresési eredményeket tartalmaz, tárolja az első találatot, és nyomtassa ki annak néhány részletét.

if (imageResults != null)
{
    //display the details for the first image result.
    var firstImageResult = imageResults.Value.First();
    Console.WriteLine($"\nTotal number of returned images: {imageResults.Value.Count}\n");
    Console.WriteLine($"Copy the following URLs to view these images on your browser.\n");
    Console.WriteLine($"URL to the first image:\n\n {firstImageResult.ContentUrl}\n");
    Console.WriteLine($"Thumbnail URL for the first image:\n\n {firstImageResult.ThumbnailUrl}");
    Console.WriteLine("Press any key to exit ...");
    Console.ReadKey();
}

Következő lépések

Egyoldalas alkalmazás-oktatóanyag a Bing Image Search használatához

Lásd még

Ezzel a rövid útmutatóval az első képkeresést a Bing Image Search ügyfélkódtár használatával végezheti el, amely az API burkolója, és ugyanazokat a funkciókat tartalmazza. Ez az egyszerű Java-alkalmazás elküld egy képkeresési lekérdezést, elemzi a JSON-választ, és megjeleníti az első visszaadott kép URL-címét.

Előfeltételek

A Java fejlesztői készlet (JDK) legfrissebb verziója

Telepítse a Bing Image Search ügyféloldali kódtár függőségeit a Maven, a Gradle vagy más függőségkezelési rendszer használatával. A Maven POM-fájlhoz a következő deklarációra van szükség:

 <dependencies>
    <dependency>
      <groupId>com.microsoft.azure.cognitiveservices</groupId>
      <artifactId>azure-cognitiveservices-imagesearch</artifactId>
      <version>1.0.1</version>
    </dependency>
 </dependencies>

Az alkalmazás létrehozása és inicializálása

  1. Hozzon létre egy új Java-projektet a kedvenc IDE-jében vagy szerkesztőjében, és adja hozzá a következő importálásokat az osztály implementációjához:

    import com.microsoft.azure.cognitiveservices.search.imagesearch.BingImageSearchAPI;
import com.microsoft.azure.cognitiveservices.search.imagesearch.BingImageSearchManager;
import com.microsoft.azure.cognitiveservices.search.imagesearch.models.ImageObject;
import com.microsoft.azure.cognitiveservices.search.imagesearch.models.ImagesModel;

  2. A fő metódusban hozza létre az előfizetési kulcs és a keresőkifejezés változóit. Ezután példányosítsa a Bing Image Search-ügyfelet.

    final String subscriptionKey = "COPY_YOUR_KEY_HERE";
String searchTerm = "canadian rockies";
//Image search client
BingImageSearchAPI client = BingImageSearchManager.authenticate(subscriptionKey);

Keresési kérelem küldése az API-nak

  1. A bingImages().search() használatával küldjön el egy HTTP-kérést a keresési lekérdezéssel. A választ mentse ImagesModel néven.

    ImagesModel imageResults = client.bingImages().search()
            .withQuery(searchTerm)
            .withMarket("en-us")
            .execute();

Az eredmények elemzése és megjelenítése

Elemezze a válaszban visszaadott képtalálatokat. Ha a válasz keresési eredményeket tartalmaz, tárolja az első találatot, és nyomtassa ki annak részleteit, például egy miniatűr URL-címet, az eredeti URL-címet, valamint a visszaadott képek teljes számát.

if (imageResults != null && imageResults.value().size() > 0) {
    // Image results
    ImageObject firstImageResult = imageResults.value().get(0);

    System.out.println(String.format("Total number of images found: %d", imageResults.value().size()));
    System.out.println(String.format("First image thumbnail url: %s", firstImageResult.thumbnailUrl()));
    System.out.println(String.format("First image content url: %s", firstImageResult.contentUrl()));
}
else {
        System.out.println("Couldn't find image results!");
     }

Következő lépések

Egyoldalas alkalmazás-oktatóanyag a Bing Image Search használatához

Lásd még

Ezzel a rövid útmutatóval az első képkeresést a Bing Image Search ügyfélkódtár használatával végezheti el, amely az API burkolója, és ugyanazokat a funkciókat tartalmazza. Ez az egyszerű JavaScript-alkalmazás elküld egy képkeresési lekérdezést, elemzi a JSON-választ, és megjeleníti az első visszaadott kép URL-címét.

Előfeltételek

  • A Node.js legújabb verziója.
  • A JavaScripthez készült Bing Image Search SDK
    • A telepítéshez futtassa a npm install @azure/cognitiveservices-imagesearch
  • Az CognitiveServicesCredentials osztály a csomagból @azure/ms-rest-azure-js az ügyfél hitelesítéséhez.
    • A telepítéshez futtassa a npm install @azure/ms-rest-azure-js

Az alkalmazás létrehozása és inicializálása

  1. Hozzon létre egy új JavaScript-fájlt a kedvenc IDE-környezetében vagy szerkesztőjében, és állítsa be a szigorúságot, a https-t és az egyéb követelményeket.

    'use strict';
const ImageSearchAPIClient = require('@azure/cognitiveservices-imagesearch');
const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;

  2. A projekt fő metódusában hozzon létre változókat érvényes előfizetési kulcsához, a Bing által visszaadandó képtalálatokhoz és egy keresési kifejezéshez. Ezután példányosítsa a képkeresési ügyfelet a kulcs használatával.

    //replace this value with your valid subscription key.
let serviceKey = "ENTER YOUR KEY HERE";

//the search term for the request
let searchTerm = "canadian rockies";

//instantiate the image search client
let credentials = new CognitiveServicesCredentials(serviceKey);
let imageSearchApiClient = new ImageSearchAPIClient(credentials);

Aszinkron segítő függvény létrehozása

  1. Hozzon létre egy függvényt, amely aszinkron módon hívja meg az ügyfelet, és visszaadja a Bing Image Search szolgáltatás válaszát.

    // a helper function to perform an async call to the Bing Image Search API
const sendQuery = async () => {
    return await imageSearchApiClient.imagesOperations.search(searchTerm);
};

Lekérdezés küldése és a válasz kezelése

  1. Hívja meg a segítő függvényt, és kezelje annak promise elemét a válaszban visszaadott képtalálatok elemzéséhez.

    Ha a válasz keresési eredményeket tartalmaz, tárolja az első találatot, és nyomtassa ki annak részleteit, például egy miniatűr URL-címet, az eredeti URL-címet, valamint a visszaadott képek teljes számát.

    sendQuery().then(imageResults => {
    if (imageResults == null) {
    console.log("No image results were found.");
    }
    else {
        console.log(`Total number of images returned: ${imageResults.value.length}`);
        let firstImageResult = imageResults.value[0];
        //display the details for the first image result. After running the application,
        //you can copy the resulting URLs from the console into your browser to view the image.
        console.log(`Total number of images found: ${imageResults.value.length}`);
        console.log(`Copy these URLs to view the first image returned:`);
        console.log(`First image thumbnail url: ${firstImageResult.thumbnailUrl}`);
        console.log(`First image content url: ${firstImageResult.contentUrl}`);
    }
  })
  .catch(err => console.error(err))

Következő lépések

Egyoldalas alkalmazás-oktatóanyag a Bing Image Search használatához

Lásd még

Ezzel a rövid útmutatóval az első képkeresést a Bing Image Search ügyfélkódtár használatával végezheti el, amely az API burkolója, és ugyanazokat a funkciókat tartalmazza. Ez az egyszerű Python-alkalmazás elküld egy képkeresési lekérdezést, elemzi a JSON-választ, és megjeleníti az első visszaadott kép URL-címét.

Előfeltételek

Az alkalmazás létrehozása és inicializálása

  1. Hozzon létre egy új Python-szkriptet a kedvenc IDE-környezetében vagy szerkesztőjében, az alábbi importálásokkal:

    from azure.cognitiveservices.search.imagesearch import ImageSearchClient
from msrest.authentication import CognitiveServicesCredentials

  2. Hozza létre az előfizetési kulcs és a keresett kifejezés változóit.

    subscription_key = "Enter your key here"
subscription_endpoint = "Enter your endpoint here"
search_term = "canadian rockies"

A képkeresési ügyfél létrehozása

  1. Hozza létre a CognitiveServicesCredentials egy példányát, és példányosítsa az ügyfelet:

    client = ImageSearchClient(endpoint=subscription_endpoint, credentials=CognitiveServicesCredentials(subscription_key))

  2. Küldjön egy keresési lekérdezést a Bing Image Search API-nak:

    image_results = client.images.search(query=search_term)

Dolgozza fel és tekintse meg az eredményeket

Elemezze a válaszban visszaadott képtalálatokat.

Ha a válasz keresési eredményeket tartalmaz, tárolja az első találatot, és nyomtassa ki annak részleteit, például egy miniatűr URL-címet, az eredeti URL-címet, valamint a visszaadott képek teljes számát.

if image_results.value:
    first_image_result = image_results.value[0]
    print("Total number of images returned: {}".format(len(image_results.value)))
    print("First image thumbnail url: {}".format(
        first_image_result.thumbnail_url))
    print("First image content url: {}".format(first_image_result.content_url))
else:
    print("No image results returned!")

Következő lépések

Egyoldalas alkalmazás-oktatóanyag a Bing Image Search használatához

Lásd még