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

# Pilih rute menggunakan Sarankan dan kemampuan untuk menyorot istilah kueri yang cocok
<a name="suggest-highlight-matched-query-terms"></a>

Dengan Suggest API, Anda mendapatkan saran pelengkapan otomatis real-time saat pengguna mengetik kueri penelusuran mereka untuk tempat atau kategori. Hasil diberi peringkat berdasarkan relevansi, dengan pertandingan yang paling mungkin muncul pertama. Respons API mencakup penyorotan informasi yang menunjukkan bagaimana setiap saran cocok dengan kueri pengguna.

## Kasus penggunaan potensial
<a name="suggest-disambiguate-results-potential-use"></a>

Gunakan penyorotan untuk menunjukkan kepada pengguna bagian mana dari setiap saran yang cocok dengan input mereka, sehingga lebih mudah untuk memilih hasil yang diinginkan dengan cepat.

## Contoh
<a name="suggest-hightlight-results-examples"></a>

Saat menampilkan daftar hasil kepada pengguna, bidang **Sorotan** dalam respons dapat digunakan untuk membantu pengguna mengidentifikasi bagaimana input telah dicocokkan dengan hasil. Pada contoh di bawah ini, pengguna membuat kueri untuk “Effel tow”. Ini cocok dengan **Judul** “Tour Eiffel (Menara Eiffel)”. **Menggunakan bidang hasil Sorotan, hasilnya dapat ditata untuk menunjukkan di mana kueri input dicocokkan dengan output, sehingga teks ditampilkan kepada pengguna sebagai “Tour Eiffel (Eiffel Tow er).”**

### Sorot hasil kueri dengan Suggest API
<a name="suggest-hightlight-example"></a>

Contoh ini menunjukkan cara menggunakan Suggest API untuk mencari tempat menarik yang salah eja.

------
#### [ Sample request ]

```
{
  "QueryText": "Effel tow",
  "Filter": {
    "Circle": {
      "Radius": 10000,
      "Center": [
        2.3431932014695382, 48.858844492141145
      ]
    },
    "IncludeCountries": [
      "FRA"
    ]
  },
  "AdditionalFeatures": [
    "Core"
  ]
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "Title": "Tour Eiffel (Eiffel Tower)",
            "SuggestResultItemType": "Place",
            "Place": {
                "PlaceId": "<Redacted>",
                "PlaceType": "PointOfInterest",
                "Address": {
                    "Label": "Tour Eiffel, * Avenue Anatole France, ***** Paris, France",
                    "Country": {
                        "Code2": "FR",
                        "Code3": "FRA",
                        "Name": "France"
                    },
                    "Region": {
                        "Code": "IDF",
                        "Name": "Île-de-France"
                    },
                    "SubRegion": {
                        "Name": "Paris"
                    },
                    "Locality": "Paris",
                    "District": "*e Arrondissement",
                    "PostalCode": "*****",
                    "Street": "Avenue Anatole France",
                    "StreetComponents": [
                        {
                            "BaseName": "Anatole France",
                            "Type": "Avenue",
                            "TypePlacement": "BeforeBaseName",
                            "TypeSeparator": " ",
                            "Language": "fr"
                        }
                    ],
                    "AddressNumber": "5"
                },
                "Position": [
                    2.2945,
                    48.85824
                ],
                "Distance": 3563,
                "Categories": [
                    {
                        "Id": "historical_monument",
                        "Name": "Historical Monument",
                        "LocalizedName": "Monument historique",
                        "Primary": true
                    },
                    {
                        "Id": "landmark-attraction",
                        "Name": "Landmark-Attraction",
                        "LocalizedName": "Lieu d'intérêt/Attraction",
                        "Primary": false
                    },
                    {
                        "Id": "tourist_attraction",
                        "Name": "Tourist Attraction",
                        "LocalizedName": "Attraction touristique",
                        "Primary": false
                    },
                    {
                        "Id": "sports_complex-stadium",
                        "Name": "Sports Complex-Stadium",
                        "LocalizedName": "Stade ou complexe sportif",
                        "Primary": false
                    }
                ]
            },
            "Highlights": {
                "Title": [
                    {
                        "StartIndex": 13,
                        "EndIndex": 23,
                        "Value": "Eiffel Tow"
                    }
                ],
                "Address": {}
            }
        }
    ],
    "QueryRefinements": []
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/suggest?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "Effel tow",
  "Filter": {
    "Circle": {
      "Radius": 10000,
      "Center": [
        2.3431932014695382, 48.858844492141145
      ]
    },
    "IncludeCountries": [
      "FRA"
    ]
  },
  "AdditionalFeatures": [
    "Core"
  ]
}'
```

------
#### [ AWS CLI ]

```
aws geo-places suggest --key ${YourKey} \
--query-text "Effel tow" \
--filter '{"Circle": {"Radius": 10000, "Center": [2.3431932014695382, 48.858844492141145]}, "IncludeCountries": ["FRA"]}' \
--additional-features "Core"
```

------

## Kiat pengembang
<a name="suggest-highlight-developer-tips"></a>

Menampilkan hasil penelusuran menggunakan bidang `Title` respons untuk memberi pengguna entri yang ringkas dan dapat dikenali. Untuk hasil yang mungkin terlihat serupa, gunakan `Place.Address.Label` bidang untuk menampilkan detail alamat tambahan yang membantu pengguna membedakannya. Lihat informasi yang lebih lengkap di [Cara membantu pengguna membedakan antara hasil yang serupaSingkapkan hasilnya dengan Suggest API](suggest-disambiguate-results.md).