Wyświetlanie wyników wyszukiwania jednostek przy użyciu klasyfikacji
Ostrzeżenie
30 października 2020 r. interfejsy API Wyszukiwanie Bing zostały przeniesione z usług Azure AI do usług Wyszukiwanie Bing Services. Ta dokumentacja jest udostępniana tylko do celów referencyjnych. Aby uzyskać zaktualizowaną dokumentację, zobacz dokumentację interfejsu API wyszukiwania Bing. Aby uzyskać instrukcje dotyczące tworzenia nowych zasobów platformy Azure na potrzeby wyszukiwania Bing, zobacz Tworzenie zasobu Wyszukiwanie Bing za pośrednictwem Azure Marketplace.
Każda odpowiedź wyszukiwania jednostek zawiera odpowiedź RankingResponse określającą sposób wyświetlania wyników wyszukiwania zwracanych przez interfejs API wyszukiwania jednostek Bing. Ranking odpowiedzi grupuje wyniki w zawartości słupa, linii głównej i paska bocznego. Wynik bieguna jest najważniejszy lub widoczny wynik i powinien być wyświetlany jako pierwszy. Jeśli pozostałe wyniki nie są wyświetlane w tradycyjnym formacie linii głównej i paska bocznego, musisz podać zawartość linii głównej większą widoczność niż zawartość paska bocznego.
W każdej grupie tablica Items identyfikuje kolejność wyświetlania zawartości. Każdy element udostępnia dwa sposoby identyfikowania wyniku w odpowiedzi.
Pole | Opis |
---|---|
answerType i resultIndex |
answerType Identyfikuje odpowiedź (jednostkę lub miejsce) i resultIndex identyfikuje wynik w ramach tej odpowiedzi (na przykład jednostkę). Indeks zaczyna się od 0. |
value |
value Zawiera identyfikator pasujący do identyfikatora odpowiedzi lub wyniku w odpowiedzi. Odpowiedź lub wyniki zawierają identyfikator, ale nie oba. |
Używanie elementu answerType
i resultIndex
jest procesem dwuetapowym. Najpierw użyj polecenia answerType
, aby zidentyfikować odpowiedź zawierającą wyniki do wyświetlenia. Następnie użyj polecenia resultIndex
, aby zaindeksować wyniki tej odpowiedzi, aby uzyskać wynik do wyświetlenia. (Wartość answerType
jest nazwą pola w obiekcie SearchResponse ). Jeśli chcesz wyświetlić wszystkie wyniki odpowiedzi razem, element odpowiedzi klasyfikacji nie zawiera resultIndex
pola.
Użycie identyfikatora wymaga dopasowania identyfikatora klasyfikacji do identyfikatora odpowiedzi lub jednego z jego wyników. Jeśli obiekt odpowiedzi zawiera id
pole, wyświetl wszystkie wyniki odpowiedzi razem. Jeśli na przykład Entities
obiekt zawiera id
pole, wyświetl razem wszystkie artykuły dotyczące jednostek.
Entities
Jeśli obiekt nie zawiera id
pola, każda jednostka zawiera id
pole, a odpowiedź klasyfikacji miesza jednostki z wynikami Miejsca.
Przykład odpowiedzi klasyfikacji
Poniżej przedstawiono przykładową pozycję 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"
}
}
]
}
}
}
Na podstawie tej odpowiedzi klasyfikacji pasek boczny wyświetli dwa wyniki jednostki związane z Jimi Hendrix.