Использование маркеров оформления для выделения текста
Предупреждение
30 октября 2020 года API Поиска Bing переместились из Cognitive Services в службы Поиска Bing. Эта документация приводится только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска Bing приведены в статье Создание ресурса для Поиска Bing с помощью Azure Marketplace.
Bing поддерживает выделение совпадений, при котором помечаются термины запросов (или другие термины, которые Bing считает подходящими) в отображаемых строках некоторых ответов. Например, поля результатов веб-страниц name, displayUrl и snippet могут содержать помеченные термины запроса.
По умолчанию Bing не включает маркеры выделения в отображаемых строках. Чтобы включить маркеры, добавьте параметр textDecorations в запрос и присвойте ему значение true.
Пример выделения совпадений
В следующем примере показан результат поиска в Интернете для запроса Sailing Dinghy. Bing пометил начало и окончание термина запроса с помощью символов Юникода E000 и E001.
Прежде чем результат отобразится в пользовательском интерфейсе, замените символы Юникода символами, которые соответствуют формату отображения.
Форматирование маркеров
Bing предоставляет возможность использовать символы Юникода или теги HTML в качестве маркеров. Чтобы указать, какие маркеры использовать, добавьте параметр запроса textFormat:
| Значение | Marker |
|---|---|
textFormat=Raw |
Символы Юникода (по умолчанию) |
textFormat=HTML |
Символы HTML |
Дополнительное оформление текста
Bing может возвращать несколько различных видов оформления текста. Например, ответ Computation может содержать подстрочные маркеры для термина запроса log(2) в поле expression.
Если в запросе не указано оформление, поле expression будет содержать значение log10(2).
Если для textDecorations задано значение true, Bing может содержать следующие маркеры в отображаемых строках ответов. Если соответствующий тег HTML отсутствует, ячейка в таблице будет пустой.
| Юникод | 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> | Помечает конец содержимого, выделенного надстрочным шрифтом |