ImagesDetailsOptionalParams 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 imposti questa intestazione, devi 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.
clientId	Bing usa questa intestazione per fornire agli utenti un comportamento coerente tra le chiamate alle API di Bing. Bing lancia spesso nuove funzionalità e miglioramenti e utilizza l'ID client come chiave per l'assegnazione del traffico su diversi test. 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 volo 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 di Bing e a loro volta consentono tassi di clic più elevati per l'utente delle API. IMPORTANTE: anche se facoltativo, è consigliabile considerare questa intestazione obbligatoria. La persistenza dell'ID client tra più richieste per la stessa combinazione di utente finale e dispositivo consente al consumatore dell'API di ricevere un'esperienza utente coerente e tassi di click-through più elevati 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'unico momento in cui non devi includere questa intestazione in una richiesta è la prima volta che quell'utente usa la tua app su quel dispositivo. Usare l'ID client per ogni richiesta API Bing eseguita dall'app per questo utente nel dispositivo. Memorizzare l'ID cliente. 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 prossima volta che l'utente utilizza l'app su quel dispositivo, ottieni l'ID client che hai salvato. Le risposte Bing possono includere o meno questa intestazione. Se la risposta include questa intestazione, acquisisci l'ID cliente e usalo per tutte le richieste Bing successive per l'utente su quel 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.
contentType	Intestazione della richiesta facoltativa. Se si imposta il parametro di query modules su RecognizedEntities, è possibile specificare il file binario di un'immagine nel corpo di una richiesta POST. Se si specifica l'immagine nel corpo di una richiesta POST, è necessario specificare questa intestazione e impostarne il valore su multipart/form-data. La dimensione massima dell'immagine è di 1 MB.
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 di query mkt sono mutuamente esclusivi: non specificare entrambi.
cropBottom	La coordinata inferiore della regione da ritagliare. La coordinata è un valore frazionario dell'altezza dell'immagine originale e viene misurata dall'angolo superiore sinistro dell'immagine. Specificare la coordinata come valore compreso tra 0,0 e 1,0. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.
cropLeft	La coordinata sinistra della regione da ritagliare. La coordinata è un valore frazionario dell'altezza dell'immagine originale e viene misurata dall'angolo superiore sinistro dell'immagine. Specificare la coordinata come valore compreso tra 0,0 e 1,0. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.
cropRight	La coordinata corretta della regione da ritagliare. La coordinata è un valore frazionario dell'altezza dell'immagine originale e viene misurata dall'angolo superiore sinistro dell'immagine. Specificare la coordinata come valore compreso tra 0,0 e 1,0. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.
cropTop	La coordinata superiore della regione da ritagliare. La coordinata è un valore frazionario dell'altezza dell'immagine originale e viene misurata dall'angolo superiore sinistro dell'immagine. Specificare la coordinata come valore compreso tra 0,0 e 1,0. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.
cropType	Il tipo di ritaglio da utilizzare per il ritaglio dell'immagine in base alle coordinate specificate nei parametri cal, cat, car e cab. Di seguito sono riportati i valori possibili. 0: Rettangolare (impostazione predefinita). Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web. I valori possibili includono: 'Rettangolare'
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.
imageUrl	L'URL di un'immagine di cui si desidera ottenere informazioni. Utilizzare questo parametro in alternativa all'utilizzo del parametro insightsToken per specificare l'immagine. È inoltre possibile specificare l'immagine inserendo il file binario dell'immagine nel corpo di una richiesta POST. Se si utilizza l'opzione binaria, vedere l'intestazione Content-Type . La dimensione massima supportata dell'immagine è 1 MB. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.
insightsToken	Un token immagine. L'oggetto imageInsightsToken dell'oggetto Image contiene il token. Specifica questo parametro per ottenere ulteriori informazioni su un'immagine, ad esempio una didascalia o un'origine per gli acquisti. Per un elenco delle informazioni aggiuntive su un'immagine che è possibile ottenere, vedere il parametro di query modules . Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.
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 compresi tra 0 e 360, contando in senso orario rispetto al nord vero. 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 parametro di query cc si escludono a vicenda: non specificare entrambi.
modules	Elenco delimitato da virgole di informazioni dettagliate da richiedere. Di seguito sono riportati i possibili valori senza distinzione tra maiuscole e minuscole. All: restituisce tutte le informazioni dettagliate, se disponibili, ad eccezione di RecognizedEntities. BRQ: Query sul miglior rappresentante. Termine di query che meglio descrive l'immagine. Didascalia: una didascalia che fornisce informazioni sull'immagine. Se la didascalia contiene entità, la risposta può includere collegamenti a immagini di tali entità. Raccolte: un elenco di immagini correlate. Ricette: Un elenco di ricette per cucinare il cibo mostrato nelle immagini. PagesIncluding: un elenco di pagine Web che includono l'immagine. RecognizedEntities: elenco di entità (persone) riconosciute nell'immagine. NOTA: Non è possibile specificare questo modulo con altri moduli. Se lo si specifica con altri moduli, la risposta non include le entità riconosciute. RelatedSearches: un elenco di ricerche correlate effettuate da altri. ShoppingSources: un elenco di commercianti in cui è possibile acquistare offerte correlate. SimilarImages: un elenco di immagini visivamente simili all'immagine originale. SimilarProducts: un elenco di immagini che contengono un prodotto simile a un prodotto trovato nell'immagine originale. Tag: fornisce le caratteristiche del tipo di contenuto trovato nell'immagine. Ad esempio, se l'immagine è di una persona, i tag potrebbero indicare il sesso della persona e il tipo di vestiti che indossa. Se si specifica un modulo e non sono presenti dati per il modulo, l'oggetto risposta non include il campo correlato. Ad esempio, se si specifica Didascalia e non esiste, la risposta non include il campo imageCaption. Per includere ricerche correlate, la richiesta deve includere la stringa di query originale. Anche se la stringa di query originale non è necessaria per immagini o prodotti simili, è consigliabile includerla sempre perché può contribuire a migliorare la pertinenza e i risultati. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o 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.
userAgent	Agente utente che origina 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

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 imposti questa intestazione, devi 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

clientId

Bing usa questa intestazione per fornire agli utenti un comportamento coerente tra le chiamate alle API di Bing. Bing lancia spesso nuove funzionalità e miglioramenti e utilizza l'ID client come chiave per l'assegnazione del traffico su diversi test. 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 volo 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 di Bing e a loro volta consentono tassi di clic più elevati per l'utente delle API. IMPORTANTE: anche se facoltativo, è consigliabile considerare questa intestazione obbligatoria. La persistenza dell'ID client tra più richieste per la stessa combinazione di utente finale e dispositivo consente al consumatore dell'API di ricevere un'esperienza utente coerente e tassi di click-through più elevati 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'unico momento in cui non devi includere questa intestazione in una richiesta è la prima volta che quell'utente usa la tua app su quel dispositivo. Usare l'ID client per ogni richiesta API Bing eseguita dall'app per questo utente nel dispositivo. Memorizzare l'ID cliente. 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 prossima volta che l'utente utilizza l'app su quel dispositivo, ottieni l'ID client che hai salvato. Le risposte Bing possono includere o meno questa intestazione. Se la risposta include questa intestazione, acquisisci l'ID cliente e usalo per tutte le richieste Bing successive per l'utente su quel 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

contentType

Intestazione della richiesta facoltativa. Se si imposta il parametro di query modules su RecognizedEntities, è possibile specificare il file binario di un'immagine nel corpo di una richiesta POST. Se si specifica l'immagine nel corpo di una richiesta POST, è necessario specificare questa intestazione e impostarne il valore su multipart/form-data. La dimensione massima dell'immagine è di 1 MB.

contentType?: string

Valore della proprietà

string

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 di query mkt sono mutuamente esclusivi: non specificare entrambi.

countryCode?: string

Valore della proprietà

string

cropBottom

La coordinata inferiore della regione da ritagliare. La coordinata è un valore frazionario dell'altezza dell'immagine originale e viene misurata dall'angolo superiore sinistro dell'immagine. Specificare la coordinata come valore compreso tra 0,0 e 1,0. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.

cropBottom?: number

Valore della proprietà

number

cropLeft

La coordinata sinistra della regione da ritagliare. La coordinata è un valore frazionario dell'altezza dell'immagine originale e viene misurata dall'angolo superiore sinistro dell'immagine. Specificare la coordinata come valore compreso tra 0,0 e 1,0. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.

cropLeft?: number

Valore della proprietà

number

cropRight

La coordinata corretta della regione da ritagliare. La coordinata è un valore frazionario dell'altezza dell'immagine originale e viene misurata dall'angolo superiore sinistro dell'immagine. Specificare la coordinata come valore compreso tra 0,0 e 1,0. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.

cropRight?: number

Valore della proprietà

number

cropTop

La coordinata superiore della regione da ritagliare. La coordinata è un valore frazionario dell'altezza dell'immagine originale e viene misurata dall'angolo superiore sinistro dell'immagine. Specificare la coordinata come valore compreso tra 0,0 e 1,0. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.

cropTop?: number

Valore della proprietà

number

cropType

Il tipo di ritaglio da utilizzare per il ritaglio dell'immagine in base alle coordinate specificate nei parametri cal, cat, car e cab. Di seguito sono riportati i valori possibili. 0: Rettangolare (impostazione predefinita). Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web. I valori possibili includono: 'Rettangolare'

cropType?: "Rectangular"

Valore della proprietà

"Rectangular"

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

imageUrl

L'URL di un'immagine di cui si desidera ottenere informazioni. Utilizzare questo parametro in alternativa all'utilizzo del parametro insightsToken per specificare l'immagine. È inoltre possibile specificare l'immagine inserendo il file binario dell'immagine nel corpo di una richiesta POST. Se si utilizza l'opzione binaria, vedere l'intestazione Content-Type . La dimensione massima supportata dell'immagine è 1 MB. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.

imageUrl?: string

Valore della proprietà

string

insightsToken

Un token immagine. L'oggetto imageInsightsToken dell'oggetto Image contiene il token. Specifica questo parametro per ottenere ulteriori informazioni su un'immagine, ad esempio una didascalia o un'origine per gli acquisti. Per un elenco delle informazioni aggiuntive su un'immagine che è possibile ottenere, vedere il parametro di query modules . Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.

insightsToken?: string

Valore della proprietà

string

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 compresi tra 0 e 360, contando in senso orario rispetto al nord vero. 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 parametro di query cc si escludono a vicenda: non specificare entrambi.

market?: string

Valore della proprietà

string

modules

Elenco delimitato da virgole di informazioni dettagliate da richiedere. Di seguito sono riportati i possibili valori senza distinzione tra maiuscole e minuscole. All: restituisce tutte le informazioni dettagliate, se disponibili, ad eccezione di RecognizedEntities. BRQ: Query sul miglior rappresentante. Termine di query che meglio descrive l'immagine. Didascalia: una didascalia che fornisce informazioni sull'immagine. Se la didascalia contiene entità, la risposta può includere collegamenti a immagini di tali entità. Raccolte: un elenco di immagini correlate. Ricette: Un elenco di ricette per cucinare il cibo mostrato nelle immagini. PagesIncluding: un elenco di pagine Web che includono l'immagine. RecognizedEntities: elenco di entità (persone) riconosciute nell'immagine. NOTA: Non è possibile specificare questo modulo con altri moduli. Se lo si specifica con altri moduli, la risposta non include le entità riconosciute. RelatedSearches: un elenco di ricerche correlate effettuate da altri. ShoppingSources: un elenco di commercianti in cui è possibile acquistare offerte correlate. SimilarImages: un elenco di immagini visivamente simili all'immagine originale. SimilarProducts: un elenco di immagini che contengono un prodotto simile a un prodotto trovato nell'immagine originale. Tag: fornisce le caratteristiche del tipo di contenuto trovato nell'immagine. Ad esempio, se l'immagine è di una persona, i tag potrebbero indicare il sesso della persona e il tipo di vestiti che indossa. Se si specifica un modulo e non sono presenti dati per il modulo, l'oggetto risposta non include il campo correlato. Ad esempio, se si specifica Didascalia e non esiste, la risposta non include il campo imageCaption. Per includere ricerche correlate, la richiesta deve includere la stringa di query originale. Anche se la stringa di query originale non è necessaria per immagini o prodotti simili, è consigliabile includerla sempre perché può contribuire a migliorare la pertinenza e i risultati. Utilizza questo parametro solo con l'API Insights. Non specificare questo parametro quando si chiamano le API Images, Trending Images o Ricerca Web.

modules?: ImageInsightModule[]

Valore della proprietà

ImageInsightModule[]

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

userAgent

Agente utente che origina 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

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