Package google.maps.geocode.v4beta

색인

GeocodeService

지오코딩을 실행하는 서비스입니다.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

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

승인 범위

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

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

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

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

승인 범위

다음 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
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

이 메서드는 장소 ID를 사용하여 지오코드 조회를 실행합니다.

승인 범위

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

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

GeocodeAddressRequest

GeocodeService.GeocodeAddress의 요청 메시지입니다.

필드
location_bias

GeocodeAddressRequest.LocationBias

선택사항입니다. 검색할 지역입니다. 이 위치는 편향으로 작용하므로 지정된 위치 주변의 결과가 반환될 수 있습니다.

language_code

string

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

region_code

string

선택사항입니다. 지역 코드입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칩니다. 이 매개변수는 서비스의 결과에 영향을 줄 뿐 결과를 완전히 제한하지는 않습니다.

통합 필드 address_input. 지오코딩할 주소입니다. address_input은 다음 중 하나여야 합니다.
address_query

string

지오코딩할 구조화되지 않은 주소입니다.

address

PostalAddress

우편 주소 형식으로 지오코딩할 구조화된 주소입니다.

LocationBias

검색할 지역입니다. 이 위치는 편향으로 작용하므로 지정된 위치 주변의 결과가 반환될 수 있습니다.

필드
통합 필드 type. 위치 편향 유형입니다. type은 다음 중 하나여야 합니다.
rectangle

Viewport

북동쪽 및 남서쪽 모서리로 정의된 직사각형 상자입니다. rectangle.high()은 직사각형 뷰포트의 북동쪽 지점이어야 합니다. rectangle.low()는 사각형 뷰포트의 남서쪽 지점이어야 합니다. rectangle.low().latitude()rectangle.high().latitude()보다 클 수 없습니다. 이렇게 하면 위도 범위가 비게 됩니다. 직사각형 뷰포트는 180도보다 넓을 수 없습니다.

GeocodeAddressResponse

GeocodeService.GeocodeAddress의 응답 메시지입니다.

필드
results[]

GeocodeResult

지오코딩 결과입니다.

GeocodeLocationRequest

GeocodeService.GeocodeLocation 요청 메시지입니다.

필드
language_code

string

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

region_code

string

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

types[]

string

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

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

granularity[]

GeocodeResult.Granularity

선택사항입니다. 하나 이상의 위치 세부사항 열거형의 필터입니다.

통합 필드 location_input. 지오코딩할 위치입니다. location_input은 다음 중 하나여야 합니다.
location_query

string

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

location

LatLng

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

GeocodeLocationResponse

GeocodeService.GeocodeLocation의 응답 메시지입니다.

필드
results[]

GeocodeResult

지오코딩 결과입니다.

plus_code

PlusCode

요청에 포함된 위치의 플러스 코드입니다.

GeocodePlaceRequest

GeocodeService.GeocodePlace 요청 메시지입니다.

필드
place

string

필수입니다. 지오코딩할 장소 식별자입니다(places/{place} 형식).

language_code

string

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

region_code

string

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

GeocodeResult

지오코드 결과에는 장소에 관한 지리 정보가 포함됩니다.

필드
place

string

이 결과의 정규화된 장소 식별자입니다. '//places.googleapis.com/places/{placeID}' 형식입니다. 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/place-id를 참고하세요.

place_id

string

이 결과의 장소 ID입니다.

location

LatLng

이 주소의 위도와 경도입니다.

granularity

GeocodeResult.Granularity

위치의 세부사항입니다.

viewport

Viewport

지오코드 결과를 표시하는 데 적합한 표시 영역입니다.

bounds

Viewport

주소의 경계 상자입니다.

formatted_address

string

한 줄로 형식이 지정된 주소입니다.

postal_address

PostalAddress

우편 주소 형식의 주소입니다.

address_components[]

GeocodeResult.AddressComponent

각 지역 수준에 대해 반복되는 구성요소입니다.

postal_code_localities[]

LocalizedText

우편번호에 포함된 지역의 전체 목록입니다.

결과 유형이 'postal_code'인 경우에만 채워집니다.

types[]

string

이 결과의 유형 태그 집합입니다. 예를 들어 'political' 및 'administrative_area'입니다.

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

plus_code

PlusCode

이 지오코드에 있는 위치의 Plus Code입니다.

AddressComponent

이 정보가 제공되는 경우 서식이 지정된 주소를 구성하는 구조화된 구성요소입니다.

필드
long_text

string

주소 구성요소의 전체 텍스트 설명 또는 이름입니다. 예를 들어 오스트레일리아 국가의 주소 구성요소에는 긴 이름 'Australia'가 있을 수 있습니다.

short_text

string

주소 구성요소의 축약된 텍스트 이름입니다(해당하는 경우). 예를 들어 오스트레일리아 국가의 주소 구성요소에는 'AU'라는 닉네임이 있을 수 있습니다.

types[]

string

주소 구성요소의 유형을 나타내는 배열입니다.

자세한 내용은 https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types를 참고하세요.

language_code

string

이 구성요소의 형식을 지정하는 데 사용되는 언어입니다(CLDR 표기법).

세부사항

위치의 세부사항입니다.

열거형
GRANULARITY_UNSPECIFIED 사용하지 마세요.
ROOFTOP 일치하는 주소에 해당하는 실제 토지의 보간되지 않은 위치입니다.
RANGE_INTERPOLATED 일련의 도로 번호에서 보간됩니다. 예를 들어 Amphitheatre Pkwy의 한 구간에 1600~1699번지가 포함되어 있다면 1650번지는 해당 구간의 중간에 배치될 수 있습니다.
GEOMETRIC_CENTER 다각형 데이터가 있는 지형지물의 기하학적 중심입니다.
APPROXIMATE 기타

PlusCode

Plus Code (http://plus.codes)는 14mx14m (1/8000도) 이하의 직사각형을 정의하는 글로벌 코드와 접두사를 참조 위치로 대체하는 복합 코드의 두 가지 형식이 있는 위치 참조입니다.

필드
global_code

string

1/8000x1/8000도 영역(~14x14미터)을 나타내는 장소의 전역(전체) 코드입니다(예: '9FWM33GV+HQ').

compound_code

string

글로벌 코드의 접미사를 포함하고 접두사를 형식화된 참조 항목 이름으로 대체하는 장소의 복합 코드입니다(예: '33GV+HQ, Ramberg, Norway').