Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps Geocoding API

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Maps Geocoding API
  3. Buat kunci yang sesuai
Lanjutkan

Memulai

Google Maps Geocoding API Adalah layanan yang menyediakan geocoding dan geocoding terbalik dari alamat.

Layanan ini juga tersedia sebagai bagian dari Google Maps JavaScript API sisi-klien, atau untuk penggunaan sisi-server dengan Java Client, Python Client, Go Client dan Node.js Client for Google Maps Services.

Geocoding adalah proses mengonversi alamat (seperti alamat jalan) menjadi koordinat geografis (seperti lintang dan bujur), yang bisa Anda gunakan untuk menempatkan marker pada peta, atau memosisikan peta.

Geocoding terbalik adalah proses mengonversi koordinat geografis menjadi alamat yang bisa dibaca orang. Layanan geocoding terbalik pada Google Maps Geocoding API juga memungkinkan Anda menemukan alamat untuk ID tempat yang diberikan.

Contoh permintaan dan respons

Anda bisa mengakses Google Maps Geocoding API melalui antarmuka HTTP. Berikut ini adalah contoh dari permintaan geocoding dan geocoding terbalik.

Permintaan geocoding dan respons (pencarian lintang/bujur)

Contoh berikut meminta lintang dan bujur dari "1600 Amphitheatre Parkway, Mountain View, CA", dan menentukan bahwa keluaran harus dalam format JSON.

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

Anda bisa mengujinya dengan memasukkan URL ke browser web Anda (pastikan untuk mengganti ‘YOUR_API_KEY’ dengan kunci API Anda yang sesungguhnya). Respons berisi garis lintang dan bujur dari alamat.

Lihat panduan developer untuk informasi selengkapnya tentang membangun URL permintaan geocoding dan parameter yang tersedia serta memahami respons.

Di bawah ini adalah contoh respons geocoding, dalam JSON:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "1600",
               "short_name" : "1600",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Amphitheatre Pkwy",
               "short_name" : "Amphitheatre Pkwy",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Mountain View",
               "short_name" : "Mountain View",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Santa Clara County",
               "short_name" : "Santa Clara County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "California",
               "short_name" : "CA",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "94043",
               "short_name" : "94043",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "1600 Amphitheatre Parkway, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4224764,
               "lng" : -122.0842499
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4238253802915,
                  "lng" : -122.0829009197085
               },
               "southwest" : {
                  "lat" : 37.4211274197085,
                  "lng" : -122.0855988802915
               }
            }
         },
         "place_id" : "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

Permintaan geocoding terbalik dan respons (pencarian alamat)

Contoh berikut ini meminta alamat yang cocok dengan lintang/bujur yang diberikan di Brooklyn, NY, USA. Itu menetapkan bahwa keluaran harus dalam format JSON.

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY

Anda bisa mengujinya dengan memasukkan URL ke browser web Anda (pastikan untuk mengganti ‘YOUR_API_KEY’ dengan kunci API Anda yang sesungguhnya). Respons berisi alamat yang bisa dibaca untuk lokasi lintang dan bujur.

Lihat panduan developer untuk informasi selengkapnya tentang membangun URL permintaan geocoding terbalik dan parameter yang tersedia serta memahami respons.

Di bawah ini adalah contoh respons geocoding terbalik, dalam JSON:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "277",
               "short_name" : "277",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Bedford Avenue",
               "short_name" : "Bedford Ave",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Williamsburg",
               "short_name" : "Williamsburg",
               "types" : [ "neighborhood", "political" ]
            },
            {
               "long_name" : "Brooklyn",
               "short_name" : "Brooklyn",
               "types" : [ "sublocality", "political" ]
            },
            {
               "long_name" : "Kings",
               "short_name" : "Kings",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "New York",
               "short_name" : "NY",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "11211",
               "short_name" : "11211",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "277 Bedford Avenue, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.714232,
               "lng" : -73.9612889
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.7155809802915,
                  "lng" : -73.9599399197085
               },
               "southwest" : {
                  "lat" : 40.7128830197085,
                  "lng" : -73.96263788029151
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      },

   ... Additional results truncated in this example[] ...

   ],
   "status" : "OK"
}

Memulai pengkodean dengan pustaka klien kami

Pustaka klien membuat pengembangan dengan Google Maps Web Service API semakin mudah dengan menyediakan, implementasi sederhana atas tugas rutin, seperti autentikasi, pembatasan permintaan, dan mencoba ulang secara otomatis. Google Maps Geocoding API Tersedia dalam Java Client, Python Client, Go Client dan Node.js Client for Google Maps Services.

Autentikasi, kuota, dan kebijakan

Mengaktifkan API dan mendapatkan kunci API

Untuk menggunakan Google Maps Geocoding API, Anda harus terlebih dahulu mengaktifkan API di Google API Console dan mendapatkan kredensial autentikasi yang tepat. Anda harus menyediakan kunci API dalam setiap permintaan (atau ID klien jika Anda memiliki Premium Plan).

Klik tombol di bawah untuk mengalir melalui proses sehingga Anda bisa:

  1. Buat atau pilih sebuah proyek
  2. Mengaktifkan API
  3. Mendapatkan kunci API
Dapatkan Kunci

Ketahui selengkapnya tentang kredensial autentikasi.

Kuota

Tinjau laman batas penggunaan untuk detail tentang kuota yang telah ditetapkan untuk Google Maps Geocoding API.

Kebijakan

Penggunaan Google Maps Geocoding API harus sesuai dengan kebijakan API.

Ketahui selengkapnya

Ada lebih banyak lagi yang bisa Anda lakukan dengan Geocoding API. Lihat panduan developer Geocoding API untuk demo tambahan, contoh, parameter yang tersedia, kode status serta pesan kesalahan, dan detail lainnya.

Kirim masukan tentang...

Google Maps Geocoding API
Google Maps Geocoding API
Butuh bantuan? Kunjungi halaman dukungan kami.