Menggunakan pangkat untuk menampilkan hasil pencarian entitas
Peringatan
Pada 30 Oktober 2020, API Bing Search dipindahkan dari layanan Azure AI ke layanan Bing Search. Dokumentasi ini disediakan hanya untuk referensi. Untuk dokumentasi terbaru, lihat dokumentasi Bing Search API. Untuk petunjuk tentang cara membuat sumber daya Azure baru untuk pencarian Bing, lihat Membuat sumber daya Pencarian Bing melalui Marketplace Azure.
Setiap respons pencarian entitas menyertakan jawaban RankingResponse yang menentukan bagaimana Anda harus menampilkan hasil pencarian yang dikembalikan oleh API Pencarian Entitas Bing. Grup respons pangkat menghasilkan konten tiang, mainline, dan sidebar. Hasil tiang adalah hasil yang paling penting atau menonjol dan harus ditampilkan terlebih dahulu. Jika Anda tidak menampilkan hasil yang tersisa dalam format utama dan bilah samping tradisional, Anda harus memberikan visibilitas konten utama yang lebih tinggi daripada konten bilah samping.
Di dalam setiap grup, array Item mengidentifikasi urutan konten harus muncul. Setiap item menyediakan dua cara untuk mengidentifikasi hasil dalam jawaban.
| Bidang | Deskripsi |
|---|---|
answerType dan resultIndex |
answerType mengidentifikasi jawaban (Entitas atau Tempat) dan resultIndex mengidentifikasi hasil dalam jawaban tersebut (misalnya, entitas). Indeks dimulai pada 0. |
value |
value Berisi ID yang cocok dengan ID jawaban atau hasil dalam jawaban. Entah jawaban atau hasilnya berisi ID tetapi tidak keduanya. |
Menggunakan answerType dan resultIndex merupakan proses dua langkah. Pertama, gunakan answerType untuk mengidentifikasi jawaban yang berisi hasil untuk ditampilkan. Kemudian gunakan resultIndex untuk mengindeks hasil jawaban tersebut untuk mendapatkan hasilnya untuk ditampilkan. (Nilai answerType adalah nama bidang di objek SearchResponse.) Jika Anda seharusnya menampilkan semua hasil jawaban bersama-sama, item respons pangkat tidak menyertakan bidang resultIndex.
Menggunakan ID mengharuskan Anda untuk mencocokkan ID pangkat dengan ID jawaban atau salah satu hasilnya. Jika objek jawaban menyertakan bidang id, tampilkan semua hasil jawaban bersama-sama. Misalnya, jika objek Entities menyertakan bidang id, tampilkan semua artikel entitas bersama-sama. Jika objek Entities tidak menyertakan bidang id, maka setiap entitas berisi id bidang dan respons pangkat mencampur entitas dengan hasil Places.
Contoh respons pangkat
Berikut ini menunjukkan contoh 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"
}
}
]
}
}
}
Berdasarkan tanggapan pangkat ini, sidebar akan menampilkan dua hasil entitas yang terkait dengan Jimi Hendrix.