Geocode - Amazon Location Service
Kasus penggunaanPahami permintaannyaPahami tanggapannya

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 untuk memahami implikasi biaya untuk hasil yang disimpan.

Untuk informasi selengkapnya, lihat Geocode di Referensi API Amazon Location Service.

Misalnya permintaan, tanggapan, cURL, dan perintah CLI untuk API ini, lihat Cara 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, sepertiAdditionalFeatures,, dan BiasPositionFilter, untuk menyempurnakan hasil pencarian. Opsi tambahan, sepertiLanguage,MaxResults, danPoliticalView, memberikan penyesuaian respons lebih lanjut. Parameter yang diperlukan adalahQuery, 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

Query dan bias

Parameter yang digunakan untuk query dan bias geografis hasil.

  • QueryText: Kueri teks bentuk bebas untuk mencari lokasi.

  • QueryComponentsKomponen 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

Hasil Penyempurnaan

Terapkan filter untuk menyempurnakan hasil.

  • Filter: Filter untuk memasukkan negara atau jenis tempat tertentu. Untuk informasi selengkapnya, lihat Penyaringan.

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

Fitur Tambahan

Minta informasi tambahan seperti detail zona waktu.

  • AdditionalFeatures: Opsi untuk meminta detail tambahan seperti zona waktu. Untuk informasi selengkapnya, lihat Fitur tambahan.

Pahami tanggapannya

Respons menyediakanResultItems, yang berisi data lokasi terperinci sepertiAddress,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 atauPostalCode) 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, jikaAddressNumber,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 (sepertiStreet), 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.

  • AccessPointsKoordinat geografis yang mewakili titik akses.

  • TimeZone: Informasi zona waktu untuk lokasi.