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
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
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
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).”
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
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 serupa.
