Referensi cepat Geocoding API

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

Geocoding API: kesalahan umum

  • Masalah: Permintaan SearchDestinations tanpa mask kolom akan gagal dan menampilkan error; tidak seperti GeocodeAddress, GeocodeLocation, dan GeocodePlace, mask kolom diperlukan. Perbaikan: Tetapkan header X-Goog-FieldMask atau parameter $fields pada setiap permintaan SearchDestinations. Lihat /maps/documentation/geocoding/choose-fields.
  • Masalah: GeocodeAddress v4 tidak memiliki filter komponen yang ketat (components=country:US v3). Parameter address.* terstruktur digabungkan menjadi satu alamat dan tidak memfilter hasil; regionCode juga tidak memiliki default di v4 (v3 ditetapkan secara default ke us). Perbaikan: Filter results di sisi klien: cocokkan regionCode dalam huruf besar dengan postalAddress.regionCode; cocokkan wilayah admin 2 huruf dalam huruf besar dengan postalAddress.administrativeArea dan administrative_area_level_n addressComponents (shortText); normalkan input dan postalAddress.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: SearchDestinations dapat menampilkan hasil yang tidak memiliki alamat utama yang akurat, tidak seperti v3 dan metode v4 lainnya. Perbaikan: Tetapkan placeFilter.addressability ke PRIMARY jika 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, bukan address_components), menghapus status dan error_message, serta menampilkan satu objek root dari GeocodePlace, bukan array results. 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 respons buildings.entrances, navigation_points, buildings.building_outlines, grounds): Tidak digunakan lagi sejak 13-08-2025. Pengganti: Metode SearchDestinations Geocoding 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.