Ottenere immagini dal Web con l'API Ricerca immagini Bing

Avvertimento

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

Quando si usa l'API REST Ricerca immagini Bing, è possibile ottenere immagini dal Web 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 di query q per il termine di ricerca codificato nell'URL. Ad esempio, se immetti dinghi a vela, impostali su qsailing+dinghies o sailing%20dinghies.

Importante

• Tutte le richieste devono essere effettuate da un server e non da un client.
• Se è la prima volta che utilizzi una delle API di ricerca Bing, non includere l'intestazione dell'ID cliente. Includere l'ID client solo se in precedenza è 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 site: query.

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 che usano l'operatore site: possono includere contenuto 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 rilevanti per la query. Se si desidera filtrare le immagini restituite da Bing (ad esempio, per restituire solo immagini con uno sfondo trasparente o dimensioni specifiche), usare i parametri di query seguenti:

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

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

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

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 di risposta ricerca immagini Bing

Il messaggio di risposta di 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 Image nell'elenco include le informazioni seguenti sull'immagine: l'URL, le dimensioni, le dimensioni, il formato di codifica, l'URL di un'anteprima dell'immagine e le dimensioni dell'anteprima.

Nota

• Le immagini devono essere visualizzate nell'ordine specificato nella risposta.
• Poiché i formati e i parametri degli URL sono soggetti a modifiche senza preavviso, usare tutti gli URL as-is. Non è consigliabile accettare dipendenze dal formato o dai parametri dell'URL, tranne dove indicato.

{
    "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 rilevanti per la query. Il campo della totalEstimatedMatches risposta contiene una stima del numero di immagini disponibili per la visualizzazione. Per informazioni dettagliate su come scorrere il resto delle immagini, vedere Paging Images .For details about how to page through the rest of the images, see Paging Images.

Passaggi successivi

Se non hai mai provato l'API di Ricerca Immagini di Bing, prova una guida introduttiva . Se si sta cercando qualcosa di più complesso, provare l'esercitazione per creare un'app Web a pagina singola .