Geocoding API v4는 주소 및 장소 ID의 지오코딩, 역 지오코딩, 목적지 정보를 제공하는 서비스입니다.
지오코딩은 주소 (예: 상세 주소)를 지리 좌표 (예: 위도 및 경도)로 변환하는 과정이며, 이를 사용하여 마커를 지도에 배치하거나 지도의 위치를 지정할 수 있습니다.
역 지오코딩은 지리 좌표를 사람이 읽을 수 있는 주소로 변환하는 과정입니다.
Geocoding API를 사용하여 지정된 장소 ID의 주소를 찾을 수도 있습니다.
샘플 요청 및 응답
HTTP 인터페이스를 통해 Geocoding API에 액세스합니다. 다음은 지오코딩 및 역 지오코딩 요청의 예입니다.
지오코딩 요청 및 응답(위도/경도 검색)
다음 예에서는 '1600 Amphitheatre Parkway, Mountain View, CA'의 위도와 경도를 요청하고 출력이 JSON 형식이어야 한다고 지정합니다.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
웹브라우저에 URL을 입력하여 테스트할 수 있습니다 (YOUR_API_KEY를 실제 API 키로 바꿔야 함).
응답에는 이 주소의 위도와 경도가 포함됩니다.
개발자 가이드에서 지오코딩 요청 URL 빌드, 사용 가능한 매개변수, 응답 이해에 대해 자세히 알아보세요.
다음은 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" ] } ] }
역지오코딩 요청 및 응답(주소 검색)
다음 예에서는 미국 뉴욕 브루클린의 지정된 위도/경도에 해당하는 주소를 요청합니다. 결과를 JSON 형식으로 출력하도록 지정합니다.
https://geocode.googleapis.com/v4beta/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEY웹브라우저에 URL을 입력하여 테스트할 수 있습니다 (실제 API 키로 'YOUR_API_KEY'를 대체해야 함). 대답에는 위도 및 경도 위치의 사람이 읽을 수 있는 주소가 포함됩니다.
역 지오코딩 요청 URL 빌드, 사용 가능한 매개변수, 응답 이해에 대한 자세한 내용은 개발자 가이드를 참고하세요.
다음은 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[] ... }
인증, 할당량, 가격 책정, 정책
인증
Geocoding API를 사용하려면 먼저 API를 사용 설정하고 적절한 인증 사용자 인증 정보를 획득해야 합니다. 자세한 내용은 Google Maps Platform 시작하기를 참고하세요.
할당량 및 가격 책정
Geocoding API에 설정된 할당량 및 가격에 대한 자세한 내용은 사용량 및 결제 페이지를 참고하세요.
정책
Geocoding API는 API 정책에 따라 사용해야 합니다.