ImagesExtensions.VisualSearchMethodAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| VisualSearchMethodAsync(IImages, String, String, String, String, String, String, String, String, String, VisualSearchRequest, Stream, CancellationToken) |
Image Visual Search API を使用すると、画像をBingに送信し、関連するタグの一覧を取得できます。 各タグには、ユーザーが関心を持つ可能性のあるアクションが含まれています。 このセクションでは、アクションの要求に使用する要求の形式とヘッダー、およびそれらを含む JSON 応答オブジェクトに関する技術的な詳細について説明します。 要求の作成方法を示す例については、「 Web で画像を検索する」を参照してください。 |
| VisualSearchMethodAsync(IImages, String, String, String, String, String, String, String, String, String, String, Stream, CancellationToken) |
Visual Search API を使用すると、視覚的に類似した画像、ショッピング ソース、関連する検索などの画像に関する分析情報を検出できます。 API では、テキスト認識の実行、エンティティ (人、場所、物)の識別、ユーザーが探索するその他の局所コンテンツの返しなどを行うこともできます。 詳細については、「 Visual Search の概要」を参照してください。 |
VisualSearchMethodAsync(IImages, String, String, String, String, String, String, String, String, String, VisualSearchRequest, Stream, CancellationToken)
Image Visual Search API を使用すると、画像をBingに送信し、関連するタグの一覧を取得できます。 各タグには、ユーザーが関心を持つ可能性のあるアクションが含まれています。 このセクションでは、要求の形式と、アクションを要求するために使用するヘッダー、およびそれらを含む JSON 応答オブジェクトに関する技術的な詳細について説明します。 要求の作成方法を示す例については、「 Web で画像を検索する」を参照してください。
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)パラメーター
- operations
- IImages
この拡張メソッドの操作グループ。
- acceptLanguage
- String
ユーザー インターフェイス文字列に使用する 1 つ以上の言語のコンマ区切りのリスト。 リストでは優先度の高いものから順に指定します。 必要な形式などの追加情報については、 RFC2616 を参照してください。 このヘッダーと setLang クエリ パラメーターは相互に排他的です。両方を指定しないでください。 このヘッダーを設定する場合は、cc クエリ パラメーターも指定する必要があります。 結果を返す市場を決定するために、Bingはリストから最初にサポートされている言語を使用し、それを cc パラメーター値と組み合わせます。 サポート対象言語がリストに含まれていない場合、要求がサポートされる最も近い言語と市場が Bing によって検出されるか、集計された市場または既定の市場が結果に使用されます。 Bing によって使用された市場を確認するには、BingAPIs-Market ヘッダーを調べます。 複数の言語を指定する場合にのみ、このヘッダーと cc クエリ パラメーターを使用します。 それ以外の場合は、mkt クエリ パラメーターおよび setLang クエリ パラメーターを使用します。 ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。 JSON 応答オブジェクトには、いくつかのユーザー インターフェイス文字列があります。 応答オブジェクト内の Bing.com プロパティへのリンクには、指定された言語が適用されます。
- contentType
- String
省略可能な要求ヘッダー。 modules クエリ パラメーターを RecognizedEntities に設定した場合は、POST 要求の本文でイメージのバイナリを指定できます。 POST 要求の本文でイメージを指定する場合は、このヘッダーを指定し、その値を multipart/form-data に設定する必要があります。 最大イメージ サイズは 1 MB です。
- userAgent
- String
要求送信元のユーザー エージェント。 Bing では、モバイル ユーザーに最適なエクスペリエンスを提供するためにユーザー エージェントが使用されます。 省略可能ですが、このヘッダーは常に指定することをお勧めします。 ユーザーエージェントは、よく使用されるブラウザーによって送信されるのと同じ文字列にする必要があります。 ユーザー エージェントの詳細については、「 RFC 2616」を参照してください。ユーザー エージェント文字列の例を次に示します。 Windows Phone: Mozilla/5.0 (互換性があります。MSIE 10.0;Windows Phone 8.0;Trident/6.0;IEMobile/10.0;腕;タッチ;ノキア;Lumia 822)。 Android: Mozilla / 5.0 (Linux;U;Android 2.3.5;en - us;SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; like Gecko) Version / 4.0 Mobile Safari / 533.1。 iPhone: Mozilla / 5.0 (iPhone;MAC OS X のような CPU iPhone OS 6_1) 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;タッチ;rv:11.0) に似ています。 iPad: Mozilla / 5.0 (iPad;MAC OS X のような CPU OS 7_0) AppleWebKit / 537.51.1 (Gecko のような KHTML) バージョン / 7.0 Mobile / 11A465 Safari / 9537.53
- clientId
- String
このヘッダーは、Bing API の呼び出し間で一貫性のある動作をユーザーに提供するために Bing によって使用されます。 Bing によって、新しい機能と改善点が頻繁にフライト化されます。そして、トラフィックを異なるフライトに割り当てるためのキーとして、クライアント ID が使用されます。 複数の要求に対してユーザーの同じクライアント ID を使用しないと、ユーザーが複数の競合するフライトに割り当てられる可能性があります。 複数の競合するフライトに割り当てられると、ユーザー エクスペリエンスの一貫性がなくなる場合があります。 たとえば、2 番目の要求に 1 番目とは異なるフライトが割り当てられていると、エクスペリエンスが予期しないものになる可能性があります。 また、クライアント ID は、そのクライアント ID の検索履歴に合わせて Web の結果を調整し、ユーザーにリッチなエクスペリエンスを提供するために Bing によって使用される場合があります。 このヘッダーは、クライアント ID で生成されたアクティビティを分析して結果の順位付けを向上させるために Bing によって使用されることもあります。 関連性の向上は、Bing API によって提供される結果の品質向上に役立ち、API コンシューマーのクリックスルー率の向上を実現します。 重要: このヘッダーは省略可能ですが、必須であると考える必要があります。 同じエンド ユーザーとデバイスの組み合わせによる複数の要求に対してクライアント ID を保持することで、1) API コンシューマーが一貫性のあるユーザー エクスペリエンスを受け取ることができ、2) Bing API からの結果の品質向上を通じてクリックスルー率の向上が実現します。 デバイスでアプリケーションを使用する各ユーザーは、Bing によって生成された一意のクライアント ID を持っている必要があります。 このヘッダーを要求に含めない場合、Bing によって ID が生成され、それが X-MSEdge-ClientID 応答ヘッダーで返されます。 このヘッダーを要求に含めるべきでない唯一の場合は、ユーザーがそのデバイスでアプリを初めて使用するときです。 そのユーザーのためにアプリによってデバイスで実行される各 Bing API 要求で、クライアント ID を使用します。 クライアント ID を保持します。 ブラウザー アプリで ID を永続化するには、永続的な HTTP Cookie を使用して ID がすべてのセッションで確実に使用されるようにします。 セッション Cookie は使用しないようにしてください。 モバイル アプリなど、他のアプリの場合は、デバイスの永続的ストレージを使用して ID を保持します。 次にそのデバイスでユーザーがアプリを使用するときに、保持したクライアント ID を取得します。 Bing の応答には、このヘッダーが含まれる場合と含まれない場合があります。 このヘッダーが応答に含まれる場合、クライアント ID をキャプチャして、ユーザーのためにそのデバイスで実行される後続のすべての Bing 要求でそれを使用します。 X-MSEdge-ClientID を含める場合、要求には Cookie を含めないようにしてください。
- clientIp
- String
クライアント デバイスの IPv4 アドレスまたは IPv6 アドレス。 IP アドレスは、ユーザーの位置情報の検出に使用されます。 位置情報は、安全な検索動作を決定するために Bing によって使用されます。 省略可能ですが、このヘッダーと X-Search-Location ヘッダーは常に指定することをお勧めします。 (最後のオクテットを 0 に変更するなど) アドレスを難読化しないようにしてください。 アドレスを難読化すると、デバイスの実際の場所から離れた場所が検出され、Bing から誤った結果が提供される可能性があります。
- location
- String
クライアントの地理的な場所を示す、キーと値のペアのセミコロン区切りリストです。 位置情報は、安全な検索動作を決定して関連するローカル コンテンツを返すために、Bing によって使用されます。 キーと値のペアは、<キー>:<値> の形式で指定します。 ユーザーの場所の指定に使用するキーは次のとおりです。 lat (必須): クライアントの場所の緯度 (度単位)。 緯度は、-90.0 以上、+90.0 以下である必要があります。 負の値は南半球の緯度を示し、正の値は北半球の緯度を示します。 long (必須): クライアントの場所の経度 (度単位)。 経度は、-180.0 以上、+180.0 以下である必要があります。 負の値は西半球の経度を示し、正の値は東半球の経度を示します。 re (必須): 座標の水平方向の精度を指定する半径 (メートル単位)。 デバイスの位置情報サービスによって返される値を渡します。 一般的な値は、GPS/Wi-Fi の 22 m、携帯電話基地局の三角測量の 380 m、IP 逆引き参照の 18,000 m などです。 ts (省略可能): クライアントが場所にあった時の UTC UNIX タイムスタンプ。 (UNIX タイムスタンプは、1970 年 1 月 1 日以降の秒数です)。head (省略可能): クライアントの相対見出しまたは移動方向。 移動方向は、真北を基準として時計回りに 0 から 360 度で指定します。 sp キーが 0 以外の場合にのみ、このキーを指定します。 sp (省略可能): クライアント デバイスが移動している水平方向の速度 (速度)(1 秒あたりのメートル単位)。 alt (省略可能): クライアント デバイスの高度 (メートル単位)。 are (省略可能): 座標の垂直方向の精度を指定する半径 (メートル単位)。 alt キーを指定する場合にのみ、このキーを指定します。 多くのキーは省略可能ですが、提供する情報が多いほど、場所の結果の正確さが増します。 省略可能ですが、ユーザーの地理的な場所は常に指定することをお勧めします。 位置情報を提供することは、クライアントの IP アドレスがユーザーの物理的な場所を正確に反映していない場合 (たとえば、クライアントによって VPN が使用されている場合) に特に重要です。 最適な結果を得るには、このヘッダーと X-MSEdge-ClientIP ヘッダーを含める必要がありますが、最低限、このヘッダーを含めることをお勧めします。
- market
- String
結果の取得元の市場。 通常、mkt はユーザーが要求を行っている国です。 ただし、ユーザーが結果を提供する国にいない場合は、別の国Bing可能性があります。 マーケットは、言語コードと国コード><>の形式<である必要があります。 たとえば、en-US などです。 文字列では大文字と小文字が区別されません。 使用可能な市場価値の一覧については、「 市場コード」を参照してください。 注: 既知の場合は、常に市場を指定することをお勧めします。 市場を指定すると、Bing が要求をルーティングして最適な応答を返すのに役立ちます。 市場コードに記載されていない市場を指定した場合、Bingは、変更される可能性のある内部マッピングに基づいて最適な市場コードを使用します。
- safeSearch
- String
成人向けコンテンツの "VisualSearch" 型のアクションで画像の結果をフィルター処理します。 使用可能なフィルター値を次に示します。 オフ: 成人向けコンテンツを含む画像を返す場合があります。 中: 成人向けコンテンツを含む画像は返しません。 厳密: 成人向けコンテンツを含む画像は返しません。 既定値は Moderate です。 Bingの成人向けポリシーで safeSearch が Strict に設定されている必要がある市場からの要求の場合、Bingは safeSearch 値を無視し、Strict を使用します。 ナレッジ要求で site: フィルターを使用する場合、safeSearch クエリ パラメーターの設定に関係なく、応答に成人向けコンテンツが含まれている可能性があります。 サイトを使用する: サイト上のコンテンツを認識していて、シナリオが成人向けコンテンツの可能性をサポートしている場合にのみ使用します。 指定できる値は、'Off'、'Moderate'、'Strict' です。
- setLang
- String
ユーザー インターフェイス文字列に使用する言語。 ISO 639-1 の 2 文字言語コードを使って言語を指定します。 たとえば、英語の言語コードは EN です。 既定値は EN (英語) です。 省略可能ですが、常に言語を指定することをお勧めします。 通常、ユーザーがユーザー インターフェイス文字列を別の言語で表示する場合を除き、setLang は mkt で指定された同じ言語に設定します。 ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。 JSON 応答オブジェクトには、いくつかのユーザー インターフェイス文字列があります。 また、応答オブジェクト内の Bing.com プロパティへのリンクには、指定された言語が適用されます。
- knowledgeRequest
- VisualSearchRequest
イメージに関する情報を含む JSON オブジェクト。 image フィールドと imageInsightsToken フィールドは相互に排他的です。要求の本文には、そのうちの 1 つだけを含める必要があります。
- image
- Stream
アップロードされたイメージ ファイル。 イメージのサイズは 1 MB に制限されており、ファイル名は "image" である必要があります。 image フィールドと imageInsightsToken フィールドは相互に排他的です。要求の本文には、そのうちの 1 つだけを含める必要があります。
- cancellationToken
- CancellationToken
キャンセル トークン。
戻り値
適用対象
VisualSearchMethodAsync(IImages, String, String, String, String, String, String, String, String, String, String, Stream, CancellationToken)
Visual Search API を使用すると、視覚的に類似した画像、ショッピング ソース、関連する検索などの画像に関する分析情報を検出できます。 API では、テキスト認識の実行、エンティティ (人、場所、物)の識別、ユーザーが探索するその他の局所コンテンツの返しなどを行うこともできます。 詳細については、「 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)パラメーター
- operations
- IImages
この拡張メソッドの操作グループ。
- acceptLanguage
- String
ユーザー インターフェイス文字列に使用する 1 つ以上の言語のコンマ区切りのリスト。 リストでは優先度の高いものから順に指定します。 必要な形式などの追加情報については、 RFC2616 を参照してください。 このヘッダーと setLang クエリ パラメーターは相互に排他的です。両方を指定しないでください。 このヘッダーを設定する場合は、cc クエリ パラメーターも指定する必要があります。 結果を返す市場を決定するために、Bingは、リストから検索した最初のサポートされている言語を使用し、それを cc パラメーター値と組み合わせます。 サポート対象言語がリストに含まれていない場合、要求がサポートされる最も近い言語と市場が Bing によって検出されるか、集計された市場または既定の市場が結果に使用されます。 Bing によって使用された市場を確認するには、BingAPIs-Market ヘッダーを調べます。 複数の言語を指定する場合にのみ、このヘッダーと cc クエリ パラメーターを使用します。 それ以外の場合は、mkt クエリ パラメーターおよび setLang クエリ パラメーターを使用します。 ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。 JSON 応答オブジェクトには、いくつかのユーザー インターフェイス文字列があります。 応答オブジェクト内の Bing.com プロパティへのリンクには、指定された言語が適用されます。
- contentType
- String
multipart/form-data に設定し、boundary パラメーターを含める必要があります (例: multipart/form-data; boundary=<boundary string>)。 詳しくは、「コンテンツ フォームの種類」をご覧ください。
- userAgent
- String
要求送信元のユーザー エージェント。 Bing では、モバイル ユーザーに最適なエクスペリエンスを提供するためにユーザー エージェントが使用されます。 省略可能ですが、このヘッダーは常に指定することをお勧めします。 ユーザーエージェントは、よく使用されるブラウザーによって送信されるのと同じ文字列にする必要があります。 ユーザー エージェントの詳細については、 RFC 2616 を参照してください。ユーザー エージェント文字列の例を次に示します。 Windows Phone: Mozilla/5.0 (互換性があります。MSIE 10.0;Windows Phone 8.0;Trident/6.0;IEMobile/10.0;腕;タッチ;ノキア;Lumia 822)。 Android: Mozilla / 5.0 (Linux;U;Android 2.3.5;en - us;SCH - I500 Build / GINGERBREAD) AppleWebKit / 533.1 (KHTML; like Gecko) Version / 4.0 Mobile Safari / 533.1。 iPhone: Mozilla / 5.0 (iPhone;MAC OS X のような CPU iPhone OS 6_1) 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;タッチ;rv:11.0) like Gecko. iPad: Mozilla / 5.0 (iPad;Mac OS X のような CPU OS 7_0) AppleWebKit / 537.51.1 (KHTML、 gecko など) バージョン / 7.0 Mobile / 11A465 Safari / 9537.53。
- clientId
- String
このヘッダーは、Bing API の呼び出し間で一貫性のある動作をユーザーに提供するために Bing によって使用されます。 Bing によって、新しい機能と改善点が頻繁にフライト化されます。そして、トラフィックを異なるフライトに割り当てるためのキーとして、クライアント ID が使用されます。 複数の要求に対してユーザーの同じクライアント ID を使用しないと、ユーザーが複数の競合するフライトに割り当てられる可能性があります。 複数の競合するフライトに割り当てられると、ユーザー エクスペリエンスの一貫性がなくなる場合があります。 たとえば、2 番目の要求に 1 番目とは異なるフライトが割り当てられていると、エクスペリエンスが予期しないものになる可能性があります。 また、クライアント ID は、そのクライアント ID の検索履歴に合わせて Web の結果を調整し、ユーザーにリッチなエクスペリエンスを提供するために Bing によって使用される場合があります。 このヘッダーは、クライアント ID で生成されたアクティビティを分析して結果の順位付けを向上させるために Bing によって使用されることもあります。 関連性の向上は、Bing API によって提供される結果の品質向上に役立ち、API コンシューマーのクリックスルー率の向上を実現します。 重要: このヘッダーは省略可能ですが、必須であると考える必要があります。 同じエンド ユーザーとデバイスの組み合わせによる複数の要求に対してクライアント ID を保持することで、1) API コンシューマーが一貫性のあるユーザー エクスペリエンスを受け取ることができ、2) Bing API からの結果の品質向上を通じてクリックスルー率の向上が実現します。 デバイスでアプリケーションを使用する各ユーザーは、Bing によって生成された一意のクライアント ID を持っている必要があります。 このヘッダーを要求に含めない場合、Bing によって ID が生成され、それが X-MSEdge-ClientID 応答ヘッダーで返されます。 このヘッダーを要求に含めるべきでない唯一の場合は、ユーザーがそのデバイスでアプリを初めて使用するときです。 そのユーザーのためにアプリによってデバイスで実行される各 Bing API 要求で、クライアント ID を使用します。 クライアント ID を保持します。 ブラウザー アプリで ID を永続化するには、永続的な HTTP Cookie を使用して ID がすべてのセッションで確実に使用されるようにします。 セッション Cookie は使用しないようにしてください。 モバイル アプリなど、他のアプリの場合は、デバイスの永続的ストレージを使用して ID を保持します。 次にそのデバイスでユーザーがアプリを使用するときに、保持したクライアント ID を取得します。 Bing の応答には、このヘッダーが含まれる場合と含まれない場合があります。 このヘッダーが応答に含まれる場合、クライアント ID をキャプチャして、ユーザーのためにそのデバイスで実行される後続のすべての Bing 要求でそれを使用します。 注意： このクライアント ID は認証可能なユーザー アカウント情報にリンクできないようにする必要があります。 X-MSEdge-ClientID を含める場合、要求には Cookie を含めないようにしてください。
- clientIp
- String
クライアント デバイスの IPv4 アドレスまたは IPv6 アドレス。 IP アドレスは、ユーザーの位置情報の検出に使用されます。 位置情報は、安全な検索動作を決定するために Bing によって使用されます。 省略可能ですが、このヘッダーと X-Search-Location ヘッダーは常に指定することをお勧めします。 (最後のオクテットを 0 に変更するなど) アドレスを難読化しないようにしてください。 アドレスを難読化すると、デバイスの実際の場所から離れた場所が検出され、Bing から誤った結果が提供される可能性があります。
- location
- String
クライアントの地理的な場所を示す、キーと値のペアのセミコロン区切りリストです。 位置情報は、安全な検索動作を決定して関連するローカル コンテンツを返すために、Bing によって使用されます。 キーと値のペアは、<キー>:<値> の形式で指定します。 ユーザーの場所の指定に使用するキーは次のとおりです。 lat (必須): クライアントの場所の緯度 (度単位)。 緯度は、-90.0 以上、+90.0 以下である必要があります。 負の値は南半球の緯度を示し、正の値は北半球の緯度を示します。 long (必須): クライアントの場所の経度 (度単位)。 経度は、-180.0 以上、+180.0 以下である必要があります。 負の値は西半球の経度を示し、正の値は東半球の経度を示します。 re (必須): 座標の水平方向の精度を指定する半径 (メートル単位)。 デバイスの位置情報サービスによって返される値を渡します。 一般的な値は、GPS/Wi-Fi の 22 m、携帯電話基地局の三角測量の 380 m、IP 逆引き参照の 18,000 m などです。 ts (省略可能): クライアントが場所にあった時の UTC UNIX タイムスタンプ。 (UNIX タイムスタンプは、1970 年 1 月 1 日以降の秒数です)。head (省略可能): クライアントの相対見出しまたは移動方向。 移動方向は、真北を基準として時計回りに 0 から 360 度で指定します。 sp キーが 0 以外の場合にのみ、このキーを指定します。 sp (省略可能): クライアント デバイスが移動している水平方向の速度 (速度)(1 秒あたりのメートル単位)。 alt (省略可能): クライアント デバイスの高度 (メートル単位)。 are (省略可能): 座標の垂直方向の精度を指定する半径 (メートル単位)。 alt キーを指定する場合にのみ、このキーを指定します。 多くのキーは省略可能ですが、提供する情報が多いほど、場所の結果の正確さが増します。 省略可能ですが、ユーザーの地理的な場所は常に指定することをお勧めします。 位置情報を提供することは、クライアントの IP アドレスがユーザーの物理的な場所を正確に反映していない場合 (たとえば、クライアントによって VPN が使用されている場合) に特に重要です。 最適な結果を得るには、このヘッダーと X-MSEdge-ClientIP ヘッダーを含める必要がありますが、最低限、このヘッダーを含めることをお勧めします。
- market
- String
結果の取得元の市場。 通常、mkt はユーザーが要求を行っている国です。 ただし、ユーザーが結果を提供する国にいない場合は、別の国Bing可能性があります。 マーケットは、言語コードと国コード><>の形式<である必要があります。 たとえば、en-US などです。 文字列では大文字と小文字が区別されません。 使用可能な市場価値の一覧については、「 市場コード」を参照してください。 注: 既知の場合は、常に市場を指定することをお勧めします。 市場を指定すると、Bing が要求をルーティングして最適な応答を返すのに役立ちます。 市場コードに記載されていない市場を指定した場合、Bingは、変更される可能性がある内部マッピングに基づいて最適な市場コードを使用します。
- safeSearch
- String
画像の結果をフィルター処理すると、成人向けコンテンツの "VisualSearch" 型のアクションが表示されます。 可能なフィルター値を次に示します。 オフ: 成人コンテンツを含む画像を返す場合があります。 中: 成人用コンテンツを含む画像を返さないでください。 厳密: 成人用コンテンツを含む画像は返さないでください。 既定値は Moderate です。 Bingの成人向けポリシーで safeSearch が Strict に設定されている必要がある市場からの要求の場合、Bingは safeSearch 値を無視し、Strict を使用します。 ナレッジ要求で site: filter を使用する場合、safeSearch クエリ パラメーターの設定に関係なく、応答に成人向けコンテンツが含まれる可能性があります。 サイトを使用する: サイト上のコンテンツを認識していて、シナリオが成人コンテンツの可能性をサポートしている場合にのみ使用します。 使用可能な値は、'Off'、'Moderate'、'Strict' です。
- setLang
- String
ユーザー インターフェイス文字列に使用する言語。 ISO 639-1 の 2 文字言語コードを使って言語を指定します。 たとえば、英語の言語コードは EN です。 既定値は EN (英語) です。 省略可能ですが、常に言語を指定することをお勧めします。 通常、setLang は、ユーザーが別の言語で表示するユーザー インターフェイス文字列を必要とする場合を除き、mkt で指定された同じ言語に設定します。 ユーザー インターフェイス文字列は、ユーザー インターフェイスでラベルとして使われる文字列です。 JSON 応答オブジェクトには、いくつかのユーザー インターフェイス文字列があります。 また、応答オブジェクト内の Bing.com プロパティへのリンクには、指定された言語が適用されます。
- knowledgeRequest
- String
フォーム データは、画像の分析情報トークンまたは URL を使用してイメージを識別する JSON オブジェクトです。 オブジェクトには、イメージ内の関心領域を識別するオプションのトリミング領域を含めることもできます。 分析情報トークンと URL は相互に排他的です。両方を指定しないでください。 knowledgeRequest フォーム データが cropArea フィールドのみを指定している場合にのみ、同じ要求で knowledgeRequest フォーム データと画像フォーム データを指定できます (分析情報トークンまたは URL を含めてはいけません)。
- image
- Stream
フォーム データはイメージ バイナリです。 Content-Disposition ヘッダーの name パラメーターは、"image" に設定する必要があります。 knowledgeRequest フォーム データを使用してイメージを指定しない場合は、イメージ バイナリを指定する必要があります。両方のフォームを使用してイメージを指定することはできません。 knowledgeRequest フォーム データが cropArea フィールドのみを指定している場合にのみ、同じ要求で knowledgeRequest フォーム データと画像フォーム データを指定できます (分析情報トークンまたは URL を含めてはいけません)。
- cancellationToken
- CancellationToken
キャンセル トークン。
戻り値
適用対象
Azure SDK for .NET