Geocoding API adalah layanan web yang mengonversi alamat menjadi koordinat dan ID Tempat, serta mengonversi koordinat atau ID Tempat menjadi alamat. Metode SearchDestinations v4-nya juga menampilkan detail tujuan seperti pintu masuk bangunan, titik navigasi, garis batas bangunan dan halaman, serta tempat terkenal di sekitar.
Geocoding API: fakta penting
- Produk: Geocoding API
- Kategori: Tempat
- Platform: Layanan web (REST)
- Berjalan di: Server (kode backend)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Geocoding API
Geocoding API: kapan harus menggunakannya
Gunakan Geocoding API jika:
- Anda perlu mengonversi alamat menjadi koordinat lintang/bujur dan ID Tempat di server backend Anda.
- Anda memerlukan alamat tampilan atau wilayah administratif (kota, kode pos) untuk koordinat GPS atau ID Tempat yang diketahui.
- Anda memerlukan pintu masuk bangunan, titik navigasi yang dapat dirutekan, atau garis batas bangunan/lahan untuk mengarahkan pengemudi atau kurir ke tujuan.
- Anda perlu menyelesaikan tujuan di dalam kompleks besar (bandara, mal, kampus) menjadi subtujuan atau tempat terkenal di sekitar.
Jangan gunakan Geocoding API jika:
- Anda memerlukan geocoding dari JavaScript browser sisi klien; memanggil v4 dengan kunci API yang terekspos merupakan risiko keamanan. Gunakan Maps JavaScript API.
- Anda perlu menghitung rute atau perkiraan waktu tiba (ETA) ke tujuan yang di-geocoding. Gunakan Routes API.
- Anda memerlukan panduan belokan demi belokan ke token titik navigasi di aplikasi Android. Gunakan Navigation SDK for Android.
- Anda memerlukan panduan belokan demi belokan ke token titik navigasi di aplikasi iOS. Gunakan Navigation SDK for iOS.
Geocoding API: penyiapan
- Layanan yang akan diaktifkan:
geocoding-backend.googleapis.com - Autentikasi: Kunci API, OAuth 2.0, Akun layanan
- Memulai: Menyiapkan Geocoding API
- Referensi: Referensi Geocoding API
- Harga: Penggunaan dan penagihan Geocoding API
- Kebijakan: Kebijakan Geocoding API
- Catatan rilis: Catatan rilis Geocoding API
Geocoding API: produk terkait
- Sering digunakan dengan: Routes API, Navigation SDK for Android, Navigation SDK for iOS
Geocoding API: kesalahan umum
- Masalah: Permintaan
SearchDestinationstanpa mask kolom akan gagal dan menampilkan error; tidak sepertiGeocodeAddress,GeocodeLocation, danGeocodePlace, mask kolom diperlukan. Perbaikan: Tetapkan headerX-Goog-FieldMaskatau parameter$fieldspada setiap permintaanSearchDestinations. Lihat /maps/documentation/geocoding/choose-fields. - Masalah:
GeocodeAddressv4 tidak memiliki filter komponen yang ketat (components=country:USv3). Parameteraddress.*terstruktur digabungkan menjadi satu alamat dan tidak memfilter hasil;regionCodejuga tidak memiliki default di v4 (v3 ditetapkan secara default keus). Perbaikan: Filterresultsdi sisi klien: cocokkanregionCodedalam huruf besar denganpostalAddress.regionCode; cocokkan wilayah admin 2 huruf dalam huruf besar denganpostalAddress.administrativeAreadanadministrative_area_level_naddressComponents(shortText); normalkan input danpostalAddress.postalCode(hapus spasi/tanda hubung dan terapkan aturan wilayah). Lihat /maps/documentation/geocoding/geocoding-v4-migrate. - Masalah: Memanggil Geocoding API v4 langsung dari JavaScript browser akan mengekspos kunci API; pembatasan perujuk HTTP dapat diabaikan dengan memalsukan header
Referer. Perbaikan: Panggil v4 dari backend Anda sendiri dengan kunci yang dilindungi, atau gunakan Layanan Geocoding Maps JavaScript API (backend v3) untuk kebutuhan sisi klien. Lihat /maps/documentation/geocoding/geocoding-v4-migrate. - Masalah:
SearchDestinationsdapat menampilkan hasil yang tidak memiliki alamat utama yang akurat, tidak seperti v3 dan metode v4 lainnya. Perbaikan: TetapkanplaceFilter.addressabilitykePRIMARYjika Anda hanya memerlukan hasil dengan alamat utama yang akurat. Lihat /maps/documentation/geocoding/geocoding-v4-migrate. - Masalah: Kode yang ditulis untuk Geocoding API v3 tidak berfungsi pada respons REST v4: v4 menggunakan nama kolom lowerCamelCase (
addressComponents, bukanaddress_components), menghapusstatusdanerror_message, serta menampilkan satu objek root dariGeocodePlace, bukan arrayresults. Perbaikan: Periksa kode status HTTP dan isi error pada panggilan REST v4, baca kolom lowerCamelCase (addressComponents,postalAddress), dan perhatikan bahwa respons gRPC masih menggunakan snake_case. Lihat /maps/documentation/geocoding/geocoding-v4-migrate.
Geocoding API: fitur lama dan tidak digunakan lagi
- Data hiperlokal Geocoding API v3 (
extra_computations:BUILDING_AND_ENTRANCES,NAVIGATION_POINTS,GROUNDS; kolom responsbuildings.entrances,navigation_points,buildings.building_outlines,grounds): Tidak digunakan lagi sejak 13-08-2025. Pengganti: MetodeSearchDestinationsGeocoding API v4 (POST /v4/geocode/destinations). Lihat panduan migrasi.
Yang dapat Anda lakukan dengan Geocoding API
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.
- Menampilkan koordinat lintang/bujur alamat (geocoding).
- Menampilkan alamat untuk sekumpulan koordinat lintang/bujur (geocoding terbalik).
- Membatasi permintaan geocoding untuk menampilkan hasil dalam area pandang tertentu. Catatan: Di Geocoding API v4, locationBias membiaskan hasil ke area pandang yang ditentukan, bukan membatasinya secara ketat.
- Batasi permintaan geocoding atau geocoding terbalik agar hanya menampilkan hasil dalam wilayah, negara, atau kode pos tertentu. Catatan: Di Geocoding API v4, regionCode membiaskan hasil ke wilayah CLDR yang ditentukan, bukan membatasinya secara ketat; untuk pemfilteran komponen v3 lama menurut negara atau kode pos, lihat https://developers.google.com/maps/documentation/geocoding/guides-v3/requests-geocoding#ComponentFiltering.
- Membatasi permintaan geocoding terbalik agar hanya menampilkan hasil untuk jenis alamat yang ditentukan. Catatan: Di Geocoding API v4, parameter types memfilter hasil geocoding terbalik yang ditampilkan berdasarkan jenis alamat setelah penelusuran, bukan membatasi penelusuran yang mendasarinya.
- Menampilkan informasi tentang kedekatan dengan tempat terkenal atau area untuk suatu alamat.
- Menampilkan informasi tentang kedekatan dengan tempat terkenal atau area untuk serangkaian koordinat lintang/bujur.
- Menampilkan informasi tentang kedekatan dengan tempat terkenal atau area untuk ID tempat Google.
- Menampilkan alamat untuk ID tempat Google.
- Menampilkan koordinat lintang/bujur batas bangunan untuk suatu alamat.
- Menampilkan koordinat lintang/bujur garis batas bangunan untuk sekumpulan koordinat lintang/bujur.
- Menampilkan koordinat lintang/bujur batas bangunan untuk ID Tempat Google.
- Menampilkan koordinat lintang/bujur pintu masuk bangunan untuk sebuah alamat.
- Menampilkan koordinat lintang/bujur pintu masuk bangunan untuk sekumpulan koordinat lintang/bujur.
- Menampilkan koordinat lintang/bujur pintu masuk bangunan untuk ID Google Place.