ImagesExtensions.VisualSearchMethodAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| VisualSearchMethodAsync(IImages, String, String, String, String, String, String, String, String, String, VisualSearchRequest, Stream, CancellationToken) |
Image Visual Search API permite enviar una imagen a Bing y obtener una lista de etiquetas pertinentes. Cada etiqueta contiene posibles acciones en las que un usuario podría estar interesado. En esta sección se proporcionan detalles técnicos sobre el formato de solicitud y los encabezados que se usan para solicitar acciones y los objetos de respuesta JSON que los contienen. Para obtener ejemplos que muestran cómo realizar solicitudes, vea Buscar en la Web para imágenes. |
| VisualSearchMethodAsync(IImages, String, String, String, String, String, String, String, String, String, String, Stream, CancellationToken) |
Visual Search API le permite descubrir información sobre una imagen, como imágenes visualmente similares, orígenes de compras y búsquedas relacionadas. La API también puede realizar el reconocimiento de texto, identificar entidades (personas, lugares, cosas), devolver otro contenido temático para que el usuario explore, etc. Para obtener más información, vea Información general de Visual Search. |
VisualSearchMethodAsync(IImages, String, String, String, String, String, String, String, String, String, VisualSearchRequest, Stream, CancellationToken)
Image Visual Search API le permite enviar una imagen a Bing y obtener una lista de etiquetas pertinentes. Cada etiqueta contiene posibles acciones en las que puede interesar un usuario. En esta sección se proporcionan detalles técnicos sobre el formato de solicitud y los encabezados que se usan para solicitar acciones y los objetos de respuesta JSON que los contienen. Para obtener ejemplos que muestran cómo realizar solicitudes, vea Buscar en la Web for Images.
public static System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge> VisualSearchMethodAsync (this Microsoft.Azure.CognitiveServices.Search.VisualSearch.IImages operations, string acceptLanguage = default, string contentType = default, string userAgent = default, string clientId = default, string clientIp = default, string location = default, string market = default, string safeSearch = default, string setLang = default, Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.VisualSearchRequest knowledgeRequest = default, System.IO.Stream image = default, System.Threading.CancellationToken cancellationToken = default);static member VisualSearchMethodAsync : Microsoft.Azure.CognitiveServices.Search.VisualSearch.IImages * string * string * string * string * string * string * string * string * string * Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.VisualSearchRequest * System.IO.Stream * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge><Extension()>
Public Function VisualSearchMethodAsync (operations As IImages, Optional acceptLanguage As String = Nothing, Optional contentType As String = Nothing, Optional userAgent As String = Nothing, Optional clientId As String = Nothing, Optional clientIp As String = Nothing, Optional location As String = Nothing, Optional market As String = Nothing, Optional safeSearch As String = Nothing, Optional setLang As String = Nothing, Optional knowledgeRequest As VisualSearchRequest = Nothing, Optional image As Stream = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ImageKnowledge)Parámetros
- operations
- IImages
El grupo de operaciones de este método de extensión.
- acceptLanguage
- String
Lista delimitada por comas de uno o varios idiomas que se van a usar para las cadenas de la interfaz de usuario. La lista se muestra en orden de preferencia decreciente. Para obtener más información, incluido el formato esperado, consulte RFC2616. Este encabezado y el parámetro de consulta setLang son mutuamente excluyentes; no especifique ambos. Si establece este encabezado, debe especificar también el parámetro de consulta cc. Para determinar el mercado para el que se devuelven los resultados, Bing usa el primer idioma admitido que encuentra en la lista y lo combina con el valor del parámetro cc. Si la lista no incluye ningún idioma compatible, Bing busca el idioma y el mercado más cercanos que admiten la solicitud, o bien usa un mercado agregado o predeterminado para los resultados. Para determinar el mercado que usó Bing, consulte el encabezado BingAPIs-Market. Use este encabezado y el parámetro de consulta cc solo si especifica varios idiomas. En caso contrario, use los parámetros de consulta mkt y setLang. Una cadena de interfaz de usuario es aquella que se usa como etiqueta en una interfaz de usuario. Hay pocas cadenas de interfaz de usuario en los objetos de respuesta JSON. Todos los vínculos a las propiedades de Bing.com en los objetos de respuesta aplican el idioma especificado.
- contentType
- String
Encabezado de solicitud opcional. Si establece el parámetro de consulta modules en RecognizeEntities, puede especificar el binario de una imagen en el cuerpo de una solicitud POST. Si especifica la imagen en el cuerpo de una solicitud POST, debe especificar este encabezado y establecer su valor en multipart/form-data. El tamaño máximo de la imagen es de 1 MB.
- userAgent
- String
El agente de usuario que origina la solicitud. Bing usa el agente de usuario para proporcionar a los usuarios de dispositivos móviles una experiencia optimizada. Aunque es opcional, se recomienda especificar siempre este encabezado. El agente de usuario debe ser la misma cadena que envían los exploradores que más se usan. Para obtener información sobre los agentes de usuario, consulte RFC 2616. A continuación se muestran ejemplos de cadenas de agente de usuario. Windows Phone: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; BRAZO; Tocar; NOKIA; Lumia 822). Android: Mozilla / 5.0 (Linux; U; Android 2.3.5; en - nosotros; SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; like Gecko) Version / 4.0 Mobile Safari / 533.1. iPhone: Mozilla / 5.0 (iPhone; CPU iPhone OS 6_1 like Mac OS X) AppleWebKit / 536.26 (KHTML; like Gecko) Mobile / 10B142 iPhone4; 1 BingWeb/ 3.03.1428.20120423. PC: Mozilla / 5.0 (Windows NT 6.3; WOW64; Trident / 7.0; Tocar; rv:11.0) como Gecko. iPad: Mozilla / 5.0 (iPad; CPU OS 7_0 como Mac OS X) AppleWebKit / 537.51.1 (KHTML, como Gecko) Versión / 7.0 Mobile / 11A465 Safari / 9537.53
- clientId
- String
Bing usa este encabezado para proporcionar a los usuarios un comportamiento coherente en las llamadas API de Bing. Bing incorpora a menudo mejoras y características piloto nuevas, y usa el identificador de cliente como clave para asignar el tráfico en distintos paquetes piloto. Si no usa el mismo identificador de cliente para un usuario en varias solicitudes, Bing puede asignar el usuario a varios paquetes piloto en conflicto. La asignación a varios paquetes piloto en conflicto puede generar una experiencia de usuario incoherente. Por ejemplo, si la segunda solicitud tiene una asignación de paquete piloto distinta de la primera, puede que se produzca una experiencia inesperada. Además, Bing puede usar el identificador de cliente para personalizar los resultados web en el historial de búsqueda del identificador de cliente, lo que proporciona una experiencia enriquecida para el usuario. Bing también utiliza este encabezado para ayudar a mejorar las clasificaciones de resultados mediante el análisis de la actividad que genera un identificador de cliente. Las mejoras de relevancia ayudan con una mayor calidad de los resultados que devuelven las API de Bing y, a su vez, permiten un mayor porcentaje de clics para el consumidor de la API. IMPORTANTE: Aunque es opcional, considere este encabezado como obligatorio. Conservar el identificador de cliente en varias solicitudes para la misma combinación de usuario final y dispositivo permite 1) que el consumidor de API reciba una experiencia de usuario coherente y 2) un mayor porcentaje de clics a través de una mejor calidad de los resultados de las API de Bing. Cada usuario que utiliza la aplicación en el dispositivo debe tener un identificador de cliente único generado por Bing. Si no incluye este encabezado en la solicitud, Bing genera un identificador y lo devuelve en el encabezado de respuesta X-MSEdge-ClientID. La única ocasión en que NO debe incluir este encabezado en una solicitud es la primera vez que el usuario usa la aplicación en el dispositivo. Use el identificador de cliente para cada solicitud de API de Bing que haga la aplicación para este usuario en el dispositivo. Conserve el identificador de cliente. Para conservar el identificador en una aplicación de explorador, use una cookie HTTP persistente para asegurarse de que se use ese identificador en todas las sesiones. No use una cookie de sesión. Para otras aplicaciones, como aplicaciones móviles, use el almacenamiento persistente del dispositivo para conservar el identificador. La próxima vez que el usuario use la aplicación en ese dispositivo, obtenga el identificador de cliente que conservó. Las respuestas de Bing pueden incluir este encabezado o no incluirlo. Si la respuesta incluye este encabezado, capture el identificador de cliente y úselo para todas las solicitudes posteriores de Bing del usuario en dicho dispositivo. Si incluye X-MSEdge-ClientID, no debe incluir cookies en la solicitud.
- clientIp
- String
Dirección IPv4 o IPv6 del dispositivo cliente. La dirección IP se usa para detectar la ubicación del usuario. Bing usa la información de ubicación para determinar el comportamiento de la búsqueda segura. Aunque es opcional, se recomienda especificar siempre tanto este encabezado como el encabezado X-Search-Location. No ofusque la dirección (por ejemplo, cambiando el último octeto a 0). Al ofuscar los resultados de dirección, la ubicación no se encuentra cerca de la ubicación real, lo que puede provocar que Bing devuelva resultados erróneos.
- location
- String
Una lista delimitada por punto y coma de pares clave-valor que describen la ubicación geográfica del cliente. Bing usa la información de ubicación para determinar el comportamiento de la búsqueda segura y devolver contenido local apropiado. Especifique el par clave-valor como <clave>:<valor>. A continuación se incluyen las claves que usan para especificar la ubicación del usuario. lat (obligatorio): latitud de la ubicación del cliente, en grados. La latitud debe ser mayor o igual que -90.0, y menor o igual que +90.0. Los valores negativos indican latitudes del sur, mientras que los valores positivos indican latitudes del norte. long (obligatorio): longitud de la ubicación del cliente, en grados. La longitud debe ser mayor o igual que -180.0, y menor o igual que +180.0. Los valores negativos indican longitudes del oeste, mientras que los valores positivos indican longitudes del este. re (obligatorio): radio, en metros, que especifica la precisión horizontal de las coordenadas. Pase el valor que devuelve el servicio de ubicación del dispositivo. Los valores típicos pueden ser 22 m para GPS/Wi-Fi, 380 m para la triangulación de antenas repetidoras de telefonía móvil y 18 000 m para la búsqueda inversa de IP. ts (opcional): la marca de tiempo DE UNIX UTC de cuando el cliente estaba en la ubicación. (La marca de tiempo de UNIX es el número de segundos desde el 1 de enero de 1970). head (opcional): el encabezado relativo o la dirección del viaje del cliente. Especifique la dirección de desplazamiento como grados de 0 a 360, en la dirección de las agujas del reloj con respecto al norte verdadero. Especifique esta clave solo si la clave sp es distinta de cero. sp (opcional): velocidad horizontal (velocidad), en metros por segundo, que el dispositivo cliente está viajando. alt (opcional): altitud del dispositivo cliente, en metros. are (opcional): el radio, en metros, que especifica la precisión vertical de las coordenadas. Especifique esta clave solo si especifica la tecla alt. Aunque muchas de las claves son opcionales, cuanta más información proporcione, más precisos serán los resultados de ubicación. Aunque es opcional, se recomienda especificar siempre la ubicación geográfica del usuario. Proporcionar la ubicación es especialmente importante si la dirección IP del cliente no refleja con precisión la ubicación física del usuario (por ejemplo, si el cliente utiliza VPN). Para obtener resultados óptimos, debería incluir tanto este encabezado como X-MSEdge-ClientIP pero, como mínimo, debe incluir este.
- market
- String
Mercado de dónde proceden los resultados. Normalmente, mkt es el país desde el que el usuario realiza la solicitud. Sin embargo, podría ser un país diferente si el usuario no se encuentra en un país donde Bing ofrece resultados. El mercado debe estar en el <código> de país>< del código de idioma. Por ejemplo, en-US. La cadena no distingue mayúsculas de minúsculas. Para obtener una lista de posibles valores de mercado, consulte Códigos de mercado. NOTA: Si se conoce, se recomienda especificar siempre el mercado. Especificar el mercado ayuda a Bing a enrutar la solicitud y devolver una respuesta adecuada y óptima. Si especifica un mercado que no aparece en Códigos de mercado, Bing usa un código de mercado adecuado basado en una asignación interna que está sujeta a cambios.
- safeSearch
- String
Filtre los resultados de la imagen en acciones con el tipo "VisualSearch" para contenido para adultos. A continuación se muestran los valores de filtro posibles. Desactivado: puede devolver imágenes con contenido para adultos. Moderado: No devuelva imágenes con contenido para adultos. Estricto: No devuelva imágenes con contenido para adultos. El valor predeterminado es Moderado. Si la solicitud procede de un mercado que la directiva para adultos de Bing requiere que safeSearch esté establecido en Strict, Bing omite el valor safeSearch y usa Strict. Si usa el sitio: filtro en la solicitud de conocimiento, existe la posibilidad de que la respuesta contenga contenido para adultos, independientemente de cuál sea el parámetro de consulta safeSearch establecido en. Sitio de uso: solo si conoce el contenido en el sitio y su escenario admite la posibilidad de contenido para adultos. Entre los valores posibles se incluyen: "Off", "Moderate", "Strict"
- setLang
- String
Idioma que se usará para las cadenas de la interfaz de usuario. Especifique el idioma con el código ISO 639-1 de 2 letras. Por ejemplo, el código de idioma de inglés es EN. El valor predeterminado es EN (inglés). Aunque sea opcional, siempre debe especificar el idioma. Normalmente, establece setLang en el mismo idioma especificado por mkt a menos que el usuario quiera que las cadenas de la interfaz de usuario se muestren en un idioma diferente. Una cadena de interfaz de usuario es aquella que se usa como etiqueta en una interfaz de usuario. Hay pocas cadenas de interfaz de usuario en los objetos de respuesta JSON. Además, los vínculos a las propiedades de Bing.com de los objetos de respuesta aplican el idioma especificado.
- knowledgeRequest
- VisualSearchRequest
Objeto JSON que contiene información sobre la imagen. Los campos image e imageInsightsToken son mutuamente excluyentes; el cuerpo de la solicitud debe incluir solo uno de ellos.
- image
- Stream
Archivo de imagen cargado. El tamaño de la imagen está limitado a 1 MB y el nombre de archivo debe ser "image". Los campos image e imageInsightsToken son mutuamente excluyentes; el cuerpo de la solicitud debe incluir solo uno de ellos.
- cancellationToken
- CancellationToken
Token de cancelación.
Devoluciones
Se aplica a
VisualSearchMethodAsync(IImages, String, String, String, String, String, String, String, String, String, String, Stream, CancellationToken)
Visual Search API le permite descubrir información sobre una imagen, como imágenes visualmente similares, orígenes de compras y búsquedas relacionadas. La API también puede realizar el reconocimiento de texto, identificar entidades (personas, lugares, cosas), devolver otro contenido temático para que el usuario explore, etc. Para obtener más información, vea Información general de Visual Search.
public static System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge> VisualSearchMethodAsync (this Microsoft.Azure.CognitiveServices.Search.VisualSearch.IImages operations, string acceptLanguage = default, string contentType = default, string userAgent = default, string clientId = default, string clientIp = default, string location = default, string market = default, string safeSearch = default, string setLang = default, string knowledgeRequest = default, System.IO.Stream image = default, System.Threading.CancellationToken cancellationToken = default);static member VisualSearchMethodAsync : Microsoft.Azure.CognitiveServices.Search.VisualSearch.IImages * string * string * string * string * string * string * string * string * string * string * System.IO.Stream * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models.ImageKnowledge><Extension()>
Public Function VisualSearchMethodAsync (operations As IImages, Optional acceptLanguage As String = Nothing, Optional contentType As String = Nothing, Optional userAgent As String = Nothing, Optional clientId As String = Nothing, Optional clientIp As String = Nothing, Optional location As String = Nothing, Optional market As String = Nothing, Optional safeSearch As String = Nothing, Optional setLang As String = Nothing, Optional knowledgeRequest As String = Nothing, Optional image As Stream = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ImageKnowledge)Parámetros
- operations
- IImages
Grupo de operaciones para este método de extensión.
- acceptLanguage
- String
Lista delimitada por comas de uno o varios idiomas que se usarán para las cadenas de la interfaz de usuario. La lista se muestra en orden de preferencia decreciente. Para obtener más información, incluido el formato esperado, consulte RFC2616. Este encabezado y el parámetro de consulta setLang son mutuamente excluyentes; no especifique ambos. Si establece este encabezado, debe especificar también el parámetro de consulta cc. Para determinar el mercado para el que se devuelven los resultados, Bing usa el primer idioma admitido que encuentra en la lista y lo combina con el valor del parámetro cc. Si la lista no incluye ningún idioma compatible, Bing busca el idioma y el mercado más cercanos que admiten la solicitud, o bien usa un mercado agregado o predeterminado para los resultados. Para determinar el mercado que usó Bing, consulte el encabezado BingAPIs-Market. Use este encabezado y el parámetro de consulta cc solo si especifica varios idiomas. En caso contrario, use los parámetros de consulta mkt y setLang. Una cadena de interfaz de usuario es aquella que se usa como etiqueta en una interfaz de usuario. Hay pocas cadenas de interfaz de usuario en los objetos de respuesta JSON. Todos los vínculos a las propiedades de Bing.com en los objetos de respuesta aplican el idioma especificado.
- contentType
- String
Debe establecerse en multipart/form-data e incluir un parámetro de límite (por ejemplo, multipart/form-data; boundary=<cadena de límite>). Para obtener más información, consulte Tipos de formulario de contenido.
- userAgent
- String
El agente de usuario que origina la solicitud. Bing usa el agente de usuario para proporcionar a los usuarios de dispositivos móviles una experiencia optimizada. Aunque es opcional, se recomienda especificar siempre este encabezado. El agente de usuario debe ser la misma cadena que envían los exploradores que más se usan. Para obtener información sobre los agentes de usuario, consulte RFC 2616. A continuación se muestran ejemplos de cadenas de agente de usuario. Windows Phone: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; BRAZO; Tocar; NOKIA; Lumia 822). Android: Mozilla / 5.0 (Linux; U; Android 2.3.5; en - nosotros; SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; like Gecko) Version / 4.0 Mobile Safari / 533.1. iPhone: Mozilla / 5.0 (iPhone; CPU iPhone OS 6_1 como Mac OS X) AppleWebKit / 536.26 (KHTML; como Gecko) Mobile / 10B142 iPhone4; 1 BingWeb/ 3.03.1428.20120423. PC: Mozilla / 5.0 (Windows NT 6.3; WOW64; Trident / 7.0; Tocar; rv:11.0) como Gecko. iPad: Mozilla / 5.0 (iPad; CPU OS 7_0 como Mac OS X) AppleWebKit / 537.51.1 (KHTML, como Gecko) Versión / 7.0 Mobile / 11A465 Safari / 9537.53.
- clientId
- String
Bing usa este encabezado para proporcionar a los usuarios un comportamiento coherente en las llamadas API de Bing. Bing incorpora a menudo mejoras y características piloto nuevas, y usa el identificador de cliente como clave para asignar el tráfico en distintos paquetes piloto. Si no usa el mismo identificador de cliente para un usuario en varias solicitudes, Bing puede asignar el usuario a varios paquetes piloto en conflicto. La asignación a varios paquetes piloto en conflicto puede generar una experiencia de usuario incoherente. Por ejemplo, si la segunda solicitud tiene una asignación de paquete piloto distinta de la primera, puede que se produzca una experiencia inesperada. Además, Bing puede usar el identificador de cliente para personalizar los resultados web en el historial de búsqueda del identificador de cliente, lo que proporciona una experiencia enriquecida para el usuario. Bing también utiliza este encabezado para ayudar a mejorar las clasificaciones de resultados mediante el análisis de la actividad que genera un identificador de cliente. Las mejoras de relevancia ayudan con una mayor calidad de los resultados que devuelven las API de Bing y, a su vez, permiten un mayor porcentaje de clics para el consumidor de la API. IMPORTANTE: Aunque es opcional, considere este encabezado como obligatorio. Conservar el identificador de cliente en varias solicitudes para la misma combinación de usuario final y dispositivo permite 1) que el consumidor de API reciba una experiencia de usuario coherente y 2) un mayor porcentaje de clics a través de una mejor calidad de los resultados de las API de Bing. Cada usuario que utiliza la aplicación en el dispositivo debe tener un identificador de cliente único generado por Bing. Si no incluye este encabezado en la solicitud, Bing genera un identificador y lo devuelve en el encabezado de respuesta X-MSEdge-ClientID. La única ocasión en que NO debe incluir este encabezado en una solicitud es la primera vez que el usuario usa la aplicación en el dispositivo. Use el identificador de cliente para cada solicitud de API de Bing que haga la aplicación para este usuario en el dispositivo. Conserve el identificador de cliente. Para conservar el identificador en una aplicación de explorador, use una cookie HTTP persistente para asegurarse de que se use ese identificador en todas las sesiones. No use una cookie de sesión. Para otras aplicaciones, como aplicaciones móviles, use el almacenamiento persistente del dispositivo para conservar el identificador. La próxima vez que el usuario use la aplicación en ese dispositivo, obtenga el identificador de cliente que conservó. Las respuestas de Bing pueden incluir este encabezado o no incluirlo. Si la respuesta incluye este encabezado, capture el identificador de cliente y úselo para todas las solicitudes posteriores de Bing del usuario en dicho dispositivo. ATENCIÓN: debe asegurarse de que este identificador de cliente no se pueda vincular a la información de cualquier cuenta de usuario autenticable. Si incluye X-MSEdge-ClientID, no debe incluir cookies en la solicitud.
- clientIp
- String
Dirección IPv4 o IPv6 del dispositivo cliente. La dirección IP se usa para detectar la ubicación del usuario. Bing usa la información de ubicación para determinar el comportamiento de la búsqueda segura. Aunque es opcional, se recomienda especificar siempre tanto este encabezado como el encabezado X-Search-Location. No ofusque la dirección (por ejemplo, cambiando el último octeto a 0). Al ofuscar los resultados de dirección, la ubicación no se encuentra cerca de la ubicación real, lo que puede provocar que Bing devuelva resultados erróneos.
- location
- String
Una lista delimitada por punto y coma de pares clave-valor que describen la ubicación geográfica del cliente. Bing usa la información de ubicación para determinar el comportamiento de la búsqueda segura y devolver contenido local apropiado. Especifique el par clave-valor como <clave>:<valor>. A continuación se incluyen las claves que usan para especificar la ubicación del usuario. lat (obligatorio): latitud de la ubicación del cliente, en grados. La latitud debe ser mayor o igual que -90.0, y menor o igual que +90.0. Los valores negativos indican latitudes del sur, mientras que los valores positivos indican latitudes del norte. long (obligatorio): longitud de la ubicación del cliente, en grados. La longitud debe ser mayor o igual que -180.0, y menor o igual que +180.0. Los valores negativos indican longitudes del oeste, mientras que los valores positivos indican longitudes del este. re (obligatorio): radio, en metros, que especifica la precisión horizontal de las coordenadas. Pase el valor que devuelve el servicio de ubicación del dispositivo. Los valores típicos pueden ser 22 m para GPS/Wi-Fi, 380 m para la triangulación de antenas repetidoras de telefonía móvil y 18 000 m para la búsqueda inversa de IP. ts (opcional): marca de tiempo DE UNIX UTC de cuando el cliente estaba en la ubicación. (La marca de tiempo de UNIX es el número de segundos desde el 1 de enero de 1970). head (opcional): encabezado relativo del cliente o dirección de viaje. Especifique la dirección de desplazamiento como grados de 0 a 360, en la dirección de las agujas del reloj con respecto al norte verdadero. Especifique esta clave solo si la clave sp no es cero. sp (opcional): velocidad horizontal (velocidad), en metros por segundo, que el dispositivo cliente está viajando. alt (opcional): la altitud del dispositivo cliente, en metros. are (opcional): radio, en metros, que especifica la precisión vertical de las coordenadas. Especifique esta clave solo si especifica la tecla alt. Aunque muchas de las claves son opcionales, cuanta más información proporcione, más precisos serán los resultados de ubicación. Aunque es opcional, se recomienda especificar siempre la ubicación geográfica del usuario. Proporcionar la ubicación es especialmente importante si la dirección IP del cliente no refleja con precisión la ubicación física del usuario (por ejemplo, si el cliente utiliza VPN). Para obtener resultados óptimos, debería incluir tanto este encabezado como X-MSEdge-ClientIP pero, como mínimo, debe incluir este.
- market
- String
Mercado de dónde proceden los resultados. Normalmente, mkt es el país desde el que el usuario realiza la solicitud. Sin embargo, podría ser un país diferente si el usuario no se encuentra en un país donde Bing entrega resultados. El mercado debe estar en el código> de>< país del código de idioma de formulario<. Por ejemplo, en-US. La cadena no distingue mayúsculas de minúsculas. Para obtener una lista de posibles valores de mercado, consulte Códigos de mercado. NOTA: Si se conoce, se recomienda especificar siempre el mercado. Especificar el mercado ayuda a Bing a enrutar la solicitud y devolver una respuesta adecuada y óptima. Si especifica un mercado que no aparece en Códigos de mercado, Bing usa un código de mercado adecuado basado en una asignación interna que está sujeta a cambios.
- safeSearch
- String
Filtre los resultados de la imagen en acciones con el tipo "VisualSearch" para contenido para adultos. A continuación se muestran los valores de filtro posibles. Desactivado: puede devolver imágenes con contenido para adultos. Moderado: No devuelva imágenes con contenido para adultos. Estricto: No devuelva imágenes con contenido para adultos. El valor predeterminado es Moderado. Si la solicitud procede de un mercado que la directiva para adultos de Bing requiere que safeSearch esté establecido en Strict, Bing omite el valor safeSearch y usa Strict. Si usa el sitio: filtro en la solicitud de conocimiento, existe la posibilidad de que la respuesta contenga contenido para adultos, independientemente de cuál sea el parámetro de consulta safeSearch establecido en. Sitio de uso: solo si conoce el contenido en el sitio y su escenario admite la posibilidad de contenido para adultos. Entre los valores posibles se incluyen: "Off", "Moderate", "Strict"
- setLang
- String
Idioma que se usará para las cadenas de la interfaz de usuario. Especifique el idioma con el código ISO 639-1 de 2 letras. Por ejemplo, el código de idioma de inglés es EN. El valor predeterminado es EN (inglés). Aunque sea opcional, siempre debe especificar el idioma. Normalmente, establece setLang en el mismo idioma especificado por mkt a menos que el usuario quiera que las cadenas de la interfaz de usuario se muestren en un idioma diferente. Una cadena de interfaz de usuario es aquella que se usa como etiqueta en una interfaz de usuario. Hay pocas cadenas de interfaz de usuario en los objetos de respuesta JSON. Además, los vínculos a las propiedades de Bing.com de los objetos de respuesta aplican el idioma especificado.
- knowledgeRequest
- String
Los datos del formulario son un objeto JSON que identifica la imagen mediante un token de información o una dirección URL de la imagen. El objeto también puede incluir un área de recorte opcional que identifique un área de interés en la imagen. El token de información y la dirección URL son mutuamente excluyentes: no especifique ambos. Puede especificar knowledgeRequest form data and image form data in the same request only if knowledgeRequest form data specifies the cropArea field only (it must not include an insights token or URL).
- image
- Stream
Los datos del formulario son un binario de imagen. El parámetro name del encabezado Content-Disposition debe establecerse en "image". Debe especificar un binario de imagen si no usa los datos de formulario knowledgeRequest para especificar la imagen; Es posible que no use ambos formularios para especificar una imagen. Puede especificar knowledgeRequest form data and image form data in the same request only if knowledgeRequest form data specifies the cropArea field only (it must not include an insights token or URL).
- cancellationToken
- CancellationToken
Token de cancelación.
Devoluciones
Se aplica a
Azure SDK for .NET
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de