Package google.maps.geocode.v4alpha

색인

• DestinationService(인터페이스)
• GeocodeService(인터페이스)
• Destination(메시지)
• Destination.ArrivalSummary(메시지)
• Destination.ParkingOptions(메시지)
• Destination.ParkingOptions.Availability(열거형)
• Entrance(메시지)
• Entrance.Tag(열거형)
• GeocodeAddressRequest(메시지)
• GeocodeAddressRequest.LocationBias(메시지)
• GeocodeAddressResponse(메시지)
• GeocodeLocationRequest(메시지)
• GeocodeLocationResponse(메시지)
• GeocodePlaceRequest(메시지)
• GeocodeResult(메시지)
• GeocodeResult.AddressComponent(메시지)
• GeocodeResult.Granularity(열거형)
• ImageAnnotation(메시지)
• ImageAnnotation.Coordinate(메시지)
• Landmark(메시지)
• Landmark.Tag(열거형)
• NavigationPoint(메시지)
• NavigationPoint.TravelMode(열거형)
• NavigationPoint.Usage(열거형)
• PlaceView(메시지)
• PlaceView.StructureType(열거형)
• PlusCode(메시지)
• SearchDestinationsRequest(메시지)
• SearchDestinationsRequest.AddressQuery(메시지)
• SearchDestinationsRequest.LocationQuery(메시지)
• SearchDestinationsRequest.LocationQuery.PlaceFilter(메시지)
• SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability(열거형)
• SearchDestinationsResponse(메시지)
• StreetViewThumbnail(메시지)

DestinationService

대상을 가져오는 서비스입니다.

목적지는 장소에 관한 계층적 컨텍스트를 제공하므로, 예를 들어 더 큰 아파트 단지 내에 있는 아파트 건물을 찾거나 그 반대의 경우도 가능합니다. 또한 차량 공유 또는 배달과 같은 사용 사례에 적합한 탐색 지점을 제공합니다.

SearchDestinations
rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse) 이 메서드는 대상 조회를 실행하고 대상 목록을 반환합니다. 승인 범위 다음 OAuth 범위 중 하나가 필요합니다. https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.destinations

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

대상

목적지입니다. 여기에는 기본 장소, 관련 장소, 출입구, 탐색 지점이 포함됩니다.

필드
primary	PlaceView 요청의 primary_query로 식별된 기본 장소입니다.
containing_places[]	PlaceView 기본 장소가 포함된 덜 정확한 장소입니다. 예를 들어 이 건물이 포함된 아파트 단지입니다.
sub_destinations[]	PlaceView 기본 장소의 더 정확한 하위 목적지입니다. 예를 들어 건물에 포함된 단위입니다. 참고: Places API에서 반환하는 SubDestination과 비교할 때 이 하위 목적지 목록은 더 포괄적이며 각 하위 목적지에는 더 많은 정보가 포함되어 있습니다.
landmarks[]	Landmark 목적지의 위치를 전달하거나 도착을 돕는 데 사용할 수 있는 명소입니다.
entrances[]	Entrance 이 목적지의 입구입니다.
navigation_points[]	NavigationPoint 이 목적지의 탐색 지점입니다.
parking_options	Destination.ParkingOptions 이 목적지의 주차 옵션입니다.
arrival_summary	Destination.ArrivalSummary 목적지 도착 환경에 대한 AI 생성 요약입니다.

ArrivalSummary

목적지 도착 환경에 대한 AI 생성 요약입니다.

필드
text	LocalizedText 목적지 도착 환경의 요약입니다.
flag_content_url	string 사용자가 요약의 문제를 신고할 수 있는 링크
disclosure_text	LocalizedText 출력 전용입니다. 도착 요약의 공개 텍스트를 포함합니다.

ParkingOptions

목적지의 주차 옵션에 관한 정보입니다.

필드
availability	Destination.ParkingOptions.Availability 이 대상의 주차 가능 여부입니다.
onsite_parking	bool 목적지에 구내 주차장이 있습니다.
free_parking_lot	bool 무료 주차장을 제공합니다.
paid_parking_lot	bool 유료 주차장을 제공합니다.
free_street_parking	bool 무료 노상 주차를 제공합니다.
paid_street_parking	bool 유료 노상 주차를 제공합니다.
valet_parking	bool 발레파킹 서비스를 제공합니다.
free_garage_parking	bool 무료 실내 주차장을 제공합니다.
paid_garage_parking	bool 유료 실내 주차를 제공합니다.

가용성

이 장소를 방문할 때 주차장을 찾기가 얼마나 어려운지를 나타내는 집계된 측정값입니다.

향후에 새로운 값이 추가될 수 있습니다.

열거형
AVAILABILITY_UNSPECIFIED	주차 가능 여부를 확인할 수 없습니다.
PLENTY	주차 공간이 충분합니다.
SOMEWHAT_DIFFICULT	주차장을 찾기가 다소 어렵습니다.
DIFFICULT	주차장을 찾기가 매우 어렵습니다.

현관

입구는 장소의 출입구 위치를 정의하는 단일 위도/경도 좌표 쌍입니다.

필드
location	LatLng 입구의 위치입니다.
tags[]	Entrance.Tag 입구를 설명하는 태그 목록입니다.
place	string 이 입구가 물리적으로 위치한 구조입니다(places/{place_id} 형식).
street_view_thumbnail	StreetViewThumbnail 입구를 보여주는 스트리트 뷰 썸네일 이미지입니다. 이미지는 스트리트 뷰 Static API에서 요청할 수 있습니다. https://developers.google.com/maps/documentation/streetview/request-streetview를 참고하세요.
street_view_annotation	ImageAnnotation 위에 반환된 street_view_thumbnail의 입구 주석입니다.

태그

입구를 설명하는 특징입니다.

열거형
TAG_UNSPECIFIED	사용되지 않음.
PREFERRED	입구는 반환된 목적지의 기본 장소에 대한 물리적 액세스를 제공할 가능성이 높습니다. 장소에는 기본 출입구가 여러 개 있을 수 있습니다. 출입구에 이 태그가 없으면 출입구가 기본 장소와 동일한 건물에 있지만 반드시 장소에 대한 액세스를 제공하지는 않는다는 의미입니다. 예를 들어 기본 장소가 스트립 몰에 있는 음식점인 경우 '기본' 출입구는 음식점 자체로 이어질 가능성이 높은 출입구이고, 반환된 다른 출입구는 스트립 몰에 있는 다른 음식점의 출입구와 같은 건물의 다른 출입구입니다. 기본 장소가 건물 자체인 경우 PREFERRED 출입구는 건물의 '메인' 부분으로 이어지는 출입구입니다. 예를 들어 쇼핑센터에서 PREFERRED 출입구는 메인 로비로 연결되는 출입구입니다. 하지만 건물 측면에 있는 스토어로만 연결되는 출입구는 PREFERRED 출입구가 아닙니다. 참고: PREFERRED 출입구는 기본 장소에 대한 액세스를 제공하지 않을 수 있으며, PREFERRED이 아닌 출입구는 기본 장소에 대한 액세스를 제공할 수 있습니다.

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 v4alpha/v4beta 사용자의 조치 필요: 이 필드가 곧 이전 형식 '//places.googleapis.com/places/{placeID}'에서 새 형식 'places/{placeId}'로 업데이트됩니다. 전환 기간 동안 애플리케이션이 두 형식을 모두 처리할 수 있는지 확인하세요. 이전 형식은 2026년 5월 말까지 완전히 지원 중단될 예정입니다. 이 결과의 정규화된 장소 식별자입니다. '//places.googleapis.com/places/{placeID}' 형식입니다. 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/place-id를 참고하세요.
place_id	string 장소의 고유 식별자입니다.
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	기타 모든 항목

ImageAnnotation

입구를 윤곽으로 표시하는 다각형과 같은 이미지 썸네일의 주석입니다.

필드
coordinates[]	ImageAnnotation.Coordinate 이미지에서 다각형을 형성하는 좌표 목록입니다. 좌표는 시계 반대 방향으로 정렬됩니다.

좌표

이미지에서 한 점의 픽셀 좌표입니다. 원점 (0,0)은 이미지의 왼쪽 상단 픽셀의 왼쪽 상단 모서리이며 x축은 오른쪽을 향하고 y축은 아래쪽을 향합니다.

필드
x_px	float X 좌표입니다.
y_px	float Y 좌표입니다.

명소

랜드마크는 목적지의 위치를 전달하거나 목적지에 도착하는 데 도움이 됩니다.

필드
relational_description	LocalizedText 목적지가 랜드마크와 어떤 관련이 있는지 사람이 읽을 수 있는 설명입니다. 예: '엠파이어 스테이트 빌딩 근처' 또는 '백악관 맞은편'
tags[]	Landmark.Tag 대상 컨텍스트에서 랜드마크를 사용할 수 있는 방법을 설명하는 태그입니다.
straight_line_distance_meters	double 출력 전용입니다. 이 랜드마크에서 목적지까지의 직선 거리(미터)입니다.
travel_distance_meters	double 출력 전용입니다. 이 랜드마크에서 목적지까지의 도로 네트워크 거리(미터)입니다.
통합 필드 landmark. 랜드마크입니다. landmark은 다음 중 하나여야 합니다.
place	PlaceView 이 랜드마크를 나타내는 장소입니다.

태그

대상 컨텍스트에서 랜드마크를 사용할 수 있는 방법을 설명하는 가능한 모든 태그의 목록입니다.

주소에 ADDRESS 태그와 ARRIVAL 태그가 모두 있는 경우 랜드마크가 지역적으로 유명하고 목적지와 가깝다는 의미입니다.

열거형
TAG_UNSPECIFIED	사용되지 않음.
ADDRESS	목적지의 대략적인 위치를 식별하는 데 사용할 수 있는 지역적으로 유명한 장소입니다. 일반적으로 목적지에서 수백 미터 이내입니다. 이는 Geocoding API의 주소 설명자 기능에서 반환하는 랜드마크와 유사합니다(https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors).
ARRIVAL	목적지에 도착하는 데 도움이 되는 장소입니다. 목적지에 가까워지면 내비게이션에 유용합니다. 예를 들어 이 랜드마크는 목적지 맞은편에 있는 장소일 수 있습니다. 이 태그가 지정된 랜드마크는 일반적으로 ADDRESS 태그가 지정된 랜드마크보다 목적지에 더 가깝습니다.

NavigationPoint

탐색 지점은 탐색이 종료될 수 있는 도로 옆 위치입니다.

필드
navigation_point_token	string 출력 전용입니다. 이 탐색 지점을 식별하는 데 사용할 수 있는 토큰입니다.
display_name	LocalizedText 이 탐색 지점의 표시 이름입니다. 예를 들어 '5th Ave' 또는 'Gate B'입니다.
location	LatLng 내비게이션이 종료되어야 하는 도로 구간 옆의 지점입니다. 이 지점은 장소가 위치한 도로 측면을 명확하게 표시하기 위해 도로의 중심선에서 의도적으로 약간 오프셋되어 있습니다.
travel_modes[]	NavigationPoint.TravelMode 이 탐색 지점에 적합한 이동 수단입니다.
usages[]	NavigationPoint.Usage 이 탐색 지점에서 지원되는 usages를 나열합니다. 비어 있다고 해서 반드시 사용이 제한된다는 의미는 아닙니다. 모든 탐색 지점은 일반 탐색에 사용할 수 있습니다.
street_view_thumbnail	StreetViewThumbnail 탐색 지점을 보여주는 스트리트 뷰 썸네일 이미지(사용 가능한 경우) 이미지는 스트리트 뷰 Static API에서 요청할 수 있습니다. https://developers.google.com/maps/documentation/streetview/request-streetview를 참고하세요.
entrance_annotation	ImageAnnotation 사용 가능한 경우 위에 반환된 street_view_thumbnail에서 이 탐색 지점과 연결된 입구의 주석입니다.
altitude_meters	float WGS-84 타원체를 기준으로 한 탐색 지점의 고도(미터)입니다.

TravelMode

이 탐색 지점에 적합한 이동 수단입니다.

열거형
TRAVEL_MODE_UNSPECIFIED	사용되지 않음.
DRIVE	운전하기에 적합합니다.
WALK	산책에 적합합니다.

사용

이 탐색 지점에서 지원되는 사용법입니다. 향후에 새로운 값이 추가될 수 있습니다.

열거형
USAGE_UNSPECIFIED	사용되지 않음.
UNKNOWN	사용 유형을 알 수 없음을 나타냅니다.
DROPOFF	승객을 내려주기에 적합합니다. 예를 들어 차량 공유 하차 위치입니다.
PICKUP	승객을 태우기에 적합합니다. 예를 들어 차량 공유 탑승 위치입니다.
PARKING	주차에 적합합니다. 예를 들어 주차장 내

PlaceView

Places API의 장소 뷰를 나타냅니다. 또한 구조 유형, 표시 다각형 등 대상에 관한 추가 정보도 제공합니다.

경우에 따라 동일한 장소 ID의 PlaceView가 Places API에서 types 및 display_name 필드에 반환되는 값과 다를 수 있습니다.

필드
place	string v4alpha/v4beta 사용자의 조치 필요: 이 필드가 곧 이전 형식 '//places.googleapis.com/places/{placeID}'에서 새 형식 'places/{placeId}'로 업데이트됩니다. 전환 기간 동안 애플리케이션이 두 형식을 모두 처리할 수 있는지 확인하세요. 이전 형식은 2026년 5월 말까지 완전히 지원 중단될 예정입니다. 이 결과의 정규화된 장소 식별자입니다. '//places.googleapis.com/places/{placeID}' 형식입니다. 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/place-id를 참고하세요.
place_id	string 장소의 고유 식별자입니다.
display_name	LocalizedText 사람이 읽을 수 있는 장소 설명입니다. 예: 'B 게이트', '맥도날드'
primary_type	string 이 장소의 기본 장소 유형입니다. 가능한 값 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types를 참고하세요. 참고: 이 필드는 항상 채워지는 것은 아닙니다. 이러한 상황에서 types 필드를 사용할 수 있도록 준비하세요.
types[]	string 이 장소와 연결된 모든 장소 유형입니다. 가능한 값 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types를 참고하세요.
formatted_address	string 한 줄 주소입니다.
postal_address	PostalAddress 구조화된 주소입니다.
structure_type	PlaceView.StructureType 이 장소에 해당하는 구조의 유형입니다.
location	LatLng 이 장소의 위치입니다. 표시 다각형이 있는 장소의 경우 지도에 마커를 배치하기에 적합한 위치를 나타낼 수 있습니다.
display_polygon	Struct RFC 7946 형식(https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6)을 사용하는 GeoJSON 형식의 장소 다각형 윤곽선입니다. 참고: RFC 7946 형식은 MultiPolygon을 지원하므로 하나의 display_polygon 객체가 여러 다각형을 나타낼 수 있습니다.

StructureType

이 장소가 나타내는 구조물의 유형입니다.

열거형
STRUCTURE_TYPE_UNSPECIFIED	사용되지 않음.
POINT	포인트 위치입니다.
SECTION	건물의 하위 섹션입니다.
BUILDING	건물
GROUNDS	일반적으로 대학 캠퍼스, 아파트 단지, 쇼핑몰과 같이 여러 건물이 포함된 넓은 지역입니다.

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').

SearchDestinationsRequest

DestinationService.SearchDestinations 요청 메시지입니다.

필드
travel_modes[]	NavigationPoint.TravelMode 선택사항입니다. 탐색 포인트를 필터링할 이동 모드입니다. 이는 응답에 반환되는 navigation_points 필드에 영향을 미칩니다. 비어 있으면 모든 이동 수단의 탐색 지점이 반환됩니다.
language_code	string 선택사항입니다. 결과가 반환되어야 하는 언어입니다.
region_code	string 선택사항입니다. 지역 코드입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칩니다. 이 매개변수는 서비스의 결과에 영향을 줄 뿐 완전히 제한하지는 않습니다.
통합 필드 primary_query. 기본 목적지를 쿼리합니다. 장소, 완전히 지정된 주소 또는 LatLng 위치일 수 있습니다. 정보가 최소한으로 제공된 일부 장소와 주소는 목적지로 설정할 수 없습니다. 대상은 지정된 기본 쿼리를 중심으로 빌드됩니다. 참고: 탐색 목적지가 될 수 있는 장소와 주소만 지원됩니다. 예를 들어 주택이나 아파트 단지를 나타내는 장소는 기본 쿼리로 사용할 수 있지만, 지역이나 행정 구역을 나타내는 장소는 기본 쿼리로 사용할 수 없습니다. primary_query는 다음 중 하나여야 합니다.
place	string 장소의 리소스 이름입니다(places/{place_id} 형식).
address_query	SearchDestinationsRequest.AddressQuery 상세 주소입니다.
location_query	SearchDestinationsRequest.LocationQuery 정확한 위치

AddressQuery

검색하려는 상세 주소입니다. 해당 국가의 국내 우편 서비스에서 사용되는 형식에 따라 주소를 지정합니다.

필드
통합 필드 kind. 주소 쿼리입니다. kind은 다음 중 하나여야 합니다.
address	PostalAddress 우편 주소 형식의 상세 주소입니다.
address_query	string 한 줄로 형식이 갖춰진 상세 주소입니다.

LocationQuery

근처의 기본 목적지를 식별하는 위치 쿼리입니다.

참고: 위치 쿼리가 하위 구역이 포함된 건물 내에 있는 경우 반환된 기본 장소가 하위 구역일 수 있습니다. 이 경우 containing_places 필드에 건물이 포함됩니다.

필드
place_filter	SearchDestinationsRequest.LocationQuery.PlaceFilter 선택사항입니다. 대상 후보에 적용할 필터입니다.
통합 필드 kind. 위치 쿼리입니다. kind은 다음 중 하나여야 합니다.
location	LatLng 정확한 LatLng 위치입니다.

PlaceFilter

대상 후보에 적용할 필터입니다.

필드
structure_type	PlaceView.StructureType 선택사항입니다. 지정된 경우 모든 대상에는 이 구조 유형의 기본 장소가 보장됩니다. 이로 인해 일부 대상이 필터링되거나 반환된 대상이 대략적으로 표시되거나 세부적으로 표시될 수 있습니다. 예를 들어 GROUNDS가 지정되면 반환된 모든 대상에는 GROUNDS 구조 유형의 기본 장소가 있습니다. 이로 인해 근거에 포함되지 않은 일부 대상 유형이 필터링되거나 반환된 대상 유형이 근거 수준으로 세분화될 수 있습니다. 이 필드를 사용하면 건물 디스플레이 다각형을 더 쉽게 추출할 수 있습니다. 예를 들어 BUILDING이 지정되면 기본 장소의 표시 다각형은 지정된 위치의 건물이 됩니다.
addressability	SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability 선택사항입니다. 지정된 경우 해당 주소 지정 가능성 기준을 충족하는 대상만 반환합니다.

주소 지정 가능성

주소 지정 가능 여부 필터링 옵션을 정의합니다. 향후에 새로운 값이 추가될 수 있습니다.

열거형
ADDRESSABILITY_UNSPECIFIED	지정하지 않으면 서비스에서 적절한 기본값을 선택합니다.
ANY	주소 지정 가능성은 필터링 기준이 아닙니다. 주소 지정 가능 여부와 관계없이 대상이 반환됩니다.
PRIMARY	반환된 모든 대상에는 상세 주소 또는 이름이 있는 기본 장소가 있습니다.
WEAK	반환된 모든 목적지에는 기본 장소 또는 도로 수준 주소나 이름이 있는 하위 목적지가 있습니다.

SearchDestinationsResponse

DestinationService.SearchDestinations의 응답 메시지입니다.

필드
destinations[]	Destination 도착 페이지 목록입니다. 기본 쿼리에서 기본 목적지를 명확하게 식별할 수 있는 경우 서비스는 하나의 결과를 반환합니다. 그렇지 않으면 서비스에서 명확성 확보를 위해 여러 결과를 반환하거나 결과를 반환하지 않을 수 있습니다.

StreetViewThumbnail

Google 스트리트 뷰 썸네일을 나타내는 매개변수입니다. 이러한 매개변수를 사용하여 Street View Static API에서 스트리트 뷰 이미지를 요청할 수 있습니다. https://developers.google.com/maps/documentation/streetview/request-streetview를 참고하세요.

필드
pano	string 특정 파노라마 ID입니다.
width_px	int32 출력 썸네일 이미지의 너비(픽셀)입니다. 참고: 썸네일과 함께 주석을 요청할 때는 주석 좌표가 이미지와 올바르게 정렬되도록 스트리트 뷰 API 요청에서 이 높이 및 너비 값을 사용해야 합니다.
height_px	int32 출력 썸네일 이미지의 높이(픽셀)입니다. 참고: 썸네일과 함께 주석을 요청할 때는 주석 좌표가 이미지와 올바르게 정렬되도록 스트리트 뷰 API 요청에서 이 높이 및 너비 값을 사용해야 합니다.
heading_degree	float 카메라의 수평 방향(도)입니다. 범위 [0, 360) 0은 북쪽을 나타내고 90은 동쪽을 나타냅니다.
pitch_degree	float 카메라의 세로 방향(단위: 도)입니다. 범위 [-90, 90] 0은 수평선, +90은 똑바로 위, -90은 똑바로 아래입니다.
fov_degree	float 수평 시야각(도)입니다. 범위 (0, 180] 확대/축소 수준을 제어합니다. FOV가 작을수록 더 많이 확대됩니다.