Classificatie gebruiken om zoekresultaten voor entiteiten weer te geven
Waarschuwing
Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing zoek-API-documentatie voor bijgewerkte documentatie. Zie Een Zoeken in Bing resource maken via de Azure Marketplace voor instructies voor het maken van nieuwe Azure-resources voor Bing Search.
Elk antwoord op entiteit zoeken bevat een RankingResponse-antwoord dat aangeeft hoe u zoekresultaten moet weergeven die worden geretourneerd door de Bing Entiteiten zoeken-API. De resultaten van de classificatieantwoorden worden gegroepeerd in pole-, mainline- en sidebar-inhoud. Het resultaat van de pool is het belangrijkste of meest prominente resultaat en moet als eerste worden weergegeven. Als u de resterende resultaten niet in een traditionele hoofdlijn- en zijbalkindeling weergeeft, moet u de inhoud van de hoofdlijn beter zichtbaar maken dan de inhoud van de zijbalk.
Binnen elke groep geeft de matrix Items de volgorde aan waarin de inhoud moet worden weergegeven. Elk item biedt twee manieren om het resultaat in een antwoord te identificeren.
| Veld | Description |
|---|---|
answerType en resultIndex |
answerType identificeert het antwoord (entiteit of plaats) en resultIndex identificeert een resultaat binnen dat antwoord (bijvoorbeeld een entiteit). De index begint bij 0. |
value |
value Bevat een id die overeenkomt met de id van een antwoord of een resultaat in het antwoord. Het antwoord of de resultaten bevatten de id, maar niet beide. |
Het gebruik van en answerTyperesultIndex is een proces in twee stappen. Gebruik answerType eerst om het antwoord te identificeren dat de weer te geven resultaten bevat.
resultIndex Gebruik vervolgens om de resultaten van dat antwoord te indexeren om het resultaat weer te geven. (De answerType waarde is de naam van het veld in het object SearchResponse .) Als u alle resultaten van het antwoord samen moet weergeven, bevat resultIndex het antwoorditem voor de classificatie het veld niet.
Als u de id gebruikt, moet u de classificatie-id vergelijken met de id van een antwoord of een van de resultaten. Als een antwoordobject een id veld bevat, geeft u alle resultaten van het antwoord samen weer. Als het Entities object bijvoorbeeld het id veld bevat, geeft u alle artikelen over entiteiten samen weer. Als het Entities object het id veld niet bevat, bevat elke entiteit een id veld en combineert het classificatieantwoord de entiteiten met de resultaten Plaatsen.
Voorbeeld van classificatieantwoord
Hieronder ziet u een voorbeeld van RankingResponse.
{
"_type": "SearchResponse",
"queryContext": {
"originalQuery": "Jimi Hendrix"
},
"entities": { ... },
"rankingResponse": {
"sidebar": {
"items": [
{
"answerType": "Entities",
"resultIndex": 0,
"value": {
"id": "https://www.bingapis.com/api/v7/#Entities.0"
}
},
{
"answerType": "Entities",
"resultIndex": 1,
"value": {
"id": "https://www.bingapis.com/api/v7/#Entities.1"
}
}
]
}
}
}
Op basis van dit classificatieantwoord worden in de zijbalk de twee entiteitsresultaten weergegeven die betrekking hebben op Jimi Hendrix.