Verwenden von Dekorationsmarkierungen zum Markieren von Text
Warnung
Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.
Für Bing wird die Treffermarkierung unterstützt, bei der Abfrageausdrücke (oder andere Ausdrücke, die von Bing als relevant eingestuft werden) in den Anzeigezeichenfolgen einiger Antworten markiert werden. Beispielsweise können die Felder name, displayUrl und snippet der Ergebnisse einer Webseite markierte Abfragebegriffe enthalten.
Standardmäßig werden in Bing keine Hervorhebungsmarkierungen in Anzeigezeichenfolgen eingefügt. Fügen Sie zum Aktivieren der Markierungen den Abfrageparameter textDecorations in Ihre Anforderung ein, und legen Sie ihn auf true fest.
Beispiel für Treffermarkierung
Im folgenden Beispiel wird ein Webergebnis für Sailing Dinghy veranschaulicht. In Bing werden Anfang und Ende von Abfrageausdrücken mit den Unicode-Zeichen E000 und E001 markiert.
Bevor das Ergebnis auf Ihrer Benutzeroberfläche angezeigt wird, sollten Sie die Unicode-Zeichen durch Zeichen ersetzen, die für Ihr Anzeigeformat geeignet sind.
Markerformatierung
In Bing haben Sie die Möglichkeit, Unicode-Zeichen oder HTML-Tags als Marker bereitzustellen. Fügen Sie den Abfrageparameter textFormat ein, um anzugeben, welche Marker verwendet werden sollen.
| Wert | Marker |
|---|---|
textFormat=Raw |
Unicode-Zeichen (Standard) |
textFormat=HTML |
HTML-Zeichen |
Zusätzliche Textdekorationen
Mit Bing können mehrere verschiedene Textdekorationen zurückgegeben werden. Eine Computation-Antwort kann z. B. tiefgestellte Marker für den Abfragebegriff log(2) im Feld expression enthalten.
Wenn die Anforderung keine Dekorationen angibt, würde das Feld expression den Wert log10(2) enthalten.
Wenn textDecorations auf true festgelegt ist, können in Bing die unten angegebenen Marker in die Anzeigezeichenfolgen von Antworten eingefügt werden. Falls keine Entsprechung als HTML-Tag vorhanden ist, enthält die Tabellenzelle keine Angabe.
| Unicode | HTML | Beschreibung |
|---|---|---|
| U+E000 | <b> | Markiert den Anfang des Abfrageausdrucks (Treffermarkierung) |
| U+E001 | </b> | Markiert das Ende des Abfrageausdrucks |
| U+E002 | <i> | Markiert den Anfang von Text in Kursivdruck |
| U+E003 | </i> | Markiert das Ende von Text in Kursivdruck |
| U+E004 | <br/> | Markiert einen Zeilenumbruch |
| U+E005 | Markiert den Anfang einer Telefonnummer | |
| U+E006 | Markiert das Ende einer Telefonnummer | |
| U+E007 | Markiert den Anfang einer Adresse | |
| U+E008 | Markiert das Ende einer Adresse | |
| U+E009 | Markiert ein geschütztes Leerzeichen | |
| U+E00C | <strong> | Markiert den Anfang von Text in Fettdruck |
| U+E00D | </strong> | Markiert das Ende von Text in Fettdruck |
| U+E00E | Markiert den Anfang von Text, dessen Hintergrund heller als der umgebende Hintergrund sein soll | |
| U+E00F | Markiert das Ende von Text, dessen Hintergrund heller als der umgebende Hintergrund sein soll | |
| U+E010 | Markiert den Anfang von Text, dessen Hintergrund dunkler als der umgebende Hintergrund sein soll | |
| U+E011 | Markiert das Ende von Text, dessen Hintergrund dunkler als der umgebende Hintergrund sein soll | |
| U+E012 | <del> | Markiert den Anfang von Text, der durchgestrichen sein soll |
| U+E013 | </del> | Markiert das Ende von Text, der durchgestrichen sein soll |
| U+E016 | <sub> | Markiert den Anfang von tiefgestelltem Text |
| U+E017 | </sub> | Markiert das Ende von tiefgestelltem Text |
| U+E018 | <sup> | Markiert den Anfang von hochgestelltem Text |
| U+E019 | </sup> | Markiert das Ende von hochgestelltem Text |