装飾マーカーを使用してテキストを強調表示する

  • [アーティクル]

警告

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> 上付き文字のコンテンツの終了をマークします

次のステップ