Geocoding API adalah layanan yang menyediakan geocoding dan geocoding terbalik alamat IP internalnya.
Geocoding adalah proses konversi alamat (seperti alamat) 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 ke alamat yang dapat dibaca manusia.
Anda juga dapat menggunakan Geocoding API untuk menemukan alamat ID tempat yang diberikan.
Contoh permintaan dan respons
Anda mengakses Geocoding API melalui antarmuka HTTP. Mengikuti 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 {i>browser <i}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 informasi selengkapnya tentang membangun URL permintaan geocoding dan parameter yang tersedia dan memahami responsnya.
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, AS. 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 {i>browser <i}web (pastikan untuk mengganti ‘YOUR_API_KEY’ dengan kunci API Anda yang sebenarnya). Respons berisi alamat yang dapat dibaca manusia untuk lintang dan bujur lokasi HTTP/HTTPS.
Lihat panduan developer untuk informasi selengkapnya tentang membangun URL permintaan geocoding terbalik dan parameter yang tersedia dan 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 membuat pengembangan dengan Google Maps Web Service API menjadi lebih mudah dengan menyediakan implementasi native tugas umum, seperti autentikasi, permintaan throttling 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 memperoleh kredensial otentikasi yang sesuai. Untuk informasi selengkapnya, lihat Memulai Google Maps Platform.
Kuota dan harga
Meninjau penggunaan dan penagihan untuk 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 demo tambahan, contoh, parameter yang tersedia, kode status dan pesan error, serta detail lainnya.
Panduan developer Geocoding API menjelaskan Layanan web Geocoding API. Ini ditujukan untuk developer {i>website<i} dan seluler yang ingin menggunakan data geocoding dalam peta yang disediakan oleh salah satu platform Google Maps Platform Google Cloud Platform.