Mulai

Geocoding API adalah layanan yang menyediakan geocoding dan geocoding terbalik alamat.

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

Geocoding terbalik adalah proses konversi koordinat geografis menjadi alamat yang dapat dibaca manusia.

Anda juga dapat menggunakan Geocoding API guna menemukan alamat untuk ID tempat tertentu.

Contoh permintaan dan respons

Anda mengakses Geocoding API melalui antarmuka HTTP. Berikut adalah contoh permintaan geocoding dan geocoding terbalik.

Permintaan geocoding dan respons (pencarian lintang/bujur)

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

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

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

Lihat panduan developer untuk informasi selengkapnya tentang mem-build 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 Parkway",
               "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 Pkwy, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4267861,
               "lng" : -122.0806032
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4281350802915,
                  "lng" : -122.0792542197085
               },
               "southwest" : {
                  "lat" : 37.4254371197085,
                  "lng" : -122.0819521802915
               }
            }
         },
         "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE",
         "plus_code" : {
            "compound_code" : "CWC8+R3 Mountain View, California, United States",
            "global_code" : "849VCWC8+R3"
         },
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

Permintaan geocoding terbalik dan respons (pencarian alamat)

Contoh berikut meminta alamat yang sesuai 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 dapat mengujinya dengan memasukkan URL ke browser web Anda (pastikan untuk mengganti ‘YOUR_API_KEY’ dengan kunci API Anda yang sebenarnya). Responsnya mencakup alamat yang dapat dibaca manusia untuk lokasi lintang dan bujur.

Lihat panduan developer untuk informasi selengkapnya tentang mem-build URL permintaan geocoding terbalik dan parameter yang tersedia serta memahami responsnya.

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

{
   "plus_code" : {
      "compound_code" : "P27Q+MC New York, NY, USA",
      "global_code" : "87G8P27Q+MC"
   },
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "279",
               "short_name" : "279",
               "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" : [ "political", "sublocality", "sublocality_level_1" ]
            },
            {
               "long_name" : "Kings County",
               "short_name" : "Kings County",
               "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" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.7142484,
               "lng" : -73.9614103
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.71559738029149,
                  "lng" : -73.9600613197085
               },
               "southwest" : {
                  "lat" : 40.71289941970849,
                  "lng" : -73.96275928029151
               }
            }
         },
         "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE",
         "plus_code" : {
            "compound_code" : "P27Q+MC Brooklyn, New York, United States",
            "global_code" : "87G8P27Q+MC"
         },
         "types" : [
            "bakery",
            "cafe",
            "establishment",
            "food",
            "point_of_interest",
            "store"
         ]
      },

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

   ],
   "status" : "OK"
}

Memulai pengkodean dengan pustaka klien kami

Library klien mempermudah pengembangan dengan API layanan web Google Maps dengan menyediakan implementasi tugas umum yang sederhana dan native, seperti autentikasi, throttling permintaan, dan percobaan ulang otomatis. Geocoding API tersedia di Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps.

Autentikasi, kuota, harga, dan kebijakan

Autentikasi

Untuk menggunakan Geocoding API, Anda harus mengaktifkan API terlebih dahulu dan mendapatkan kredensial autentikasi yang tepat. Untuk informasi selengkapnya, lihat Memulai Google Maps Platform.

Kuota dan harga

Tinjau halaman penggunaan dan penagihan untuk mengetahui detail tentang kuota dan harga yang ditetapkan untuk Geocoding API.

Kebijakan

Penggunaan Geocoding API harus sesuai dengan kebijakan API.

Pelajari lebih lanjut

Masih banyak lagi yang dapat Anda lakukan dengan Geocoding API. Lihat panduan developer Geocoding API untuk melihat demo tambahan, contoh, parameter yang tersedia, kode status dan pesan error, serta detail lainnya.

Panduan developer Geocoding API menjelaskan layanan web Geocoding API. Panduan ini ditujukan untuk developer situs dan seluler yang ingin menggunakan data geocoding dalam peta yang disediakan oleh salah satu API Google Maps Platform.