Geocoding API
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
주소를 지리적 좌표로 변환 (지오코딩)하여 마커를 배치하거나 지도의 위치를 지정할 수 있습니다. 이 API를 사용하면 지리 좌표를 주소로 변환할 수도 있습니다 (리버스 지오코딩).
서비스: geocoding-backend.googleapis.com
애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API 요청을 실행할 때 다음 정보를 사용해야 합니다.
탐색 문서
검색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참조할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 검색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.
서비스 엔드포인트
서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.
https://geocode.googleapis.com
| 메서드 |
geocodeAddress |
GET /v4beta/geocode/address
이 메서드는 주소를 LatLng에 매핑하는 주소 지오코딩을 실행합니다. |
geocodeAddressQuery |
GET /v4beta/geocode/address/{addressQuery}
이 메서드는 주소를 LatLng에 매핑하는 주소 지오코딩을 실행합니다. |
| 메서드 |
geocodeLocation |
GET /v4beta/geocode/location
이 메서드는 위치 지오코드를 실행하여 LatLng를 주소에 매핑합니다. |
geocodeLocationQuery |
GET /v4beta/geocode/location/{locationQuery}
이 메서드는 위치 지오코드를 실행하여 LatLng를 주소에 매핑합니다. |
| 메서드 |
geocodePlace |
GET /v4beta/geocode/{place=places/*}
이 메서드는 장소 ID를 사용하여 지오코드 조회를 실행합니다. |
| 메서드 |
searchDestinations |
POST /v4alpha/geocode/destinations
이 메서드는 대상 조회를 실행하고 대상 목록을 반환합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-13(UTC)
[null,null,["최종 업데이트: 2025-08-13(UTC)"],[],[],null,["# Geocoding API\n\nConvert addresses into geographic coordinates (geocoding), which you can use to place markers or position the map. This API also allows you to convert geographic coordinates into an address (reverse geocoding).\n\n- [REST Resource: v4beta.geocode.address](#v4beta.geocode.address)\n- [REST Resource: v4beta.geocode.location](#v4beta.geocode.location)\n- [REST Resource: v4beta.geocode.places](#v4beta.geocode.places)\n- [REST Resource: v4alpha.geocode.destinations](#v4alpha.geocode.destinations)\n\nService: geocoding-backend.googleapis.com\n-----------------------------------------\n\nIf your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:\n\n- \u003chttps://geocoding-backend.googleapis.com/$discovery/rest?version=v4beta\u003e\n- \u003chttps://geocoding-backend.googleapis.com/$discovery/rest?version=v4alpha\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://geocode.googleapis.com`\n\nREST Resource: [v4beta.geocode.address](/maps/documentation/geocoding/reference/rest/v4beta/geocode.address)\n------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|\n| [geocodeAddress](/maps/documentation/geocoding/reference/rest/v4beta/geocode.address/geocodeAddress) | `GET /v4beta/geocode/address` This method performs an address geocode, which maps an address to a LatLng. |\n| [geocodeAddressQuery](/maps/documentation/geocoding/reference/rest/v4beta/geocode.address/geocodeAddressQuery) | `GET /v4beta/geocode/address/{addressQuery}` This method performs an address geocode, which maps an address to a LatLng. |\n\nREST Resource: [v4beta.geocode.location](/maps/documentation/geocoding/reference/rest/v4beta/geocode.location)\n--------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|\n| [geocodeLocation](/maps/documentation/geocoding/reference/rest/v4beta/geocode.location/geocodeLocation) | `GET /v4beta/geocode/location` This method performs a location geocode, which maps a LatLng to an address. |\n| [geocodeLocationQuery](/maps/documentation/geocoding/reference/rest/v4beta/geocode.location/geocodeLocationQuery) | `GET /v4beta/geocode/location/{locationQuery}` This method performs a location geocode, which maps a LatLng to an address. |\n\nREST Resource: [v4beta.geocode.places](/maps/documentation/geocoding/reference/rest/v4beta/geocode.places)\n----------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|\n| [geocodePlace](/maps/documentation/geocoding/reference/rest/v4beta/geocode.places/geocodePlace) | `GET /v4beta/geocode/{place=places/*}` This method performs a geocode lookup using a place ID. |\n\nREST Resource: [v4alpha.geocode.destinations](/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations)\n------------------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|--------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------|\n| [searchDestinations](/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations) | `POST /v4alpha/geocode/destinations` This method performs a destination lookup and returns a list of destinations. |"]]
