装飾マーカーを使用してテキストを強調表示するUsing decoration markers to highlight text

警告

Bing Search API は、Cognitive Services から Bing Search Services に移行されます。Bing Search APIs are moving from Cognitive Services to Bing Search Services. 2020 年 10 月 30 日 以降、Bing Search の新しいインスタンスは、こちらに記載されているプロセスに従ってプロビジョニングする必要があります。Starting October 30, 2020, any new instances of Bing Search need to be provisioned following the process documented here. Cognitive Services を使用してプロビジョニングされた Bing Search API は、次の 3 年間、または Enterprise Agreement の終わり (どちらか先に発生した方) までサポートされます。Bing Search APIs provisioned using Cognitive Services will be supported for the next three years or until the end of your Enterprise Agreement, whichever happens first. 移行手順については、Bing Search Services に関する記事を参照してください。For migration instructions, see Bing Search Services.

Bing は検索語の強調表示をサポートしています。検索語の強調表示により、一部の結果の表示文字列内で検索語 (または Bing が関連すると見なしたその他の語) がマークされます。Bing supports hit highlighting, which marks query terms (or other terms that Bing finds relevant) in the display strings of some answers. たとえば、Web ページ結果の namedisplayUrl、および snippet の各フィールドには、マークされた検索語が含まれる場合があります。For example, a webpage result's name, displayUrl, and snippet fields might contain marked query terms.

Bing は、既定で、表示文字列に強調表示のマーカーを含めません。By default, Bing doesn't include highlighting markers in display strings. マーカーを有効にするには、要求に textDecorations クエリ パラメーターを含め、それを true に設定します。To enable the markers, include the textDecorations query parameter in your request and set it to true.

検索結果の強調表示の例Hit highlighting example

次の例は Sailing Dinghy の Web 結果を示しています。The following example shows a web result for Sailing Dinghy. Bing では、Unicode 文字 E000 と E001 を使用して、検索語の開始と終了がマークされます。Bing marked the beginning and end of the query term using the E000 and E001 Unicode characters.

検索語の強調表示

ユーザー インターフェイスにこの結果を表示する前に、Unicode 文字を、表示形式に適した文字に置き換えます。Before displaying the result in your user interface, replace the Unicode characters with ones that are appropriate for your display format.

マーカーの書式設定Marker formatting

Bing には、マーカーとして Unicode 文字または HTML タグのいずれかを使用するオプションが用意されています。Bing provides the option of using either Unicode characters or HTML tags as markers. 使用するマーカーを指定するには、textFormat クエリ パラメーターを含めます。To specify which markers to use, include the textFormat query parameter:

Value MarkerMarker
textFormat=Raw Unicode 文字 (既定)Unicode characters (default)
textFormat=HTML HTML 文字HTML characters

その他の文字の装飾Additional text decorations

Bing はいくつかの異なる文字装飾を返すことができます。Bing can return several different text decorations. たとえば、Computation の結果には、expression フィールド内の検索語 log(2) の下付き文字マーカーを含めることができます。For example, a Computation answer can contain subscript markers for the query term log(2) in the expression field.

計算のマーカー

要求で装飾が指定されていない場合、expression フィールドには log10(2) が含まれます。If the request did not specify decorations, the expression field would contain log10(2).

textDecorationstrue の場合、Bing では、結果の表示文字列に次のマーカーを含めることができます。If textDecorations is true, Bing may include the following markers in the display strings of answers. 同等の HTML タグがない場合、表のセルは空になっています。If there is no equivalent HTML tag, the table cell is empty.

UnicodeUnicode HTMLHTML 説明Description
U+E000U+E000 <b> 検索語の開始をマークします (検索語の強調表示)Marks the beginning of the query term (hit highlighting)
U+E001U+E001 </b> 検索語の終了をマークしますMarks the end of the query term
U+E002U+E002 <i> 斜体のコンテンツの開始をマークしますMarks the beginning of italicized content
U+E003U+E003 </i> 斜体のコンテンツの終了をマークしますMarks the end of italicized content
U+E004U+E004 <br/> 改行をマークしますMarks a line break
U+E005U+E005 電話番号の開始をマークしますMarks the beginning of a phone number
U+E006U+E006 電話番号の終了をマークしますMarks the end of a phone number
U+E007U+E007 住所の開始をマークしますMarks the beginning of an address
U+E008U+E008 住所の終了をマークしますMarks the end of an address
U+E009U+E009 &nbsp;&nbsp; 改行なしスペースをマークしますMarks a non-breaking space
U+E00CU+E00C <strong> 太字のコンテンツの開始をマークしますMarks the beginning of bold content
U+E00DU+E00D </strong> 太字のコンテンツの終了をマークしますMarks the end of bold content
U+E00EU+E00E 背景がその周囲の背景より明るいコンテンツの開始をマークしますMarks the beginning of content whose background should be lighter than its surrounding background
U+E00FU+E00F 背景がその周囲の背景より明るいコンテンツの終了をマークしますMarks the end of content whose background should be lighter than its surrounding background
U+E010U+E010 背景がその周囲の背景より暗いコンテンツの開始をマークしますMarks the beginning of content whose background should be darker than its surrounding background
U+E011U+E011 背景がその周囲の背景より暗いコンテンツの終了をマークしますMarks the end of content whose background should be darker than its surrounding background
U+E012U+E012 <del> 取り消し線が引かれているコンテンツの開始をマークしますMarks the beginning of content that should be struck through
U+E013U+E013 </del> 取り消し線が引かれているコンテンツの終了をマークしますMarks the end of content that should be struck through
U+E016U+E016 <sub> 下付き文字のコンテンツの開始をマークしますMarks the beginning of subscript content
U+E017U+E017 </sub> 下付き文字のコンテンツの終了をマークしますMarks the end of subscript content
U+E018U+E018 <sup> 上付き文字のコンテンツの開始をマークしますMarks the beginning of superscript content
U+E019U+E019 </sup> 上付き文字のコンテンツの終了をマークしますMarks the end of superscript content

次のステップNext steps