Ottenere immagini dal Web con l'API Ricerca immagini Bing

  • Articolo

Avviso

Il 30 ottobre 2020 le API di Ricerca Bing spostate dai servizi di intelligenza artificiale di Azure ai servizi Ricerca Bing. Questa documentazione viene fornita solo per informazioni di riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API di ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite la Azure Marketplace.

Quando si usa l'API REST Ricerca immagini Bing, è possibile ottenere dal Web immagini correlate al termine di ricerca inviando la richiesta GET seguente:

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Usare il parametro q query per il termine di ricerca con codifica URL. Se ad esempio si immette sailing dinghies, impostare q su sailing+dinghies o sailing%20dinghies.

Importante

  • Tutte le richieste devono essere eseguite da un server, non da un client.
  • Se è la prima volta che si chiama un'API di ricerca Bing, non includere l'intestazione dell'ID client. Includere l'ID client solo se in precedenza è già stata chiamata un'API Bing che ha restituito un ID client per la combinazione utente e dispositivo.

Ottenere immagini da un dominio Web specifico

Per ottenere immagini da un dominio specifico, usare l'operatore query site:.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

Nota

Le risposte alle query tramite l'operatore site: potrebbero includere contenuti per adulti indipendentemente dall'impostazione safeSearch. Usare site: solo se si è a conoscenza del contenuto nel dominio.

Filtrare le immagini

Per impostazione predefinita, l'API Ricerca immagini restituisce tutte le immagini pertinenti alla query. Per filtrare le immagini restituite da Bing, ad esempio se sono necessarie solo immagini con uno sfondo trasparente o di una dimensione specifica, usare i parametri di query seguenti:

  • aspetto: Filtrare le immagini in base alle proporzioni(ad esempio, immagini standard o wide screen).
  • colore: filtra le immagini per colore dominante o nero e bianco.
  • freschezza: filtra le immagini in base all'età,ad esempio le immagini individuate da Bing nella settimana precedente.
  • altezza, larghezza: filtrare le immagini in base alla larghezza e all'altezza.
  • imageContent: filtrare le immagini in base al contenuto, ad esempio immagini che mostrano solo il viso di una persona.
  • imageType: filtrare le immagini in base al tipo (ad esempio, clip art, GIF animate o sfondi trasparenti).
  • licenza: filtrare le immagini in base al tipo di licenza associato al sito.
  • dimensioni: Filtrare le immagini in base alle dimensioni, ad esempio immagini piccole fino a 200x200 pixel.

Per ottenere immagini da un dominio specifico, usare l'operatore query site:.

L'esempio seguente illustra come ottenere immagini di piccole dimensioni da ContosoSailing.com individuate da Bing la scorsa settimana.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&size=small&freshness=week&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
X-MSEdge-ClientIP: 999.999.999.999  
X-Search-Location: lat:47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

Formato della risposta di Ricerca immagini Bing

Il messaggio di risposta da Bing contiene una risposta Images che contiene un elenco di immagini che i servizi di intelligenza artificiale di Azure hanno determinato essere rilevanti per la query. Ogni oggetto Immagine contenuto nell'elenco include le informazioni seguenti sull'immagine: l'URL, le dimensioni, le proporzioni, il formato di codifica, un URL di un'anteprima dell'immagine e le dimensioni dell'anteprima.

Nota

  • È necessario visualizzare le immagini nell'ordine indicato nella risposta.
  • Poiché i formati e i parametri degli URL sono soggetti a modifica senza preavviso, usare gli URL così come sono. Non acquisire dipendenze da formati o parametri degli URL se non diversamente specificato.
{
    "name": "Rich Passage Sailing Dinghy",
    "webSearchUrl": "https:\/\/www.bing.com\/cr?IG=73118C8B4E3...",
    "thumbnailUrl": "https:\/\/tse1.mm.bing.net\/th?id=OIP.GNarK7m...",
    "datePublished": "2011-10-29T11:26:00",
    "contentUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3...",
    "hostPageUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3687...",
    "contentSize": "79239 B",
    "encodingFormat": "jpeg",
    "hostPageDisplayUrl": "en.contoso.org\/wiki\/File:Rich_Passage...",
    "width": 526,
    "height": 688,
    "thumbnail": {
        "width": 229,
        "height": 300
    },
    "imageInsightsToken": "ccid_GNarK7ma*mid_CCF85447ADA6...",
    "insightsSourcesSummary": {
        "shoppingSourcesCount": 0,
        "recipeSourcesCount": 0
    },
    "imageId": "CCF85447ADA6FFF9E96E7DF0B796F7A86E34593",
    "accentColor": "376094"
},

Quando si chiama l'API Ricerca immagini Bing, Bing restituisce un elenco di risultati. L'elenco è un subset del numero totale di risultati pertinenti alla query. Il campo totalEstimatedMatches della risposta contiene una stima del numero di immagini disponibili da visualizzare. Per informazioni dettagliate su come sfogliare le immagini rimanenti, vedere Sfogliare le immagini.

Passaggi successivi

Se non si è ancora provato l'API Ricerca immagini Bing, consultare una Guida introduttiva. Se si cercano contenuti più complessi, provare l'esercitazione che consente di creare un'app Web a pagina singola.