Condividi tramite

Endpoint per 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.

L'API Ricerca immagini include tre endpoint. L'endpoint 1 restituisce immagini dal Web in base a una query. L'endpoint 2 restituisce ImageInsights. L'endpoint 3 restituisce immagini di tendenza.

Endpoint

Per ottenere risultati immagini tramite l'API Bing, inviare una richiesta a uno degli endpoint seguenti. Usare le intestazioni e i parametri URL per definire altre specifiche.

Endpoint 1: restituisce immagini attinenti alla query di ricerca dell'utente definita da ?q="".

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search

Endpoint 2: restituisce informazioni dettagliate su un'immagine usando GET o POST.

 GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details

Una richiesta GET restituisce informazioni dettagliate su un'immagine, ad esempio le pagine Web che includono l'immagine. Includere il parametro insightsToken con una richiesta GET.

In alternativa, è possibile includere un'immagine binaria nel corpo di una richiesta POST e impostare il parametro modules su RecognizedEntities. Viene restituito un parametro insightsToken da usare in una richiesta GET successiva che restituirà le informazioni sulle persone nell'immagine. Impostare il valore modules su All per ottenere tutte le informazioni dettagliate tranne RecognizedEntities nei risultati di POST senza eseguire un'altra chiamata usando il parametro insightsToken.

Endpoint 3: restituisce immagini di tendenza in base alle richieste di ricerca di altri utenti. Le immagini sono suddivise in diverse categorie, ad esempio in base a eventi o persone importanti.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/trending

Per un elenco dei mercati che supportano le immagini di tendenza, vedere Immagini di tendenza.

Per maggiori dettagli su intestazioni, parametri, codici di mercato, oggetti di risposta, errori e altro ancora, vedere le informazioni di riferimento per l'API Ricerca immagini Bing v7.

Risposta JSON

La risposta a una richiesta di ricerca di immagini include i risultati come oggetti JSON. Per esempi di analisi dei risultati, vedere l'esercitazione e il codice sorgente.

Passaggi successivi

Le API Bing supportano azioni di ricerca che restituiscono risultati in base al tipo. Tutti gli endpoint di ricerca restituiscono risultati come oggetti della risposta JSON.  Tutti gli endpoint supportano query che restituiscono una posizione e/o una lingua specifica in base a longitudine, latitudine e raggio di ricerca.

Per informazioni complete sui parametri supportati da ogni endpoint, vedere le pagine di riferimento per ogni tipo. Per esempi di richieste di base eseguite con l'API Ricerca immagini, vedere le guide introduttive per Ricerca immagini.