Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membalikkan Geocode
Reverse Geocode mengubah koordinat geografis menjadi alamat atau tempat yang dapat dibaca manusia. Ini menyediakan komponen alamat terperinci, jenis tempat, kategori, dan informasi jalan, dengan opsi penyaringan berdasarkan jenis tempat untuk menyempurnakan hasil. API juga dapat menyertakan fitur tambahan, seperti informasi zona waktu dan penyesuaian tampilan politik.
**catatan**
Jika hasil disimpan, mereka akan ditagih pada tingkat harga Penyimpanan yang lebih tinggi. Gunakan `IntendedUse` parameter untuk menentukan apakah hasilnya untuk penggunaan tunggal atau penyimpanan. Lihat implikasi [Harga tempat](places-pricing.md) biaya yang terkait dengan hasil yang disimpan.
Untuk informasi selengkapnya, lihat [ReverseGeocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html)di *Referensi API Amazon Location Service*.
Misalnya perintah request, response, cURL, dan CLI untuk API ini, lihat [Cara](https://docs.aws.amazon.com/location/latest/developerguide/reverse-geocode-how-to.html) menggunakan Reverse Geocode.
## Kasus penggunaan
+ **Tambahkan data tambahan ke data posisi pelanggan:** Tingkatkan catatan data posisi dengan memasukkan kode pos, koordinat, dan memanfaatkan penyimpanan persisten untuk mendukung keputusan bisnis dan pemasaran yang terinformasi.
+ **Standarisasi data posisi:** Menerapkan geocoding dalam pipeline data atau proses batch untuk menstandarisasi data posisi, memanfaatkan penyimpanan persisten untuk referensi yang sedang berlangsung.
+ **Tentukan zona waktu:** Identifikasi zona waktu untuk kota atau alamat untuk memberikan stempel waktu yang akurat untuk aplikasi seperti perjalanan, penjadwalan, dan faktur.
## Pahami permintaannya
**catatan**
Untuk pelanggan di `ap-southeast-1` dan`ap-southeast-5`, bidang permintaan dan respons yang didukung mungkin berbeda. Lihat [Referensi ReverseGeocode API](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html) untuk detailnya.
Permintaan Reverse Geocode API menerima kombinasi parameter wajib dan opsional untuk menyesuaikan hasil. Parameter yang diperlukan `QueryPosition` (bujur dan lintang) menentukan koordinat untuk membalikkan geocode. Parameter opsional termasuk `AdditionalFeatures` untuk data tambahan, `Filter` untuk menyempurnakan hasil, dan `MaxResults` untuk membatasi jumlah hasil yang dikembalikan. Opsi tambahan seperti`Language`,`PoliticalView`, dan `IntendedUse` memungkinkan penyesuaian lebih lanjut. Untuk detail selengkapnya, lihat Referensi API Geocode Terbalik.
Permintaan menerima parameter kunci berikut:
**Autentikasi**
`Key`Parameter ini opsional jika metode otentikasi lain digunakan.
+ `Key`: Parameter opsional untuk otentikasi.
Untuk informasi selengkapnya, lihat [Autentikasi dengan Amazon Location Service](access.md).
**Meminta**
Parameter yang digunakan untuk menentukan lokasi geografis dan radius pencarian.
+ `QueryPosition`: Menentukan bujur dan lintang untuk permintaan geocode terbalik.
+ `QueryRadius`: Mendefinisikan radius pencarian di sekitar koordinat.
Untuk informasi selengkapnya, lihat [Query dan bias](places-querying-biasing.md).
**Hasil penyempurnaan**
Terapkan filter untuk membatasi hasil pencarian ke negara atau jenis tempat tertentu.
+ `Filter`: Filter untuk hasil berdasarkan negara atau jenis tempat.
Untuk detail selengkapnya, lihat [Pemfilteran](places-filtering.md).
**Internasionalisasi dan lokalisasi**
Pilihan untuk menyesuaikan bahasa dan menerapkan pandangan politik ke hasil.
+ `Language`: Menentukan bahasa hasil.
+ `PoliticalView`: Menerapkan pandangan politik yang mencerminkan klaim teritorial.
Untuk informasi selengkapnya, lihat [Lokalisasi dan internasionalisasi](places-localization-internationalization.md).
**Fitur tambahan**
Meminta data tambahan, seperti informasi zona waktu.
+ `AdditionalFeatures`: Opsi untuk meminta data tambahan seperti detail zona waktu.
Untuk informasi selengkapnya, lihat [Fitur tambahan](additional-features.md).
## Pahami tanggapannya
Respons dari Reverse Geocode API memberikan informasi rinci tentang lokasi pada koordinat yang ditentukan. `ResultItems`Array mencakup daftar objek tempat, masing-masing berisi rincian alamat, kategori, dan posisi geografis. Data tambahan seperti`TimeZone`,`FoodTypes`, dan `PostalCodeDetails` menawarkan konteks lebih lanjut. Respons juga mencakup informasi kotak pembatas untuk pemetaan dan jarak dari posisi kueri. Untuk detail selengkapnya, lihat Referensi API Geocode Terbalik.
Tanggapan tersebut mencakup data kunci berikut:
**Alamat dan detail terkait**
Informasi alamat terperinci untuk lokasi yang dikembalikan.
+ `Address`: Informasi alamat lengkap, termasuk negara, wilayah, kode pos, dan detail jalan.
+ `PostalCodeDetails`: Rincian tambahan terkait dengan kode pos, seperti klasifikasi dan otoritas pos.
+ `StreetComponents`: Detail tambahan tentang jalan, termasuk nama dasar dan jenis.
**Jenis dan kategori tempat**
Menjelaskan jenis dan kategori tempat yang dikembalikan.
+ `Categories`Kategori yang menggambarkan tempat, seperti *Restoran* atau *Sekolah*.
+ `PlaceType`: Menentukan jenis tempat, seperti kota, alamat, atau wilayah.
**Analisis hasil**
Informasi tentang seberapa dekat setiap hasil cocok dengan kueri masukan.
+ `MatchScores`: Skor yang menunjukkan keakuratan setiap kecocokan dengan kueri input.
**Detail tambahan**
Menyediakan data terkait lokasi tambahan.
+ `TimeZone`: Informasi zona waktu untuk lokasi.
+ `AccessPoints`Koordinat geografis yang mewakili titik masuk ke lokasi.