Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Geocode
Geocoding mengubah alamat tekstual atau nama tempat menjadi koordinat geografis, bersama dengan komponen alamat rinci dan informasi tambahan. API ini mendukung kueri fleksibel, termasuk teks bentuk bebas dan kueri terstruktur dengan nama jalan, kode pos, dan wilayah. Fitur opsional termasuk data zona waktu dan penyesuaian tampilan politik.
**catatan**
Hasil yang disimpan menghasilkan harga Penyimpanan yang lebih tinggi. Gunakan `IntendedUse` parameter untuk menunjukkan penggunaan tunggal atau penyimpanan. Lihat [Harga tempat](places-pricing.md) untuk memahami implikasi biaya untuk hasil yang disimpan.
Untuk informasi selengkapnya, lihat [Geocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Geocode.html) di *Referensi API Amazon Location Service*.
Misalnya permintaan, tanggapan, cURL, dan perintah CLI untuk API ini, lihat [Cara](https://docs.aws.amazon.com/location/latest/developerguide/how-to-geocode.html) menggunakan Geocode.
## Kasus penggunaan
+ **Tambahkan data tambahan ke alamat pelanggan:** Tingkatkan catatan alamat dengan memasukkan kode pos, koordinat, dan memanfaatkan penyimpanan persisten untuk mendukung keputusan bisnis dan pemasaran yang terinformasi.
+ **Standardisasi Data Alamat:** Menerapkan geocoding dalam pipeline data atau proses batch untuk menstandarisasi data alamat, 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
Permintaan menerima parameter opsional, seperti`AdditionalFeatures`,, dan `BiasPosition``Filter`, untuk menyempurnakan hasil pencarian. Opsi tambahan, seperti`Language`,`MaxResults`, dan`PoliticalView`, memberikan penyesuaian respons lebih lanjut. Parameter yang diperlukan adalah`Query`, yang dapat disediakan sebagai teks bentuk bebas atau terstruktur sebagai. `QueryComponents` Untuk informasi selengkapnya, lihat Referensi API Geocode.
Permintaan tersebut mencakup parameter kunci berikut:
**Autentikasi**
Untuk otentikasi, `Key` parameter opsional jika metode lain sedang digunakan.
+ `Key`: Parameter opsional untuk otentikasi.
Untuk informasi selengkapnya, lihat [Autentikasi dengan Amazon Location Service](access.md)
**Query dan bias**
Parameter yang digunakan untuk query dan bias geografis hasil.
+ `QueryText`: Kueri teks bentuk bebas untuk mencari lokasi.
+ `QueryComponents`Komponen terstruktur seperti nomor alamat, negara, lokalitas, atau kode pos untuk pencarian yang tepat.
+ `BiasPosition`: Posisi geografis untuk membiaskan hasil pencarian ke arah.
Untuk informasi selengkapnya, lihat [Query dan bias](places-querying-biasing.md)
**Hasil Penyempurnaan**
Terapkan filter untuk menyempurnakan hasil.
+ `Filter`: Filter untuk memasukkan negara atau jenis tempat tertentu. Untuk informasi selengkapnya, lihat [Pemfilteran](places-filtering.md).
**Internasionalisasi dan lokalisasi**
Tentukan bahasa dan terapkan tampilan politik untuk hasil yang dilokalkan.
+ `Language`: Bahasa untuk hasil.
+ `PoliticalView`: Menerapkan pandangan politik yang mencerminkan klaim teritorial.
Untuk informasi selengkapnya, lihat [Lokalisasi dan internasionalisasi](places-localization-internationalization.md)
**Fitur Tambahan**
Minta informasi tambahan seperti detail zona waktu.
+ `AdditionalFeatures`: Opsi untuk meminta detail tambahan seperti zona waktu. Untuk informasi selengkapnya, lihat [Fitur tambahan](additional-features.md).
## Pahami tanggapannya
Respons menyediakan`ResultItems`, yang berisi data lokasi terperinci seperti`Address`,`PlaceId`,`Position`, dan atribut relevan lainnya. Fitur tambahan seperti `TimeZone` informasi atau `MatchScores` untuk setiap komponen kueri juga dapat disertakan. Masing-masing `ResultItem` mewakili lokasi yang cocok atau hasil geocoding berdasarkan parameter permintaan yang ditentukan. Untuk detail lebih lanjut, lihat Referensi API Geocode.
Respons mencakup parameter kunci berikut:
**Alamat dan detail terkait**
Detail tentang lokasi yang dikembalikan, termasuk komponen alamat.
+ `Address`: Alamat lengkap termasuk negara, wilayah, kode pos, dan detail jalan.
+ `PostalCodeDetails`: Informasi tambahan terkait kode pos.
+ `StreetComponents`: Detail jalan termasuk nama dasar dan jenis.
**Jenis dan kategori tempat**
Informasi tentang jenis dan kategori tempat yang dikembalikan.
+ `Categories`: Daftar kategori yang menggambarkan tempat, misalnya *Restoran*, *Sekolah*.
+ `PlaceType`: Menentukan jenis tempat, seperti kota, alamat, atau wilayah.
**Analisis hasil**
Skor yang menunjukkan seberapa dekat hasil cocok dengan kueri masukan.
+ `MatchScores`: Skor untuk pencocokan presisi.
+ `Overall`: Mengukur seberapa baik pencarian alamat cocok dengan input Anda, pada skala dari 0,0 hingga 1,0 (0% hingga 100%). Skor sempurna 1.0 berarti setiap bagian dari pencarian Anda ditemukan dalam database. Adalah normal untuk melihat skor yang lebih rendah ketika menyertakan detail tambahan seperti nama kontak atau instruksi pengiriman. Ini secara alami mengurangi skor, tetapi tidak selalu berarti alamatnya salah.
+ `Component Score`: Setiap komponen alamat (seperti `AddressNumber` atau`PostalCode`) dinilai secara individual pada skala 0,0 hingga 1,0 (0% hingga 100%). Skor ini menunjukkan seberapa akurat setiap bagian alamat cocok dengan hasilnya. Misalnya, jika`AddressNumber`,`Street`, dan `PostalCode` skor mendekati 1,0, Anda dapat mempercayai pertandingan bahkan jika skor keseluruhan lebih rendah karena detail kueri lainnya.
**catatan**
Ketika tidak ada skor yang muncul untuk komponen tertentu (seperti`Street`), komponen tersebut dihitung sebagai 0. Ini membantu mengidentifikasi bagian-bagian dari alamat yang mungkin memerlukan verifikasi.
Sistem penilaian ini membantu menyeimbangkan antara kecocokan yang tepat dan kegunaan praktis ketika berhadapan dengan pencarian alamat dunia nyata yang sering menyertakan informasi tambahan.
**Detail tambahan**
Termasuk informasi terkait lokasi tambahan sesuai kebutuhan.
+ `AccessPoints`Koordinat geografis yang mewakili titik akses.
+ `TimeZone`: Informasi zona waktu untuk lokasi.