Condividi tramite

ImagesSearchOptionalParams interface

Pacchetto:
@azure/cognitiveservices-imagesearch

Parametri facoltativi.

Extends
RequestOptionsBase

Proprietà

acceptLanguage

Elenco delimitato da virgole di una o più lingue da usare per le stringhe dell'interfaccia utente. L'elenco è in ordine decrescente di preferenza. Per altre informazioni, incluso il formato previsto, vedere RFC2616. Questa intestazione e il parametro di query setLang si escludono a vicenda; non specificare entrambi. Se si imposta questa intestazione, è necessario specificare anche il parametro di query cc. Per determinare il mercato per cui restituire i risultati, Bing usa la prima lingua supportata trovata dall'elenco e la combina con il valore del parametro cc. Se l'elenco non include una lingua supportata, Bing trova la lingua e il mercato più vicini che supportano la richiesta oppure usa un mercato aggregato o predefinito per i risultati. Per determinare il mercato usato da Bing, vedere l'intestazione BingAPIs-Market. Usare questa intestazione e il parametro di query cc solo se si specificano più lingue. In caso contrario, usare i parametri di query mkt e setLang. Una stringa dell'interfaccia utente è una stringa usata come etichetta in un'interfaccia utente. Esistono poche stringhe dell'interfaccia utente negli oggetti risposta JSON. Tutti i collegamenti alle proprietà Bing.com negli oggetti risposta applicano la lingua specificata.
aspect

Filtrare le immagini in base alle proporzioni seguenti. Tutto: non filtrare in base all'aspetto. Specificare questo valore equivale a non specificare il parametro di aspetto. Quadrato: restituisce immagini con proporzioni standard. Wide: restituisce immagini con proporzioni dello schermo wide. Alto: restituisce immagini con proporzioni alte. I valori possibili includono: 'All', 'Square', 'Wide', 'Tall'
clientId

Bing usa questa intestazione per fornire agli utenti un comportamento coerente tra le chiamate API Bing. Bing spesso esegue il volo di nuove funzionalità e miglioramenti e usa l'ID client come chiave per l'assegnazione del traffico su diversi voli. Se non si usa lo stesso ID client per un utente in più richieste, Bing può assegnare l'utente a più voli in conflitto. L'assegnazione a più voli in conflitto può comportare un'esperienza utente incoerente. Ad esempio, se la seconda richiesta ha un'assegnazione di anteprima diversa rispetto alla prima, l'esperienza potrebbe essere imprevista. Bing può anche usare l'ID client per personalizzare i risultati Web in base alla cronologia di ricerca dell'ID client, offrendo un'esperienza più completa per l'utente. Bing usa anche questa intestazione per migliorare le classificazioni dei risultati analizzando l'attività generata da un ID client. I miglioramenti della pertinenza aiutano a migliorare la qualità dei risultati forniti dalle API Bing e a loro volta abilitano tariffe click-through più elevate per il consumer di API. IMPORTANTE: anche se facoltativo, è consigliabile considerare questa intestazione obbligatoria. La persistenza dell'ID client tra più richieste per la stessa combinazione di utenti finali e dispositivo consente al consumer dell'API di ricevere un'esperienza utente coerente e 2) velocità di clic più elevate tramite una migliore qualità dei risultati delle API Bing. Ogni utente che usa l'applicazione nel dispositivo deve avere un ID client generato da Bing univoco. Se non si include questa intestazione nella richiesta, Bing genera un ID e lo restituisce nell'intestazione della risposta X-MSEdge-ClientID. L'unica volta che non devi includere questa intestazione in una richiesta è la prima volta che l'utente usa l'app nel dispositivo. Usare l'ID client per ogni richiesta API Bing eseguita dall'app per questo utente nel dispositivo. Rendere persistente l'ID client. Per rendere persistente l'ID in un'app browser, usare un cookie HTTP permanente per assicurarsi che l'ID venga usato in tutte le sessioni. Non usare un cookie di sessione. Per altre app come le app per dispositivi mobili, usare l'archiviazione permanente del dispositivo per rendere persistente l'ID. La volta successiva che l'utente usa l'app nel dispositivo, ottenere l'ID client salvato in modo permanente. Le risposte Bing possono includere o meno questa intestazione. Se la risposta include questa intestazione, acquisire l'ID client e usarlo per tutte le richieste Bing successive per l'utente nel dispositivo. Se si include X-MSEdge-ClientID, non è necessario includere i cookie nella richiesta.
clientIp

Indirizzo IPv4 o IPv6 del dispositivo client. L'indirizzo IP viene usato per individuare la posizione dell'utente. Bing usa le informazioni sulla posizione per determinare il comportamento di ricerca sicuro. Anche se facoltativo, è consigliabile specificare sempre questa intestazione e l'intestazione X-Search-Location. Non offuscare l'indirizzo , ad esempio modificando l'ultimo ottetto su 0. L'offuscamento dell'indirizzo comporta che la posizione non si trova in nessun punto vicino alla posizione effettiva del dispositivo, che può causare risultati errati in Bing.
color

Filtrare le immagini in base alle opzioni di colore seguenti. ColorOnly: restituisce immagini a colori. Monocromatico: restituisce immagini bianche e nere. Restituisce immagini con uno dei colori dominanti seguenti: Nero, Blu, Marrone, Grigio, Verde, Arancione, Rosa, Viola, Rosso, Teal, Bianco, Giallo. I valori possibili includono: 'ColorOnly', 'Monochrome', 'Black', 'Blue', 'Brown', 'Gray', 'Green', 'Orange', 'Pink', 'Purple', 'Red', 'Teal', 'White', 'Yellow'
count

Numero di immagini da restituire nella risposta. Il numero effettivo recapitato può essere minore di quello richiesto. Il valore predefinito è 35. Il valore massimo è 150. Questo parametro viene usato insieme al parametro offset per visualizzare i risultati della pagina. Ad esempio, se l'interfaccia utente visualizza 20 immagini per pagina, impostare count su 20 e offset su 0 per ottenere la prima pagina dei risultati. Per ogni pagina successiva, l'offset di incremento di 20 (ad esempio, 0, 20, 40). Usare questo parametro solo con la ricerca immagini API.Do non specificare questo parametro quando si chiamano le API Insights, Trending Images o Ricerca Web.
countryCode

Codice paese a 2 caratteri del paese da cui provengono i risultati. Per un elenco dei valori possibili, vedere Codici di mercato. Se si imposta questo parametro, è necessario specificare anche l'intestazione Accept-Language. Bing usa la prima lingua supportata trovata dall'elenco delle lingue e combina tale lingua con il codice paese specificato per determinare il mercato per cui restituire i risultati. Se l'elenco delle lingue non include una lingua supportata, Bing trova la lingua e il mercato più vicini che supportano la richiesta oppure può usare un mercato aggregato o predefinito per i risultati anziché uno specificato. È consigliabile usare questo parametro di query e il parametro di query Accept-Language solo se si specificano più lingue; in caso contrario, è necessario usare i parametri di query mkt e setLang. Questo parametro e il parametro mkt parametro di query si escludono a vicenda, non specificano entrambi.
freshness

Filtrare le immagini in base alle opzioni di individuazione seguenti. Giorno: restituisce immagini individuate da Bing nelle ultime 24 ore. Settimana: restituisce immagini individuate da Bing negli ultimi 7 giorni. Mese: restituisce immagini individuate da Bing negli ultimi 30 giorni. I valori possibili includono: 'Day', 'Week', 'Month'
height

Filtrare le immagini con l'altezza specificata, in pixel. È possibile usare questo filtro con il filtro delle dimensioni per restituire immagini di piccole dimensioni con un'altezza di 150 pixel.
id

ID che identifica in modo univoco un'immagine. Usare questo parametro per assicurarsi che l'immagine specificata sia la prima immagine nell'elenco di immagini restituite da Bing. Il campo imageId image dell'oggetto contiene l'ID su cui si imposta questo parametro.
imageContent

Filtrare le immagini in base ai tipi di contenuto seguenti. Viso: restituisce immagini che mostrano solo il viso di una persona. Ritratto: restituisce immagini che mostrano solo la testa e le spalle di una persona. I valori possibili includono: 'Face', 'Portrait'
imageType

Filtrare le immagini in base ai tipi di immagine seguenti. AnimatedGif: restituisce solo GIF animate. Clipart: restituisce solo immagini clipart. Linea: restituisce solo disegni a linee. Foto: restituisce solo fotografie(esclusi disegni a linee, gif animate e clipart). Shopping: restituisce solo immagini contenenti elementi in cui Bing conosce un commerciante che vende gli articoli. Questa opzione è valida solo nel mercato en - Stati Uniti. Trasparente: restituisce solo immagini con sfondo trasparente. I valori possibili includono: 'AnimatedGif', 'Clipart', 'Line', 'Photo', 'Shopping', 'Transparent'
license

Filtrare le immagini in base ai tipi di licenza seguenti. Tutto: non filtrare in base al tipo di licenza. Specificare questo valore equivale a non specificare il parametro license. Any: restituisce immagini con qualsiasi tipo di licenza. La risposta non include immagini che non specificano una licenza o la licenza è sconosciuta. Pubblico: restituisce immagini in cui l'autore ha rinunciato ai propri diritti esclusivi, nella misura massima consentita dalla legge. Condividi: restituisce immagini che possono essere condivise con altri utenti. La modifica o la modifica dell'immagine potrebbero non essere consentite. Inoltre, la modifica, la condivisione e l'uso dell'immagine per scopi commerciali potrebbero non essere consentiti. In genere, questa opzione restituisce la maggior parte delle immagini. ShareCommercially: restituisce immagini che possono essere condivise con altri utenti per scopi personali o commerciali. La modifica o la modifica dell'immagine potrebbero non essere consentite. Modifica: restituisce immagini che possono essere modificate, condivise e usate. La modifica o la modifica dell'immagine potrebbero non essere consentite. La modifica, la condivisione e l'uso dell'immagine per scopi commerciali potrebbero non essere consentiti. ModifyCommercially: restituisce immagini che possono essere modificate, condivise e usate per scopi personali o commerciali. In genere, questa opzione restituisce le immagini più poche. Per altre informazioni su questi tipi di licenza, vedere Filtrare le immagini in base al tipo di licenza. I valori possibili includono: 'All', 'Any', 'Public', 'Share', 'ShareCommercially', 'Modify', 'ModifyCommercially'
location

Elenco delimitato da punto e virgola di coppie chiave/valore che descrivono la posizione geografica del client. Bing usa le informazioni sulla posizione per determinare il comportamento di ricerca sicuro e per restituire il contenuto locale pertinente. Specificare la coppia chiave/valore come chiave <>:<valore>. Di seguito sono riportate le chiavi usate per specificare la posizione dell'utente. lat (obbligatorio): latitudine della posizione del client, espressa in gradi. La latitudine deve essere maggiore o uguale a -90,0 e minore o uguale a +90,0. I valori negativi indicano le latitudine meridionali e i valori positivi indicano le latitudine settentrionali. long (obbligatorio): longitudine della posizione del client, espressa in gradi. La longitudine deve essere maggiore o uguale a -180,0 e minore o uguale a +180,0. I valori negativi indicano longitudini occidentali e valori positivi indicano longitudini orientali. re (obbligatorio): raggio, in metri, che specifica l'accuratezza orizzontale delle coordinate. Passare il valore restituito dal servizio di posizione del dispositivo. I valori tipici potrebbero essere 22m per GPS/Wi-Fi, 380m per la triangolazione della torre cellulare e 18.000m per la ricerca IP inversa. ts (facoltativo): timestamp UNIX UTC di quando il client si trovava nella posizione. Il timestamp UNIX è il numero di secondi dal 1° gennaio 1970. head (facoltativo): direzione o direzione di viaggio del cliente. Specificare la direzione di viaggio come gradi compreso tra 0 e 360, contando in senso orario rispetto a true nord. Specificare questa chiave solo se la chiave sp è diversa da zero. sp (facoltativo): velocità orizzontale (velocità), in metri al secondo, che il dispositivo client sta viaggiando. alt (facoltativo): altitudine del dispositivo client, in metri. sono (facoltativo): raggio, in metri, che specifica l'accuratezza verticale delle coordinate. Specificare questo tasto solo se si specifica il tasto ALT. Anche se molte delle chiavi sono facoltative, più informazioni vengono fornite, più accurati sono i risultati della posizione. Anche se facoltativo, è consigliabile specificare sempre la posizione geografica dell'utente. Fornire la posizione è particolarmente importante se l'indirizzo IP del client non riflette in modo accurato la posizione fisica dell'utente ( ad esempio, se il client usa VPN). Per ottenere risultati ottimali, è necessario includere questa intestazione e l'intestazione X-MSEdge-ClientIP, ma almeno è necessario includere questa intestazione.
market

Il mercato da cui provengono i risultati. In genere, mkt è il paese in cui l'utente effettua la richiesta. Tuttavia, potrebbe trattarsi di un paese diverso se l'utente non si trova in un paese in cui Bing fornisce risultati. Il mercato deve essere nella forma <codice> lingua-codice<> paese. Ad esempio, en-US. La stringa non fa distinzione tra maiuscole e minuscole. Per un elenco dei possibili valori di mercato, vedere Market Codes. NOTA: se noto, si consiglia di specificare sempre il mercato. Specificare il mercato consente a Bing di indirizzare la richiesta e restituire una risposta appropriata e ottimale. Se si specifica un mercato non elencato in codici di mercato, Bing usa un codice di mercato più adatto in base a un mapping interno soggetto a modifiche. Questo parametro e il cc parametro di query si escludono a vicenda, non specificano entrambi.
maxFileSize

Filtrare le immagini minori o uguali alle dimensioni del file specificate. Le dimensioni massime del file che è possibile specificare sono 520.192 byte. Se si specifica un valore maggiore, l'API usa 520.192. È possibile che la risposta includa immagini leggermente superiori al valore massimo specificato. È possibile specificare questo filtro e minFileSize per filtrare le immagini all'interno di un intervallo di dimensioni del file.
maxHeight

Filtrare le immagini con un'altezza minore o uguale all'altezza specificata. Specificare l'altezza in pixel. È possibile specificare questo filtro e minHeight per filtrare le immagini all'interno di un intervallo di altezze. Questo filtro e il filtro altezza si escludono a vicenda.
maxWidth

Filtrare le immagini con una larghezza minore o uguale alla larghezza specificata. Specificare la larghezza in pixel. È possibile specificare questo filtro e maxWidth per filtrare le immagini all'interno di un intervallo di larghezze. Questo filtro e il filtro di larghezza si escludono a vicenda.
minFileSize

Filtrare le immagini maggiori o uguali alle dimensioni del file specificate. Le dimensioni massime del file che è possibile specificare sono 520.192 byte. Se si specifica un valore maggiore, l'API usa 520.192. È possibile che la risposta includa immagini leggermente inferiori al minimo specificato. È possibile specificare questo filtro e maxFileSize per filtrare le immagini all'interno di un intervallo di dimensioni del file.
minHeight

Filtrare le immagini con un'altezza maggiore o uguale all'altezza specificata. Specificare l'altezza in pixel. È possibile specificare questo filtro e maxHeight per filtrare le immagini all'interno di un intervallo di altezze. Questo filtro e il filtro altezza si escludono a vicenda.
minWidth

Filtrare le immagini con una larghezza maggiore o uguale alla larghezza specificata. Specificare la larghezza in pixel. È possibile specificare questo filtro e maxWidth per filtrare le immagini all'interno di un intervallo di larghezze. Questo filtro e il filtro di larghezza si escludono a vicenda.
offset

Offset in base zero che indica il numero di immagini da ignorare prima di restituire immagini. Il valore predefinito è 0. L'offset deve essere minore di (totalEstimatedMatches

  • conteggio). Usare questo parametro insieme al parametro count per visualizzare i risultati della pagina. Ad esempio, se l'interfaccia utente visualizza 20 immagini per pagina, impostare count su 20 e offset su 0 per ottenere la prima pagina dei risultati. Per ogni pagina successiva, l'offset di incremento di 20 (ad esempio, 0, 20, 40). È possibile che più pagine includano alcune sovrapposizioni nei risultati. Per evitare duplicati, vedere nextOffset. Usare questo parametro solo con l'API Image. Non specificare questo parametro quando si chiama l'API Immagini di tendenza o l'API Ricerca Web.
safeSearch

Filtrare le immagini per il contenuto per adulti. Di seguito sono riportati i possibili valori di filtro. Disattivato: può restituire immagini con contenuto per adulti. Se la richiesta viene eseguita tramite l'API Ricerca immagini, la risposta include immagini di anteprima non crittografate (non fuzzy). Tuttavia, se la richiesta è tramite l'API Ricerca Web, la risposta include immagini di anteprima pixelate (fuzzy). Moderate: se la richiesta è tramite l'API Ricerca immagini, la risposta non include immagini con contenuto per adulti. Se la richiesta è tramite l'API Ricerca Web, la risposta può includere immagini con contenuto per adulti (le immagini di anteprima vengono pixelate (fuzzy)). Strict: non restituire immagini con contenuto per adulti. Il valore predefinito è Moderate. Se la richiesta proviene da un mercato che i criteri per adulti di Bing richiedono che safeSearch sia impostato su Strict, Bing ignora il valore safeSearch e usa Strict. Se si usa l'operatore site: query, è possibile che la risposta contenga contenuto per adulti indipendentemente dal parametro di query safeSearch impostato su. Usa sito: solo se si è a conoscenza del contenuto nel sito e lo scenario supporta la possibilità di contenuto per adulti. I valori possibili includono: 'Off', 'Moderate', 'Strict'
setLang

Lingua da usare per le stringhe dell'interfaccia utente. Specificare la lingua usando il codice di lingua ISO 639-1 a 2 lettere. Ad esempio, il codice della lingua per l'inglese è EN. Il valore predefinito è EN (inglese). Anche se facoltativo, è consigliabile specificare sempre la lingua. In genere, si imposta setLang sulla stessa lingua specificata da mkt, a meno che l'utente non voglia visualizzare le stringhe dell'interfaccia utente in una lingua diversa. Questo parametro e l'intestazione accept-language si escludono a vicenda; non specificare entrambi. Una stringa dell'interfaccia utente è una stringa usata come etichetta in un'interfaccia utente. Esistono poche stringhe dell'interfaccia utente negli oggetti risposta JSON. Inoltre, tutti i collegamenti alle proprietà Bing.com negli oggetti risposta applicano la lingua specificata.
size

Filtrare le immagini in base alle dimensioni seguenti. Tutto: non filtrare in base alle dimensioni. Specificare questo valore equivale a non specificare il parametro size. Piccolo: restituisce immagini inferiori a 200x200 pixel. Medio: restituisce immagini maggiori o uguali a 200x200 pixel, ma inferiori a 500x500 pixel. Grande: restituisce immagini di dimensioni maggiori o maggiori di 500x500 pixel. Sfondo: restituisce immagini di sfondo. È possibile usare questo parametro insieme ai parametri height o width. Ad esempio, è possibile usare altezza e dimensioni per richiedere immagini di piccole dimensioni di 150 pixel di altezza. I valori possibili includono: 'All', 'Small', 'Medium', 'Large', 'Wallpaper'
userAgent

Agente utente che ha origine la richiesta. Bing usa l'agente utente per offrire agli utenti mobili un'esperienza ottimizzata. Anche se facoltativo, è consigliabile specificare sempre questa intestazione. L'agente utente deve essere la stessa stringa inviata da qualsiasi browser comunemente usato. Per informazioni sugli agenti utente, vedere RFC 2616. Di seguito sono riportati esempi di stringhe dell'agente utente. Windows Phone: Mozilla/5.0 (compatibile; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; BRACCIO; Toccare; NOKIA; Lumia 822). Android: Mozilla / 5.0 (Linux; U; Android 2.3.5; en - noi; SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; come Gecko) Versione / 4.0 Mobile Safari / 533.1. iPhone: Mozilla / 5.0 (iPhone; CPU iPhone OS 6_1 come Mac OS X) AppleWebKit / 536.26 (KHTML; come Gecko) Mobile / 10B142 iPhone4; 1 BingWeb / 3.03.1428.20120423. PC: Mozilla / 5.0 (Windows NT 6.3; WOW64; Trident / 7.0; Toccare; rv:11.0) come Gecko. iPad: Mozilla / 5.0 (iPad; CPU OS 7_0 come Mac OS X) AppleWebKit / 537.51.1 (KHTML, come Gecko) Versione / 7.0 Mobile / 11A465 Safari / 9537.53
width

Filtra le immagini con la larghezza specificata, espressa in pixel. È possibile usare questo filtro con il filtro delle dimensioni per restituire immagini di piccole dimensioni con una larghezza di 150 pixel.

Proprietà ereditate

abortSignal

Segnale che può essere usato per interrompere le richieste.
customHeaders

Intestazioni di richiesta personalizzate definite dall'utente che verranno applicate prima dell'invio della richiesta.
onDownloadProgress

Callback che viene attivato all'avanzamento del download.
onUploadProgress

Callback che viene attivato al momento dell'avanzamento del caricamento.
timeout

Numero di millisecondi che una richiesta può richiedere prima di essere terminata automaticamente.

Dettagli proprietà

acceptLanguage

Elenco delimitato da virgole di una o più lingue da usare per le stringhe dell'interfaccia utente. L'elenco è in ordine decrescente di preferenza. Per altre informazioni, incluso il formato previsto, vedere RFC2616. Questa intestazione e il parametro di query setLang si escludono a vicenda; non specificare entrambi. Se si imposta questa intestazione, è necessario specificare anche il parametro di query cc. Per determinare il mercato per cui restituire i risultati, Bing usa la prima lingua supportata trovata dall'elenco e la combina con il valore del parametro cc. Se l'elenco non include una lingua supportata, Bing trova la lingua e il mercato più vicini che supportano la richiesta oppure usa un mercato aggregato o predefinito per i risultati. Per determinare il mercato usato da Bing, vedere l'intestazione BingAPIs-Market. Usare questa intestazione e il parametro di query cc solo se si specificano più lingue. In caso contrario, usare i parametri di query mkt e setLang. Una stringa dell'interfaccia utente è una stringa usata come etichetta in un'interfaccia utente. Esistono poche stringhe dell'interfaccia utente negli oggetti risposta JSON. Tutti i collegamenti alle proprietà Bing.com negli oggetti risposta applicano la lingua specificata.

acceptLanguage?: string

Valore della proprietà

string

aspect

Filtrare le immagini in base alle proporzioni seguenti. Tutto: non filtrare in base all'aspetto. Specificare questo valore equivale a non specificare il parametro di aspetto. Quadrato: restituisce immagini con proporzioni standard. Wide: restituisce immagini con proporzioni dello schermo wide. Alto: restituisce immagini con proporzioni alte. I valori possibili includono: 'All', 'Square', 'Wide', 'Tall'

aspect?: ImageAspect

Valore della proprietà

ImageAspect

clientId

Bing usa questa intestazione per fornire agli utenti un comportamento coerente tra le chiamate API Bing. Bing spesso esegue il volo di nuove funzionalità e miglioramenti e usa l'ID client come chiave per l'assegnazione del traffico su diversi voli. Se non si usa lo stesso ID client per un utente in più richieste, Bing può assegnare l'utente a più voli in conflitto. L'assegnazione a più voli in conflitto può comportare un'esperienza utente incoerente. Ad esempio, se la seconda richiesta ha un'assegnazione di anteprima diversa rispetto alla prima, l'esperienza potrebbe essere imprevista. Bing può anche usare l'ID client per personalizzare i risultati Web in base alla cronologia di ricerca dell'ID client, offrendo un'esperienza più completa per l'utente. Bing usa anche questa intestazione per migliorare le classificazioni dei risultati analizzando l'attività generata da un ID client. I miglioramenti della pertinenza aiutano a migliorare la qualità dei risultati forniti dalle API Bing e a loro volta abilitano tariffe click-through più elevate per il consumer di API. IMPORTANTE: anche se facoltativo, è consigliabile considerare questa intestazione obbligatoria. La persistenza dell'ID client tra più richieste per la stessa combinazione di utenti finali e dispositivo consente al consumer dell'API di ricevere un'esperienza utente coerente e 2) velocità di clic più elevate tramite una migliore qualità dei risultati delle API Bing. Ogni utente che usa l'applicazione nel dispositivo deve avere un ID client generato da Bing univoco. Se non si include questa intestazione nella richiesta, Bing genera un ID e lo restituisce nell'intestazione della risposta X-MSEdge-ClientID. L'unica volta che non devi includere questa intestazione in una richiesta è la prima volta che l'utente usa l'app nel dispositivo. Usare l'ID client per ogni richiesta API Bing eseguita dall'app per questo utente nel dispositivo. Rendere persistente l'ID client. Per rendere persistente l'ID in un'app browser, usare un cookie HTTP permanente per assicurarsi che l'ID venga usato in tutte le sessioni. Non usare un cookie di sessione. Per altre app come le app per dispositivi mobili, usare l'archiviazione permanente del dispositivo per rendere persistente l'ID. La volta successiva che l'utente usa l'app nel dispositivo, ottenere l'ID client salvato in modo permanente. Le risposte Bing possono includere o meno questa intestazione. Se la risposta include questa intestazione, acquisire l'ID client e usarlo per tutte le richieste Bing successive per l'utente nel dispositivo. Se si include X-MSEdge-ClientID, non è necessario includere i cookie nella richiesta.

clientId?: string

Valore della proprietà

string

clientIp

Indirizzo IPv4 o IPv6 del dispositivo client. L'indirizzo IP viene usato per individuare la posizione dell'utente. Bing usa le informazioni sulla posizione per determinare il comportamento di ricerca sicuro. Anche se facoltativo, è consigliabile specificare sempre questa intestazione e l'intestazione X-Search-Location. Non offuscare l'indirizzo , ad esempio modificando l'ultimo ottetto su 0. L'offuscamento dell'indirizzo comporta che la posizione non si trova in nessun punto vicino alla posizione effettiva del dispositivo, che può causare risultati errati in Bing.

clientIp?: string

Valore della proprietà

string

color

Filtrare le immagini in base alle opzioni di colore seguenti. ColorOnly: restituisce immagini a colori. Monocromatico: restituisce immagini bianche e nere. Restituisce immagini con uno dei colori dominanti seguenti: Nero, Blu, Marrone, Grigio, Verde, Arancione, Rosa, Viola, Rosso, Teal, Bianco, Giallo. I valori possibili includono: 'ColorOnly', 'Monochrome', 'Black', 'Blue', 'Brown', 'Gray', 'Green', 'Orange', 'Pink', 'Purple', 'Red', 'Teal', 'White', 'Yellow'

color?: ImageColor

Valore della proprietà

ImageColor

count

Numero di immagini da restituire nella risposta. Il numero effettivo recapitato può essere minore di quello richiesto. Il valore predefinito è 35. Il valore massimo è 150. Questo parametro viene usato insieme al parametro offset per visualizzare i risultati della pagina. Ad esempio, se l'interfaccia utente visualizza 20 immagini per pagina, impostare count su 20 e offset su 0 per ottenere la prima pagina dei risultati. Per ogni pagina successiva, l'offset di incremento di 20 (ad esempio, 0, 20, 40). Usare questo parametro solo con la ricerca immagini API.Do non specificare questo parametro quando si chiamano le API Insights, Trending Images o Ricerca Web.

count?: number

Valore della proprietà

number

countryCode

Codice paese a 2 caratteri del paese da cui provengono i risultati. Per un elenco dei valori possibili, vedere Codici di mercato. Se si imposta questo parametro, è necessario specificare anche l'intestazione Accept-Language. Bing usa la prima lingua supportata trovata dall'elenco delle lingue e combina tale lingua con il codice paese specificato per determinare il mercato per cui restituire i risultati. Se l'elenco delle lingue non include una lingua supportata, Bing trova la lingua e il mercato più vicini che supportano la richiesta oppure può usare un mercato aggregato o predefinito per i risultati anziché uno specificato. È consigliabile usare questo parametro di query e il parametro di query Accept-Language solo se si specificano più lingue; in caso contrario, è necessario usare i parametri di query mkt e setLang. Questo parametro e il parametro mkt parametro di query si escludono a vicenda, non specificano entrambi.

countryCode?: string

Valore della proprietà

string

freshness

Filtrare le immagini in base alle opzioni di individuazione seguenti. Giorno: restituisce immagini individuate da Bing nelle ultime 24 ore. Settimana: restituisce immagini individuate da Bing negli ultimi 7 giorni. Mese: restituisce immagini individuate da Bing negli ultimi 30 giorni. I valori possibili includono: 'Day', 'Week', 'Month'

freshness?: Freshness

Valore della proprietà

Freshness

height

Filtrare le immagini con l'altezza specificata, in pixel. È possibile usare questo filtro con il filtro delle dimensioni per restituire immagini di piccole dimensioni con un'altezza di 150 pixel.

height?: number

Valore della proprietà

number

id

ID che identifica in modo univoco un'immagine. Usare questo parametro per assicurarsi che l'immagine specificata sia la prima immagine nell'elenco di immagini restituite da Bing. Il campo imageId image dell'oggetto contiene l'ID su cui si imposta questo parametro.

id?: string

Valore della proprietà

string

imageContent

Filtrare le immagini in base ai tipi di contenuto seguenti. Viso: restituisce immagini che mostrano solo il viso di una persona. Ritratto: restituisce immagini che mostrano solo la testa e le spalle di una persona. I valori possibili includono: 'Face', 'Portrait'

imageContent?: ImageContent

Valore della proprietà

ImageContent

imageType

Filtrare le immagini in base ai tipi di immagine seguenti. AnimatedGif: restituisce solo GIF animate. Clipart: restituisce solo immagini clipart. Linea: restituisce solo disegni a linee. Foto: restituisce solo fotografie(esclusi disegni a linee, gif animate e clipart). Shopping: restituisce solo immagini contenenti elementi in cui Bing conosce un commerciante che vende gli articoli. Questa opzione è valida solo nel mercato en - Stati Uniti. Trasparente: restituisce solo immagini con sfondo trasparente. I valori possibili includono: 'AnimatedGif', 'Clipart', 'Line', 'Photo', 'Shopping', 'Transparent'

imageType?: ImageType

Valore della proprietà

ImageType

license

Filtrare le immagini in base ai tipi di licenza seguenti. Tutto: non filtrare in base al tipo di licenza. Specificare questo valore equivale a non specificare il parametro license. Any: restituisce immagini con qualsiasi tipo di licenza. La risposta non include immagini che non specificano una licenza o la licenza è sconosciuta. Pubblico: restituisce immagini in cui l'autore ha rinunciato ai propri diritti esclusivi, nella misura massima consentita dalla legge. Condividi: restituisce immagini che possono essere condivise con altri utenti. La modifica o la modifica dell'immagine potrebbero non essere consentite. Inoltre, la modifica, la condivisione e l'uso dell'immagine per scopi commerciali potrebbero non essere consentiti. In genere, questa opzione restituisce la maggior parte delle immagini. ShareCommercially: restituisce immagini che possono essere condivise con altri utenti per scopi personali o commerciali. La modifica o la modifica dell'immagine potrebbero non essere consentite. Modifica: restituisce immagini che possono essere modificate, condivise e usate. La modifica o la modifica dell'immagine potrebbero non essere consentite. La modifica, la condivisione e l'uso dell'immagine per scopi commerciali potrebbero non essere consentiti. ModifyCommercially: restituisce immagini che possono essere modificate, condivise e usate per scopi personali o commerciali. In genere, questa opzione restituisce le immagini più poche. Per altre informazioni su questi tipi di licenza, vedere Filtrare le immagini in base al tipo di licenza. I valori possibili includono: 'All', 'Any', 'Public', 'Share', 'ShareCommercially', 'Modify', 'ModifyCommercially'

license?: ImageLicense

Valore della proprietà

ImageLicense

location

Elenco delimitato da punto e virgola di coppie chiave/valore che descrivono la posizione geografica del client. Bing usa le informazioni sulla posizione per determinare il comportamento di ricerca sicuro e per restituire il contenuto locale pertinente. Specificare la coppia chiave/valore come chiave <>:<valore>. Di seguito sono riportate le chiavi usate per specificare la posizione dell'utente. lat (obbligatorio): latitudine della posizione del client, espressa in gradi. La latitudine deve essere maggiore o uguale a -90,0 e minore o uguale a +90,0. I valori negativi indicano le latitudine meridionali e i valori positivi indicano le latitudine settentrionali. long (obbligatorio): longitudine della posizione del client, espressa in gradi. La longitudine deve essere maggiore o uguale a -180,0 e minore o uguale a +180,0. I valori negativi indicano longitudini occidentali e valori positivi indicano longitudini orientali. re (obbligatorio): raggio, in metri, che specifica l'accuratezza orizzontale delle coordinate. Passare il valore restituito dal servizio di posizione del dispositivo. I valori tipici potrebbero essere 22m per GPS/Wi-Fi, 380m per la triangolazione della torre cellulare e 18.000m per la ricerca IP inversa. ts (facoltativo): timestamp UNIX UTC di quando il client si trovava nella posizione. Il timestamp UNIX è il numero di secondi dal 1° gennaio 1970. head (facoltativo): direzione o direzione di viaggio del cliente. Specificare la direzione di viaggio come gradi compreso tra 0 e 360, contando in senso orario rispetto a true nord. Specificare questa chiave solo se la chiave sp è diversa da zero. sp (facoltativo): velocità orizzontale (velocità), in metri al secondo, che il dispositivo client sta viaggiando. alt (facoltativo): altitudine del dispositivo client, in metri. sono (facoltativo): raggio, in metri, che specifica l'accuratezza verticale delle coordinate. Specificare questo tasto solo se si specifica il tasto ALT. Anche se molte delle chiavi sono facoltative, più informazioni vengono fornite, più accurati sono i risultati della posizione. Anche se facoltativo, è consigliabile specificare sempre la posizione geografica dell'utente. Fornire la posizione è particolarmente importante se l'indirizzo IP del client non riflette in modo accurato la posizione fisica dell'utente ( ad esempio, se il client usa VPN). Per ottenere risultati ottimali, è necessario includere questa intestazione e l'intestazione X-MSEdge-ClientIP, ma almeno è necessario includere questa intestazione.

location?: string

Valore della proprietà

string

market

Il mercato da cui provengono i risultati. In genere, mkt è il paese in cui l'utente effettua la richiesta. Tuttavia, potrebbe trattarsi di un paese diverso se l'utente non si trova in un paese in cui Bing fornisce risultati. Il mercato deve essere nella forma <codice> lingua-codice<> paese. Ad esempio, en-US. La stringa non fa distinzione tra maiuscole e minuscole. Per un elenco dei possibili valori di mercato, vedere Market Codes. NOTA: se noto, si consiglia di specificare sempre il mercato. Specificare il mercato consente a Bing di indirizzare la richiesta e restituire una risposta appropriata e ottimale. Se si specifica un mercato non elencato in codici di mercato, Bing usa un codice di mercato più adatto in base a un mapping interno soggetto a modifiche. Questo parametro e il cc parametro di query si escludono a vicenda, non specificano entrambi.

market?: string

Valore della proprietà

string

maxFileSize

Filtrare le immagini minori o uguali alle dimensioni del file specificate. Le dimensioni massime del file che è possibile specificare sono 520.192 byte. Se si specifica un valore maggiore, l'API usa 520.192. È possibile che la risposta includa immagini leggermente superiori al valore massimo specificato. È possibile specificare questo filtro e minFileSize per filtrare le immagini all'interno di un intervallo di dimensioni del file.

maxFileSize?: number

Valore della proprietà

number

maxHeight

Filtrare le immagini con un'altezza minore o uguale all'altezza specificata. Specificare l'altezza in pixel. È possibile specificare questo filtro e minHeight per filtrare le immagini all'interno di un intervallo di altezze. Questo filtro e il filtro altezza si escludono a vicenda.

maxHeight?: number

Valore della proprietà

number

maxWidth

Filtrare le immagini con una larghezza minore o uguale alla larghezza specificata. Specificare la larghezza in pixel. È possibile specificare questo filtro e maxWidth per filtrare le immagini all'interno di un intervallo di larghezze. Questo filtro e il filtro di larghezza si escludono a vicenda.

maxWidth?: number

Valore della proprietà

number

minFileSize

Filtrare le immagini maggiori o uguali alle dimensioni del file specificate. Le dimensioni massime del file che è possibile specificare sono 520.192 byte. Se si specifica un valore maggiore, l'API usa 520.192. È possibile che la risposta includa immagini leggermente inferiori al minimo specificato. È possibile specificare questo filtro e maxFileSize per filtrare le immagini all'interno di un intervallo di dimensioni del file.

minFileSize?: number

Valore della proprietà

number

minHeight

Filtrare le immagini con un'altezza maggiore o uguale all'altezza specificata. Specificare l'altezza in pixel. È possibile specificare questo filtro e maxHeight per filtrare le immagini all'interno di un intervallo di altezze. Questo filtro e il filtro altezza si escludono a vicenda.

minHeight?: number

Valore della proprietà

number

minWidth

Filtrare le immagini con una larghezza maggiore o uguale alla larghezza specificata. Specificare la larghezza in pixel. È possibile specificare questo filtro e maxWidth per filtrare le immagini all'interno di un intervallo di larghezze. Questo filtro e il filtro di larghezza si escludono a vicenda.

minWidth?: number

Valore della proprietà

number

offset

Offset in base zero che indica il numero di immagini da ignorare prima di restituire immagini. Il valore predefinito è 0. L'offset deve essere minore di (totalEstimatedMatches

  • conteggio). Usare questo parametro insieme al parametro count per visualizzare i risultati della pagina. Ad esempio, se l'interfaccia utente visualizza 20 immagini per pagina, impostare count su 20 e offset su 0 per ottenere la prima pagina dei risultati. Per ogni pagina successiva, l'offset di incremento di 20 (ad esempio, 0, 20, 40). È possibile che più pagine includano alcune sovrapposizioni nei risultati. Per evitare duplicati, vedere nextOffset. Usare questo parametro solo con l'API Image. Non specificare questo parametro quando si chiama l'API Immagini di tendenza o l'API Ricerca Web.
offset?: number

Valore della proprietà

number

safeSearch

Filtrare le immagini per il contenuto per adulti. Di seguito sono riportati i possibili valori di filtro. Disattivato: può restituire immagini con contenuto per adulti. Se la richiesta viene eseguita tramite l'API Ricerca immagini, la risposta include immagini di anteprima non crittografate (non fuzzy). Tuttavia, se la richiesta è tramite l'API Ricerca Web, la risposta include immagini di anteprima pixelate (fuzzy). Moderate: se la richiesta è tramite l'API Ricerca immagini, la risposta non include immagini con contenuto per adulti. Se la richiesta è tramite l'API Ricerca Web, la risposta può includere immagini con contenuto per adulti (le immagini di anteprima vengono pixelate (fuzzy)). Strict: non restituire immagini con contenuto per adulti. Il valore predefinito è Moderate. Se la richiesta proviene da un mercato che i criteri per adulti di Bing richiedono che safeSearch sia impostato su Strict, Bing ignora il valore safeSearch e usa Strict. Se si usa l'operatore site: query, è possibile che la risposta contenga contenuto per adulti indipendentemente dal parametro di query safeSearch impostato su. Usa sito: solo se si è a conoscenza del contenuto nel sito e lo scenario supporta la possibilità di contenuto per adulti. I valori possibili includono: 'Off', 'Moderate', 'Strict'

safeSearch?: SafeSearch

Valore della proprietà

SafeSearch

setLang

Lingua da usare per le stringhe dell'interfaccia utente. Specificare la lingua usando il codice di lingua ISO 639-1 a 2 lettere. Ad esempio, il codice della lingua per l'inglese è EN. Il valore predefinito è EN (inglese). Anche se facoltativo, è consigliabile specificare sempre la lingua. In genere, si imposta setLang sulla stessa lingua specificata da mkt, a meno che l'utente non voglia visualizzare le stringhe dell'interfaccia utente in una lingua diversa. Questo parametro e l'intestazione accept-language si escludono a vicenda; non specificare entrambi. Una stringa dell'interfaccia utente è una stringa usata come etichetta in un'interfaccia utente. Esistono poche stringhe dell'interfaccia utente negli oggetti risposta JSON. Inoltre, tutti i collegamenti alle proprietà Bing.com negli oggetti risposta applicano la lingua specificata.

setLang?: string

Valore della proprietà

string

size

Filtrare le immagini in base alle dimensioni seguenti. Tutto: non filtrare in base alle dimensioni. Specificare questo valore equivale a non specificare il parametro size. Piccolo: restituisce immagini inferiori a 200x200 pixel. Medio: restituisce immagini maggiori o uguali a 200x200 pixel, ma inferiori a 500x500 pixel. Grande: restituisce immagini di dimensioni maggiori o maggiori di 500x500 pixel. Sfondo: restituisce immagini di sfondo. È possibile usare questo parametro insieme ai parametri height o width. Ad esempio, è possibile usare altezza e dimensioni per richiedere immagini di piccole dimensioni di 150 pixel di altezza. I valori possibili includono: 'All', 'Small', 'Medium', 'Large', 'Wallpaper'

size?: ImageSize

Valore della proprietà

ImageSize

userAgent

Agente utente che ha origine la richiesta. Bing usa l'agente utente per offrire agli utenti mobili un'esperienza ottimizzata. Anche se facoltativo, è consigliabile specificare sempre questa intestazione. L'agente utente deve essere la stessa stringa inviata da qualsiasi browser comunemente usato. Per informazioni sugli agenti utente, vedere RFC 2616. Di seguito sono riportati esempi di stringhe dell'agente utente. Windows Phone: Mozilla/5.0 (compatibile; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; BRACCIO; Toccare; NOKIA; Lumia 822). Android: Mozilla / 5.0 (Linux; U; Android 2.3.5; en - noi; SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; come Gecko) Versione / 4.0 Mobile Safari / 533.1. iPhone: Mozilla / 5.0 (iPhone; CPU iPhone OS 6_1 come Mac OS X) AppleWebKit / 536.26 (KHTML; come Gecko) Mobile / 10B142 iPhone4; 1 BingWeb / 3.03.1428.20120423. PC: Mozilla / 5.0 (Windows NT 6.3; WOW64; Trident / 7.0; Toccare; rv:11.0) come Gecko. iPad: Mozilla / 5.0 (iPad; CPU OS 7_0 come Mac OS X) AppleWebKit / 537.51.1 (KHTML, come Gecko) Versione / 7.0 Mobile / 11A465 Safari / 9537.53

userAgent?: string

Valore della proprietà

string

width

Filtra le immagini con la larghezza specificata, espressa in pixel. È possibile usare questo filtro con il filtro delle dimensioni per restituire immagini di piccole dimensioni con una larghezza di 150 pixel.

width?: number

Valore della proprietà

number

Dettagli proprietà ereditate

abortSignal

Segnale che può essere usato per interrompere le richieste.

abortSignal?: AbortSignalLike

Valore della proprietà

AbortSignalLike

Ereditato da msRest.RequestOptionsBase.abortSignal

customHeaders

Intestazioni di richiesta personalizzate definite dall'utente che verranno applicate prima dell'invio della richiesta.

customHeaders?: {[key: string]: string}

Valore della proprietà

{[key: string]: string}

Ereditato da msRest.RequestOptionsBase.customHeaders

onDownloadProgress

Callback che viene attivato all'avanzamento del download.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Valore della proprietà

(progress: TransferProgressEvent) => void

Ereditato da msRest.RequestOptionsBase.onDownloadProgress

onUploadProgress

Callback che viene attivato al momento dell'avanzamento del caricamento.

onUploadProgress?: (progress: TransferProgressEvent) => void

Valore della proprietà

(progress: TransferProgressEvent) => void

Ereditato da msRest.RequestOptionsBase.onUploadProgress

timeout

Numero di millisecondi che una richiesta può richiedere prima di essere terminata automaticamente.

timeout?: number

Valore della proprietà

number

ereditato da msRest.RequestOptionsBase.timeout