Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Geocoding
Geocoding adalah proses yang mengubah teks, seperti alamat, wilayah, nama bisnis, atau tempat menarik, menjadi satu set koordinat geografis. Anda dapat menggunakan sumber daya indeks tempat untuk mengirimkan permintaan geocoding dan menggabungkan data yang diambil dari geocoding untuk menampilkan data pada peta untuk web atau aplikasi seluler Anda.
Bagian ini memandu Anda melalui cara mengirim permintaan geocoding sederhana, dan cara mengirim permintaan geocoding dengan spesifikasi opsional.
Geocoding
Anda dapat mengirimkan permintaan sederhana ke geocode menggunakan SearchPlaceIndexForText operasi untuk mengonversi alamat ke satu set koordinat. Permintaan sederhana berisi parameter yang diperlukan berikut:
-
Text— Alamat, nama, kota, atau wilayah untuk dikonversi ke satu set koordinat. Misalnya, stringAny Town.
Untuk menentukan jumlah maksimum hasil per halaman, gunakan parameter opsional berikut:
-
MaxResults— Membatasi jumlah maksimum hasil yang dikembalikan dalam respons kueri.
Anda dapat menggunakan AWS CLI atau Amazon Location API.
Geocode dekat posisi
Saat geocoding, Anda dapat melakukan geocode di dekat posisi tertentu dengan parameter opsional berikut:
-
BiasPosition— Posisi yang ingin Anda cari di dekatnya. Ini mempersempit pencarian Anda dengan mencari hasil yang paling dekat dengan posisi yang diberikan. Didefinisikan sebagai[longitude, latitude]
Contoh berikut adalah SearchPlaceIndexForText permintaan untuk mencari sumber daya indeks tempat untuk alamat, nama, kota atau wilayah yang disebut Kota Mana-mana di dekat posisi [-123.4567, 45.6789].
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "BiasPosition": [-123.4567,45.6789] }
Geocode dalam kotak pembatas
Anda dapat melakukan geocode dalam kotak pembatas untuk mempersempit hasil Anda ke koordinat dalam batas tertentu menggunakan parameter opsional berikut:
-
FilterBBox— Kotak pembatas yang Anda tentukan untuk memfilter hasil Anda ke koordinat dalam batas-batas kotak. Didefinisikan sebagai[LongitudeSW, LatitudeSW, LongitudeNE, LatitudeNE]catatan
Permintaan tidak dapat berisi parameter
FilterBBoxdanBiasPositionparameter. Menentukan kedua parameter dalam permintaan mengembalikanValidationExceptionkesalahan.
Contoh berikut adalah SearchPlaceIndexForText permintaan untuk mencari di dalam kotak pembatas untuk alamat, nama, kota atau wilayah yang disebut Kota Apa Pun. Kotak pembatas mengikuti itu:
-
Garis bujur sudut barat daya adalah -124.1450. -
Garis lintang sudut barat daya adalah 41.7045. -
Garis bujur sudut timur laut adalah -124.1387. -
Garis lintang sudut timur laut adalah 41.7096.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterBBox": [-124.1450,41.7045,-124.1387,41.7096] }
Geocode dalam suatu negara
Anda dapat melakukan geocode dalam satu atau beberapa negara yang Anda tentukan dengan menggunakan parameter opsional berikut:
-
FilterCountries— Negara atau wilayah yang ingin Anda geocode di dalamnya. Anda dapat menentukan hingga 100 negara dalam satu permintaan menggunakan kode negara tiga huruf ISO 3166. Misalnya, gunakan AUSuntuk Australia.
Contoh berikut adalah SearchPlaceIndexForText permintaan untuk mencari alamat, nama, kota atau wilayah yang disebut Kota Mana-mana di Jerman dan Prancis.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterCountries": ["DEU","FRA"] }
Pemfilteran berdasarkan kategori
Anda dapat memfilter kategori yang dikembalikan dalam permintaan geocode Anda dengan menggunakan parameter opsional berikut:
-
FilterCategories— Kategori hasil yang ingin Anda kembalikan dalam kueri Anda. Anda dapat menentukan hingga 5 kategori dalam satu permintaan. Anda dapat menemukan daftar kategori Amazon Location Service di bagian Kategori. Misalnya, Anda dapat menentukanHoteluntuk menentukan hanya hotel yang kembali dalam kueri Anda.
Contoh berikut adalah SearchPlaceIndexForText permintaan untuk mencari kedai kopi yang disebut Hometown Coffé di Amerika Serikat.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Hometown Coffee", "FilterCategories": ["Coffee Shop"], "FilterCountries": ["USA"] }
Untuk detail selengkapnya tentang pemfilteran pada kategori, lihat Tempatkan kategori dan hasil penyaringan
Geocode dalam bahasa pilihan
Anda dapat mengatur preferensi bahasa untuk hasil pencarian Anda dengan menggunakan Language parameter opsional. Misalnya, pencarian 100 Main
St, Anytown, USA dapat kembali secara 100 Main St, Any Town,
USA default. Tetapi jika Anda memilih fr sebagaiLanguage, maka hasilnya mungkin kembali 100 Rue
Principale, Any Town, États-Unis sebagai gantinya.
-
Language— Kode bahasa yang digunakan untuk merender hasil kueri Anda. Nilai harus berupa kode bahasa BCP 47yang valid. Misalnya, enuntuk bahasa Inggris.
catatan
Jika tidak Language ditentukan, atau bahasa yang ditentukan tidak didukung untuk hasil, bahasa default mitra untuk hasil tersebut akan digunakan.
Contoh berikut adalah SearchPlaceIndexforText permintaan untuk mencari tempat yang dipanggil Any Town dengan bahasa pilihan yang ditentukan sebagaide.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "Language": "de" }
Contoh tanggapan
Berikut ini adalah contoh respons saat Anda memanggil SearchPlaceIndexForText operasi dari Amazon Location Places API. Hasilnya termasuk tempat yang relevan dan ringkasan permintaan. Dua tanggapan ditampilkan, berdasarkan memilih Esri atau HERE sebagai mitra.
