Package google.maps.geocode.v4alpha

색인

• DestinationService(인터페이스)
• Destination(메시지)
• Entrance(메시지)
• Entrance.Tag(열거형)
• Landmark(메시지)
• Landmark.Tag(열거형)
• NavigationPoint(메시지)
• NavigationPoint.TravelMode(열거형)
• NavigationPoint.Usage(열거형)
• PlaceView(메시지)
• PlaceView.StructureType(열거형)
• SearchDestinationsRequest(메시지)
• SearchDestinationsRequest.AddressQuery(메시지)
• SearchDestinationsRequest.LocationQuery(메시지)
• SearchDestinationsResponse(메시지)

DestinationService

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

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

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

대상

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

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

현관

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

필드
location	LatLng 입구의 위치입니다.
tags[]	Entrance.Tag 입구를 설명하는 태그 목록입니다.
place	string 이 입구가 물리적으로 위치한 구조입니다(places/{place_id} 형식).

태그

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

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

명소

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

필드
tags[]	Landmark.Tag 대상 컨텍스트에서 랜드마크를 사용할 수 있는 방법을 설명하는 태그입니다.
통합 필드 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

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

필드
display_name	LocalizedText 이 탐색 지점의 표시 이름입니다. 예를 들어 '5th Ave' 또는 'Gate B'입니다.
location	LatLng 내비게이션이 종료되어야 하는 도로 구간 옆의 지점입니다. 이 지점은 장소가 있는 도로 측면을 명확하게 표시하기 위해 도로의 중심선에서 의도적으로 약간 오프셋되어 있습니다.
travel_modes[]	NavigationPoint.TravelMode 이 탐색 지점에 적합한 이동 수단입니다.
usages[]	NavigationPoint.Usage 이 탐색 지점에서 지원되는 사용법입니다.

TravelMode

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

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

사용

이 탐색 지점에서 지원되는 사용법입니다.

열거형
USAGE_UNSPECIFIED	사용되지 않음.
UNKNOWN	알 수 없는 사용 유형입니다. 대부분의 탐색 포인트는 UNKNOWN이며, 반드시 사용이 제한된다는 의미는 아닙니다. 이 탐색은 픽업 또는 하차에 적합할 수 있습니다.
DROPOFF	승객을 내려주기에 적합합니다. 예를 들어 차량 공유 하차 위치입니다.
PICKUP	승객을 태우기에 적합합니다. 예를 들어 라이드셰어링 픽업 장소입니다.

PlaceView

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

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

필드
place	string 이 장소의 리소스 이름입니다(places/{placeId} 형식).
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	일반적으로 대학 캠퍼스, 아파트 단지, 쇼핑몰과 같이 여러 건물이 포함된 넓은 지역입니다.

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 필드에 건물이 포함됩니다.

필드
통합 필드 kind. 위치 쿼리입니다. kind은 다음 중 하나여야 합니다.
location	LatLng 정확한 LatLng 위치입니다.

SearchDestinationsResponse

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

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