Geocoding API v4 adalah layanan yang menyediakan geocoding, geocoding terbalik alamat dan ID Tempat, serta informasi tujuan.
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.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
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, parameter yang tersedia dan memahami respons.
Di bawah ini adalah contoh respons geocoding, dalam JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
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://geocode.googleapis.com/v4beta/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYAnda dapat mengujinya dengan memasukkan URL ke browser web (pastikan untuk mengganti 'YOUR_API_KEY' dengan kunci API Anda yang sebenarnya). Respons mencakup alamat yang dapat dibaca orang untuk lokasi lintang dan bujur.
Lihat panduan developer untuk mengetahui informasi selengkapnya tentang membuat URL permintaan geocoding terbalik, parameter yang tersedia, dan memahami respons.
Di bawah ini adalah contoh respons geocoding terbalik, dalam JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
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 artikel Memulai Google Maps Platform.
Kuota dan harga
Tinjau halaman penggunaan dan penagihan untuk mengetahui detail kuota dan harga yang ditetapkan untuk Geocoding API.
Kebijakan
Penggunaan Geocoding API harus sesuai dengan kebijakan API.