Geocoding API adalah layanan yang menerima tempat sebagai alamat, koordinat lintang dan bujur, atau ID Tempat. Layanan ini mengonversi alamat menjadi koordinat lintang dan bujur serta ID Tempat, atau mengonversi koordinat lintang dan bujur atau ID Tempat menjadi alamat.
Geocoding API v4 menyediakan kecerdasan tujuan dan kedatangan hiperlokal serta resolusi koordinat ke alamat inti. Baik Anda membangun pengalaman pengiriman jarak jauh, transportasi online, atau navigasi belokan demi belokan, atau menormalisasi alamat jalan menjadi koordinat, v4 menawarkan endpoint khusus yang disesuaikan dengan kasus penggunaan Anda.
Tidak yakin endpoint mana yang sesuai dengan aplikasi Anda? Lihat Memilih metode geocoding.
Yang dapat Anda lakukan dengan Geocoding API
Geocoding API v4 mencakup kemampuan dan endpoint berikut:
- Menelusuri tujuan: Ambil detail kedatangan hiperlokal untuk tujuan dari alamat, ID Tempat, atau koordinat—termasuk pintu masuk bangunan, token titik navigasi yang dapat dirutekan, garis batas bangunan dan halaman, sub-tujuan, dan tempat terkenal di sekitar.
- Memberi geocode pada alamat: Mengonversi alamat menjadi koordinat geografis dan ID Tempat (geocoding maju).
- Melakukan geocoding pada lokasi: Mengonversi koordinat lintang dan bujur menjadi alamat atau wilayah administratif yang dapat dibaca manusia (geocoding terbalik).
- Melakukan geocoding pada tempat: Ambil detail alamat dan koordinat yang diformat untuk ID Tempat Google Maps yang diketahui.
Anda dapat mengontrol tempat hasil muncul dan membatasi hasil ke wilayah, county, atau kode pos tertentu.
Coba demo
Cara kerja Geocoding API
Geocoding API v4 mendukung penelusuran tujuan bersama dengan geocoding dasar:
- Penelusuran tujuan (
SearchDestinations): Me-resolve alamat, ID Tempat, atau pasangan koordinat menjadi objekDestinationyang lengkap. Gunakan metode ini jika kedatangan fisik penting—seperti mengidentifikasi pintu masuk bangunan yang diinginkan, mengarahkan pengemudi ke titik penjemputan atau pengantaran yang ditentukan menggunakan token titik navigasi, merender jejak bangunan di peta, atau menavigasi kompleks multi-bangunan. - Geocoding dasar: Mengonversi antara alamat, koordinat, dan ID Tempat:
- Geocoding: Mengonversi alamat seperti "1600 Amphitheatre Parkway, Mountain View, CA" menjadi koordinat lintang dan bujur atau ID Tempat untuk menempatkan penanda peta atau memusatkan frame tampilan peta.
- Geocoding terbalik: Mengonversi koordinat lintang dan bujur atau ID Tempat menjadi alamat yang dapat dibaca manusia untuk pin peta yang diletakkan pengguna, pemilih lokasi, atau tampilan UI.
- Geocoding tempat: Mengambil detail alamat dan koordinat untuk ID Tempat Google Maps yang diketahui.
Tabel berikut merangkum resource yang tersedia melalui Geocoding API v4 beserta data yang ditampilkan oleh setiap metode:
| Resource data | Data yang ditampilkan | Format hasil |
|---|---|---|
| Menelusuri tujuan ( POST /v4/geocode/destinations)
|
Menampilkan kecerdasan kedatangan hiperlokal: poligon bangunan dan lahan (displayPolygon), entrances fisik, navigationPoints yang dapat dirutekan (dengan token), containingPlaces dan subDestinations hierarkis, landmarks relasional, dan detail tempat utama. Lihat Menelusuri tujuan.
|
|
| Memberi geocode pada alamat ( GET /v4/geocode/address)
|
Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat Respons geocode. | |
| Melakukan geocoding pada lokasi ( GET /v4/geocode/location)
|
Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat Respons geocoding terbalik. | |
| Melakukan geocoding pada tempat ( GET /v4/geocode/places)
|
Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat Respons geocoding tempat. |
Saluran tahap peluncuran
Geocoding API versi 4 memiliki saluran terpisah untuk fitur GA, Pratinjau, dan Eksperimental. Jika Anda ingin menggunakan fitur Pratinjau atau Eksperimental, pastikan untuk menentukan saluran yang benar dalam permintaan Anda. Misalnya,
untuk mengakses fitur endpoint Destinations di Eksperimental, gunakan permintaan
HTTP ini: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Tahap peluncuran | Nama saluran |
|---|---|
| GA | /v4/ |
| Pratinjau | /v4beta/ |
| Eksperimental | /v4alpha/ |
- Lihat referensi REST untuk mengetahui daftar dan deskripsi semua resource REST yang tersedia.
- Lihat tahap peluncuran untuk mengetahui informasi selengkapnya tentang setiap tahap.
Fitur di Geocoding API v4
Geocoding API versi 4 menawarkan fitur baru berikut.
Metode penelusuran tujuan
v4 memperkenalkan Metode penelusuran tujuan yang memungkinkan Anda mengambil informasi mendetail tentang berbagai tujuan berdasarkan kriteria input yang berbeda, seperti alamat, ID tempat, atau koordinat lintang dan bujur. Responsnya mencakup ringkasan yang didukung AI dan token titik navigasi yang berisi informasi kontekstual yang dapat diteruskan ke Navigation SDK untuk pemilihan rute yang akurat.
Diimplementasikan di platform standar Google Cloud
Geocoding API v4 diimplementasikan di Service Infrastructure di Google Cloud. Implementasi ini menghadirkan platform yang lebih aman dan tepercaya dengan opsi keamanan yang ditingkatkan seperti OAuth. Desain API standar ini menghadirkan tingkat konsistensi di seluruh API yang meningkatkan efisiensi pengembangan dengan Geocoding API v4.
Dukungan OAuth ditambahkan
Geocoding API v4 mendukung penggunaan OAuth 2.0 untuk autentikasi. Google mendukung skenario OAuth 2.0 umum seperti skenario untuk server web.
Dukungan mask kolom ditambahkan
Gunakan mask kolom untuk menentukan informasi yang harus ditampilkan dalam respons. Untuk metode Geocode an address, Geocode a location, dan Place geocoding, semua kolom dalam objek respons ditampilkan secara default. Untuk metode Search for destinations, Anda harus menentukan mask kolom dalam permintaan API.
Keamanan API
Geocoding API v4 dirancang sebagai API server ke server. Panggilan sisi klien langsung dari browser membuat kunci API berisiko tinggi dicuri dan disalahgunakan, karena pembatasan perujuk HTTP tidak memberikan perlindungan yang memadai untuk endpoint layanan web.
Sebaiknya panggil Geocoding API v4 dari server backend Anda sendiri. Untuk mengetahui detail selengkapnya tentang pola implementasi yang aman dan alternatif untuk kebutuhan sisi klien, lihat Pertimbangan keamanan.