ランキングを使用したエンティティ検索結果の表示
警告
2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。 このドキュメントは、参考用としてのみ提供されています。 更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、「Azure Marketplace から Bing Search リソースを作成する」を参照してください。
エンティティ検索の各応答には、RankingResponse 回答が含まれます。これには、Bing Entity Search API によって返される検索結果の表示方法が指定されています。 ランキング応答により、結果がポール コンテンツ、メインライン コンテンツ、およびサイドバー コンテンツにグループ化されます。 ポールの結果は、最も重要または主要な結果であるため、最初に表示する必要があります。 残りの結果を従来のメインラインおよびサイドバー形式で表示しない場合は、メインラインのコンテンツをサイドバーのコンテンツより高い優先度で表示する必要があります。
各グループ内で、Items 配列は、コンテンツの表示順序を指定します。 各項目では、回答内の結果を 2 つの方法で識別できます。
フィールド | 説明 |
---|---|
answerType と resultIndex |
answerType は、回答 (Entity または Place) を識別し、resultIndex は、その回答内の結果を識別します (エンティティなど)。 インデックスは、0 から始まります。 |
value |
value には、回答または回答内の結果の ID に一致する ID が含まれます。 回答または結果のいずれかに ID が含まれています。両方には含まれていません。 |
answerType
と resultIndex
の使用は、2 段階のプロセスです。 最初に、answerType
を使用して、表示する結果が含まれる回答を識別します。 次に、resultIndex
を使用して、その回答の結果にインデックスを付け、表示する結果を取得します。 (answerType
値は、SearchResponse オブジェクト内のフィールドの名前です)。すべての回答の結果を一緒に表示する場合、ランキング応答の項目には、resultIndex
フィールドは含まれません。
ID を使用するには、回答の ID またはその結果の ID とランキング ID とを一致させる必要があります。 回答オブジェクトに id
フィールドが含まれている場合は、すべての回答の結果を一緒に表示します。 例えば、Entities
オブジェクトに id
フィールドが含まれている場合は、すべてのエンティティのアーティクルを一緒に表示します。
Entities
オブジェクトに id
フィールドが含まれていない場合は、各エンティティに id
フィールドが含まれており、ランキング応答によって、エンティティと Places の結果がミックスされます。
ランキング応答の例
次に示すのは、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"
}
}
]
}
}
}
このランキング応答に基づいて、Jimi Hendrix に関連する 2 つのエンティティの結果がサイドバーに表示されます。