装飾マーカーを使用してテキストを強調表示する
警告
2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。 このドキュメントは、参考用としてのみ提供されています。 更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、「Azure Marketplace から Bing Search リソースを作成する」を参照してください。
Bing は検索語の強調表示をサポートしています。検索語の強調表示により、一部の結果の表示文字列内で検索語 (または Bing が関連すると見なしたその他の語) がマークされます。 たとえば、Web ページ結果の name
、 displayUrl
、および snippet
の各フィールドには、マークされた検索語が含まれる場合があります。
Bing は、既定で、表示文字列に強調表示のマーカーを含めません。 マーカーを有効にするには、要求に textDecorations
クエリ パラメーターを含め、それを true
に設定します。
検索結果の強調表示の例
次の例は Sailing Dinghy
の Web 結果を示しています。 Bing では、Unicode 文字 E000 と E001 を使用して、検索語の開始と終了がマークされます。
ユーザー インターフェイスにこの結果を表示する前に、Unicode 文字を、表示形式に適した文字に置き換えます。
マーカーの書式設定
Bing には、マーカーとして Unicode 文字または HTML タグのいずれかを使用するオプションが用意されています。 使用するマーカーを指定するには、textFormat クエリ パラメーターを含めます。
値 | Marker |
---|---|
textFormat=Raw |
Unicode 文字 (既定) |
textFormat=HTML |
HTML 文字 |
その他の文字の装飾
Bing はいくつかの異なる文字装飾を返すことができます。 たとえば、Computation
の結果には、expression
フィールド内の検索語 log(2)
の下付き文字マーカーを含めることができます。
要求で装飾が指定されていない場合、expression
フィールドには log10(2)
が含まれます。
textDecorations
が true
の場合、Bing では、結果の表示文字列に次のマーカーを含めることができます。 同等の HTML タグがない場合、表のセルは空になっています。
Unicode | HTML | 説明 |
---|---|---|
U+E000 | <b> | 検索語の開始をマークします (検索語の強調表示) |
U+E001 | </b> | 検索語の終了をマークします |
U+E002 | <i> | 斜体のコンテンツの開始をマークします |
U+E003 | </i> | 斜体のコンテンツの終了をマークします |
U+E004 | <br/> | 改行をマークします |
U+E005 | 電話番号の開始をマークします | |
U+E006 | 電話番号の終了をマークします | |
U+E007 | 住所の開始をマークします | |
U+E008 | 住所の終了をマークします | |
U+E009 | 改行なしスペースをマークします | |
U+E00C | <strong> | 太字のコンテンツの開始をマークします |
U+E00D | </strong> | 太字のコンテンツの終了をマークします |
U+E00E | 背景がその周囲の背景より明るいコンテンツの開始をマークします | |
U+E00F | 背景がその周囲の背景より明るいコンテンツの終了をマークします | |
U+E010 | 背景がその周囲の背景より暗いコンテンツの開始をマークします | |
U+E011 | 背景がその周囲の背景より暗いコンテンツの終了をマークします | |
U+E012 | <del> | 取り消し線が引かれているコンテンツの開始をマークします |
U+E013 | </del> | 取り消し線が引かれているコンテンツの終了をマークします |
U+E016 | <sub> | 下付き文字のコンテンツの開始をマークします |
U+E017 | </sub> | 下付き文字のコンテンツの終了をマークします |
U+E018 | <sup> | 上付き文字のコンテンツの開始をマークします |
U+E019 | </sup> | 上付き文字のコンテンツの終了をマークします |