

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menyoroti Pencarian Hits di Amazon CloudSearch
<a name="highlighting"></a>

Amazon CloudSearch dapat mengembalikan kutipan dengan hasil pencarian untuk menunjukkan di mana istilah pencarian muncul dalam bidang tertentu dari dokumen yang cocok. Misalnya, dalam kutipan berikut istilah pencarian *luke skywalker* disorot dalam bidang: `plot`

```
highlights": {
    "plot": "After the rebels have been brutally overpowered by the Empire on
    their newly established base, *Luke* *Skywalker* takes advanced Jedi 
    training with Master Yoda, while his friends are pursued by Darth Vader 
    as part of his plan to capture *Luke*."
}
```

Jika Anda mencari frasa, dokumen yang cocok harus berisi frasa itu. Namun, ketika Anda mengambil sorotan, istilah dalam frasa disorot satu per satu. Jika Anda mencari frasa `"Luke Skywalker"` dan mengambil sorotan untuk `plot` bidang seperti yang ditunjukkan pada contoh sebelumnya, istilah `Luke` ini disorot bahkan ketika tidak diikuti oleh`Skywalker`. Sorotan dikembalikan untuk 10 KB data pertama di bidang. Jika bidang berisi lebih dari 10 KB data dan istilah pencarian muncul melewati batas 10 KB, mereka tidak disorot.

Anda bisa mendapatkan sorotan untuk setiap bidang yang diaktifkan sorotan dengan menentukan `highlight.FIELD` parameter dalam permintaan pencarian Anda. Misalnya, untuk mendapatkan sorotan untuk `plot` bidang yang ditampilkan, Anda dapat menentukan yang berikut:

```
search?q=star wars&highlight.plot={}
```

Untuk informasi selengkapnya tentang mengaktifkan bidang untuk menampilkan sorotan, lihat[Mengkonfigurasi Bidang Indeks](configuring-index-fields.md).

Anda dapat mengontrol berapa banyak kemunculan istilah pencarian dalam kutipan yang disorot, bagaimana mereka harus disorot, dan apakah kutipan dikembalikan sebagai teks biasa atau HTML. Ketika Amazon CloudSearch mengembalikan kutipan sebagai HTML, karakter non-alfanumerik diloloskan dengan pengkodean entitas HTML. Ini dilakukan untuk meminimalkan risiko yang terkait dengan penyematan konten HTML yang tidak tepercaya, karena bidang tersebut mungkin awalnya diisi dengan konten buatan pengguna. 

Anda menentukan opsi sorotan sebagai objek JSON. Jika objek JSON kosong`highlight.FIELD={}`, Amazon CloudSearch menyoroti semua kemunculan istilah pencarian dengan melampirkannya dalam tag penekanan HTML, <em>*istilah*</em>, dan kutipan dikembalikan sebagai HTML. 
+ Untuk menentukan apakah kutipan harus dikembalikan sebagai `text` atau`html`, gunakan `format` opsi; misalnya,. `highlight.plot={format:'text'}`
+ Untuk menentukan jumlah maksimum kemunculan istilah pencarian yang ingin Anda sorot, gunakan `max_phrases` opsi; misalnya,`highlight.plot={max_phrases:3}`. Defaultnya adalah 1, maksimum adalah 5.
+ Untuk menentukan string yang akan ditambahkan ke setiap istilah yang disorot, gunakan `pre_tag` opsi; misalnya,. `highlight.plot={pre_tag:'<strong>', post_tag:'</strong>'}`
+ Untuk menentukan string yang akan ditambahkan ke setiap istilah yang disorot, gunakan `post_tag` opsi; misalnya,`highlight.plot={pre_tag:'<strong>', post_tag:'</strong>'}`.