Method: geocode.location.geocodeLocation

이 메서드는 LatLng를 주소에 매핑하는 위치 지오코딩을 실행합니다. 또한 주소에 관한 구조화된 정보도 제공합니다.

HTTP 요청

GET https://geocode.googleapis.com/v4beta/geocode/location

URL은 gRPC 트랜스코딩 문법을 사용합니다.

쿼리 매개변수

파라미터
languageCode

string

선택사항입니다. 결과가 반환되는 언어입니다.

regionCode

string

선택사항입니다. 리전 코드입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 이 매개변수는 관련 법률에 따라 결과에 영향을 미칩니다.

types[]

string

선택사항입니다. 결과를 제한하는 유형 태그 집합입니다. 지정된 유형이 없는 결과는 삭제됩니다.

가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 및 표 B를 참고하세요.

granularity[]

enum (GeocodeResult.Granularity)

선택사항입니다. 하나 이상의 위치 세분화 enum 필터입니다.

지오코딩할 위치입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
locationQuery

string

'lat,lng' 문자열 형식의 위치입니다. 예: '64.7611872,-18.4705364'

location

object (LatLng)

구조화된 형식의 위치입니다.

상호 배타적인 필드의 끝입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 GeocodeLocationResponse의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location