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 untuk menemukan alamat untuk ID tempat yang diberikan.
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 (pastikan untuk mengganti
YOUR_API_KEY dengan kunci API Anda yang sebenarnya).
Respons berisi garis lintang dan bujur dari alamat.
Lihat panduan developer untuk mengetahui informasi selengkapnya tentang membuat 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 tertentu di Brooklyn, NY, Amerika Serikat. Itu menetapkan bahwa keluaran harus dalam format JSON.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYAnda dapat mengujinya dengan memasukkan URL ke browser web (pastikan untuk mengganti "YOUR_API_KEY" dengan kunci API Anda yang sebenarnya). Responsnya menyertakan alamat yang dapat dibaca manusia untuk lokasi lintang dan bujur.
Lihat panduan developer untuk mengetahui informasi selengkapnya tentang membuat URL permintaan geocoding terbalik dan parameter yang tersedia serta memahami respons.
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 memudahkan pengembangan dengan API layanan web Google Maps dengan menyediakan implementasi native yang sederhana untuk tugas umum, 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 sesuai. Untuk informasi selengkapnya, lihat artikel 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
Ada banyak hal yang dapat Anda lakukan dengan Geocoding API. Lihat panduan developer Geocoding API untuk demo tambahan, contoh, parameter yang tersedia, kode status dan pesan error, serta detail lainnya.
Panduan developer Geocoding API menjelaskan layanan web Geocoding API. API ini ditujukan untuk developer situs dan seluler yang ingin menggunakan data geocoding dalam peta yang disediakan oleh salah satu API Google Maps Platform.