색인
DestinationService(인터페이스)GeocodeService(인터페이스)Destination(메시지)Destination.ArrivalSummary(메시지)Entrance(메시지)Entrance.Tag(열거형)GeocodeAddressRequest(메시지)GeocodeAddressRequest.LocationBias(메시지)GeocodeAddressResponse(메시지)GeocodeLocationRequest(메시지)GeocodeLocationResponse(메시지)GeocodePlaceRequest(메시지)GeocodeResult(메시지)GeocodeResult.AddressComponent(메시지)GeocodeResult.Granularity(열거형)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(메시지)
DestinationService
대상을 가져오는 서비스입니다.
목적지는 장소에 관한 계층적 컨텍스트를 제공하므로, 예를 들어 더 큰 아파트 단지 내에 있는 아파트 건물을 찾거나 그 반대의 경우도 가능합니다. 또한 차량 공유 또는 배달과 같은 사용 사례에 적합한 탐색 지점을 제공합니다.
| SearchDestinations |
|---|
|
이 메서드는 대상 조회를 실행하고 대상 목록을 반환합니다.
|
GeocodeService
지오코딩을 실행하는 서비스입니다.
| GeocodeAddress |
|---|
|
이 메서드는 주소를 LatLng에 매핑하는 주소 지오코딩을 실행합니다. 주소에 관한 구조화된 정보도 제공합니다.
|
| GeocodeLocation |
|---|
|
이 메서드는 LatLng를 주소에 매핑하는 위치 지오코딩을 실행합니다. 주소에 관한 구조화된 정보도 제공합니다.
|
| GeocodePlace |
|---|
|
이 메서드는 장소 ID를 사용하여 지오코드 조회를 실행합니다.
|
대상
목적지입니다. 여기에는 기본 장소, 관련 장소, 출입구, 탐색 지점이 포함됩니다.
| 필드 | |
|---|---|
primary |
요청의 |
containing_places[] |
기본 장소가 포함된 덜 정확한 장소입니다. 예를 들어 이 건물이 포함된 아파트 단지입니다. |
sub_destinations[] |
기본 장소의 더 정확한 하위 목적지입니다. 예를 들어 건물에 포함된 단위입니다. 참고: Places API에서 반환하는 SubDestination과 비교할 때 이 하위 목적지 목록은 더 포괄적이며 각 하위 목적지에는 더 많은 정보가 포함되어 있습니다. |
landmarks[] |
목적지의 위치를 전달하거나 도착을 돕는 데 사용할 수 있는 명소입니다. |
entrances[] |
이 목적지의 입구입니다. |
navigation_points[] |
이 목적지의 탐색 지점입니다. |
arrival_summary |
목적지 도착 환경에 대한 AI 생성 요약입니다. |
ArrivalSummary
목적지 도착 환경에 대한 AI 생성 요약입니다.
| 필드 | |
|---|---|
text |
목적지 도착 환경의 요약입니다. |
flag_content_url |
사용자가 요약의 문제를 신고할 수 있는 링크 |
disclosure_text |
출력 전용입니다. 도착 요약의 공개 텍스트를 포함합니다. |
현관
입구는 장소의 출입구 위치를 정의하는 단일 위도/경도 좌표 쌍입니다.
| 필드 | |
|---|---|
location |
입구의 위치입니다. |
tags[] |
입구를 설명하는 태그 목록입니다. |
place |
이 입구가 물리적으로 위치한 구조입니다( |
태그
입구를 설명하는 특징입니다.
| 열거형 | |
|---|---|
TAG_UNSPECIFIED |
사용되지 않음. |
PREFERRED |
입구는 반환된 목적지의 기본 장소에 대한 물리적 액세스를 제공할 가능성이 높습니다. 장소에는 기본 출입구가 여러 개 있을 수 있습니다. 출입구에 이 태그가 없으면 출입구가 기본 장소와 동일한 건물에 있지만 반드시 장소로 연결되지는 않는다는 의미입니다. 예를 들어 기본 장소가 스트립 몰에 있는 음식점인 경우 '기본' 출입구는 음식점 자체로 이어질 가능성이 높은 출입구이고, 반환된 다른 출입구는 스트립 몰에 있는 다른 음식점의 출입구와 같은 건물의 다른 출입구입니다. 기본 장소가 건물 자체인 경우 참고: |
GeocodeAddressRequest
GeocodeService.GeocodeAddress의 요청 메시지입니다.
| 필드 | |
|---|---|
location_bias |
선택사항입니다. 검색할 지역입니다. 이 위치는 편향으로 작용하므로 지정된 위치 주변의 결과가 반환될 수 있습니다. |
language_code |
선택사항입니다. 결과가 반환되어야 하는 언어입니다. |
region_code |
선택사항입니다. 지역 코드입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칩니다. 이 매개변수는 서비스의 결과에 영향을 줄 뿐 결과를 완전히 제한하지는 않습니다. |
통합 필드 address_input. 지오코딩할 주소입니다. address_input은 다음 중 하나여야 합니다. |
|
address_query |
지오코딩할 구조화되지 않은 주소입니다. |
address |
우편 주소 형식으로 지오코딩할 구조화된 주소입니다. |
LocationBias
검색할 지역입니다. 이 위치는 편향으로 작용하므로 지정된 위치 주변의 결과가 반환될 수 있습니다.
| 필드 | |
|---|---|
통합 필드 type. 위치 편향 유형입니다. type은 다음 중 하나여야 합니다. |
|
rectangle |
북동쪽과 남서쪽 모서리로 정의된 직사각형 상자입니다. |
GeocodeAddressResponse
GeocodeService.GeocodeAddress의 응답 메시지입니다.
| 필드 | |
|---|---|
results[] |
지오코딩 결과입니다. |
GeocodeLocationRequest
GeocodeService.GeocodeLocation 요청 메시지입니다.
| 필드 | |
|---|---|
language_code |
선택사항입니다. 결과가 반환되어야 하는 언어입니다. |
region_code |
선택사항입니다. 지역 코드입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칩니다. |
types[] |
선택사항입니다. 결과를 제한하는 유형 태그 집합입니다. 지정된 유형이 없는 결과는 삭제됩니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A와 표 B를 참고하세요. |
granularity[] |
선택사항입니다. 하나 이상의 위치 세부사항 열거형의 필터입니다. |
통합 필드 location_input. 지오코딩할 위치입니다. location_input은 다음 중 하나여야 합니다. |
|
location_query |
'lat,lng' 문자열 형식의 위치입니다. 예: '64.7611872,-18.4705364' |
location |
구조화된 형식의 위치입니다. |
GeocodeLocationResponse
GeocodeService.GeocodeLocation의 응답 메시지입니다.
| 필드 | |
|---|---|
results[] |
지오코딩 결과입니다. |
plus_code |
요청에 포함된 위치의 플러스 코드입니다. |
GeocodePlaceRequest
GeocodeService.GeocodePlace 요청 메시지입니다.
| 필드 | |
|---|---|
place |
필수 항목입니다. 지오코딩할 장소 식별자입니다(places/{place} 형식). |
language_code |
선택사항입니다. 결과가 반환되어야 하는 언어입니다. |
region_code |
선택사항입니다. 지역 코드입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칩니다. |
GeocodeResult
지오코드 결과에는 장소에 관한 지리 정보가 포함됩니다.
| 필드 | |
|---|---|
place |
이 결과의 정규화된 장소 식별자입니다. '//places.googleapis.com/places/{placeID}' 형식입니다. 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/place-id를 참고하세요. |
place_id |
이 결과의 장소 ID입니다. |
location |
이 주소의 위도 및 경도입니다. |
granularity |
위치의 세부사항입니다. |
viewport |
지오코드 결과를 표시하는 데 적합한 표시 영역입니다. |
bounds |
주소의 경계 상자입니다. |
formatted_address |
한 줄로 형식이 지정된 주소입니다. |
postal_address |
우편 주소 형식의 주소입니다. |
address_components[] |
각 지역 수준에 대해 반복되는 구성요소입니다. |
postal_code_localities[] |
우편번호에 포함된 지역의 전체 목록입니다. 결과 유형이 'postal_code'인 경우에만 채워집니다. |
types[] |
이 결과의 유형 태그 집합입니다. 예를 들어 'political' 및 'administrative_area'입니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A와 표 B를 참고하세요. |
plus_code |
이 지오코드에 있는 위치의 Plus Code입니다. |
AddressComponent
이 정보가 제공되는 경우 서식이 지정된 주소를 구성하는 구조화된 구성요소입니다.
| 필드 | |
|---|---|
long_text |
주소 구성요소의 전체 텍스트 설명 또는 이름입니다. 예를 들어 오스트레일리아 국가의 주소 구성요소에는 긴 이름 'Australia'가 있을 수 있습니다. |
short_text |
주소 구성요소의 축약된 텍스트 이름입니다(해당하는 경우). 예를 들어 오스트레일리아 국가의 주소 구성요소에는 'AU'라는 닉네임이 있을 수 있습니다. |
types[] |
주소 구성요소의 유형을 나타내는 배열입니다. 자세한 내용은 https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types를 참고하세요. |
language_code |
이 구성요소의 형식을 지정하는 데 사용되는 언어입니다(CLDR 표기법). |
세부사항
위치의 세부사항입니다.
| 열거형 | |
|---|---|
GRANULARITY_UNSPECIFIED |
사용하지 마세요. |
ROOFTOP |
일치하는 주소에 해당하는 실제 토지의 보간되지 않은 위치입니다. |
RANGE_INTERPOLATED |
일련의 도로 번호에서 보간됩니다. 예를 들어 Amphitheatre Pkwy의 한 구간에 1600~1699번지가 포함되어 있다면 1650번지는 양쪽 끝점의 중간에 배치될 수 있습니다. |
GEOMETRIC_CENTER |
다각형 데이터가 있는 지형지물의 기하학적 중심입니다. |
APPROXIMATE |
그 외 모든 항목 |
명소
랜드마크는 목적지의 위치를 전달하거나 목적지에 도착하는 데 도움이 됩니다.
| 필드 | |
|---|---|
relational_description |
목적지가 랜드마크와 어떤 관련이 있는지 사람이 읽을 수 있는 설명입니다. 예: '엠파이어 스테이트 빌딩 근처' 또는 '백악관 맞은편' |
tags[] |
대상 컨텍스트에서 랜드마크를 사용할 수 있는 방법을 설명하는 태그입니다. |
straight_line_distance_meters |
출력 전용입니다. 이 랜드마크에서 목적지까지의 직선 거리(미터)입니다. |
travel_distance_meters |
출력 전용입니다. 이 랜드마크에서 목적지까지의 도로 네트워크 거리(미터)입니다. |
통합 필드 landmark. 랜드마크입니다. landmark은 다음 중 하나여야 합니다. |
|
place |
이 랜드마크를 나타내는 장소입니다. |
태그
대상 컨텍스트에서 랜드마크를 사용할 수 있는 방법을 설명하는 모든 가능한 태그의 목록입니다.
주소에 ADDRESS 태그와 ARRIVAL 태그가 모두 있는 경우 랜드마크가 지역적으로 유명하고 목적지와 가깝다는 의미입니다.
| 열거형 | |
|---|---|
TAG_UNSPECIFIED |
사용되지 않음. |
ADDRESS |
목적지의 대략적인 위치를 식별하는 데 사용할 수 있는 지역적으로 유명한 장소입니다. 일반적으로 목적지에서 수백 미터 이내입니다. 이는 Geocoding API의 주소 설명어 기능에서 반환하는 랜드마크와 유사합니다(https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors). |
ARRIVAL |
목적지에 도착하는 데 도움이 되는 장소입니다. 목적지에 가까워지면 내비게이션에 유용합니다. 예를 들어 이 랜드마크는 목적지 맞은편에 있는 장소일 수 있습니다. 이 태그가 지정된 랜드마크는 일반적으로 ADDRESS 태그가 지정된 랜드마크보다 목적지에 더 가깝습니다. |
PlaceView
Places API의 장소 뷰를 나타냅니다. 또한 구조 유형, 표시 다각형 등 대상에 관한 추가 정보도 제공합니다.
경우에 따라 동일한 장소 ID의 PlaceView가 Places API에서 types 및 display_name 필드에 반환되는 값과 다를 수 있습니다.
| 필드 | |
|---|---|
place |
이 장소의 리소스 이름입니다( |
display_name |
사람이 읽을 수 있는 장소 설명입니다. 예: 'B 게이트', '맥도날드' |
primary_type |
이 장소의 기본 장소 유형입니다. 가능한 값 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types를 참고하세요. 참고: 이 필드는 항상 채워지는 것은 아닙니다. 이러한 상황에서는 |
types[] |
이 장소와 연결된 모든 장소 유형입니다. 가능한 값 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types를 참고하세요. |
formatted_address |
한 줄 주소입니다. |
postal_address |
구조화된 주소입니다. |
structure_type |
이 장소에 해당하는 구조의 유형입니다. |
location |
이 장소의 위치입니다. 표시 다각형이 있는 장소의 경우 지도에 마커를 배치하기에 적합한 위치를 나타낼 수 있습니다. |
display_polygon |
RFC 7946 형식(https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6)을 사용하는 GeoJSON 형식의 장소 다각형 윤곽선입니다. 참고: RFC 7946 형식은 MultiPolygon을 지원하므로 하나의 |
StructureType
이 장소가 나타내는 구조물의 유형입니다.
| 열거형 | |
|---|---|
STRUCTURE_TYPE_UNSPECIFIED |
사용되지 않음. |
POINT |
포인트 위치입니다. |
SECTION |
건물의 하위 섹션입니다. |
BUILDING |
건물 |
GROUNDS |
일반적으로 대학 캠퍼스, 아파트 단지, 쇼핑몰과 같이 여러 건물이 포함된 넓은 지역입니다. |
PlusCode
Plus Code (http://plus.codes)는 14mx14m (1/8000도) 이하의 직사각형을 정의하는 글로벌 코드와 접두사를 참조 위치로 대체하는 복합 코드의 두 가지 형식이 있는 위치 참조입니다.
| 필드 | |
|---|---|
global_code |
1/8000 x 1/8000도 영역(~14x14미터)을 나타내는 장소의 전역(전체) 코드입니다(예: '9FWM33GV+HQ'). |
compound_code |
'33GV+HQ, Ramberg, Norway'와 같은 장소의 복합 코드입니다. 여기에는 글로벌 코드의 접미사가 포함되고 접두사가 참조 항목의 형식이 지정된 이름으로 대체됩니다. |
SearchDestinationsRequest
DestinationService.SearchDestinations 요청 메시지입니다.
| 필드 | |
|---|---|
travel_modes[] |
선택사항입니다. 탐색 포인트를 필터링할 이동 모드입니다. 이는 응답에 반환되는 |
language_code |
선택사항입니다. 결과가 반환되어야 하는 언어입니다. |
region_code |
선택사항입니다. 지역 코드입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칩니다. 이 매개변수는 서비스의 결과에 영향을 줄 뿐 완전히 제한하지는 않습니다. |
통합 필드 대상은 지정된 기본 쿼리를 중심으로 빌드됩니다. 참고: 탐색 목적지가 있을 수 있는 장소와 주소만 지원됩니다. 예를 들어 주택이나 아파트 단지를 나타내는 장소는 기본 쿼리로 사용할 수 있지만, 지역이나 행정 구역을 나타내는 장소는 기본 쿼리로 사용할 수 없습니다. |
|
place |
장소의 리소스 이름입니다( |
address_query |
상세 주소입니다. |
location_query |
정확한 위치 |
AddressQuery
검색하려는 상세 주소입니다. 해당 국가의 국내 우편 서비스에서 사용되는 형식에 따라 주소를 지정합니다.
| 필드 | |
|---|---|
통합 필드 kind. 주소 쿼리입니다. kind은 다음 중 하나여야 합니다. |
|
address |
우편 주소 형식의 상세 주소입니다. |
address_query |
한 줄로 형식이 갖춰진 상세 주소입니다. |
LocationQuery
근처의 기본 목적지를 식별하는 위치 쿼리입니다.
참고: 위치 쿼리가 하위 구역이 포함된 건물 내에 있는 경우 반환된 기본 장소가 하위 구역일 수 있습니다. 이 경우 containing_places 필드에 건물이 포함됩니다.
| 필드 | |
|---|---|
place_filter |
선택사항입니다. 대상 후보에 적용할 필터입니다. |
통합 필드 kind. 위치 쿼리입니다. kind은 다음 중 하나여야 합니다. |
|
location |
정확한 LatLng 위치입니다. |
PlaceFilter
대상 후보에 적용할 필터입니다.
| 필드 | |
|---|---|
structure_type |
선택사항입니다. 지정된 경우 모든 대상에는 이 구조 유형의 기본 장소가 있습니다. 이로 인해 일부 대상이 필터링되거나 반환된 대상이 대략적으로 표시되거나 세부적으로 표시될 수 있습니다. 예를 들어 이 필드를 사용하면 건물 디스플레이 다각형을 더 쉽게 추출할 수 있습니다. 예를 들어 |
addressability |
선택사항입니다. 지정된 경우 해당 주소 지정 가능성 기준을 충족하는 대상만 반환합니다. |
주소 지정 가능성
주소 지정 가능 여부 필터링 옵션을 정의합니다. 향후에 새로운 값이 추가될 수 있습니다.
| 열거형 | |
|---|---|
ADDRESSABILITY_UNSPECIFIED |
지정하지 않으면 서비스에서 적절한 기본값을 선택합니다. |
ANY |
주소 지정 가능성은 필터링 기준이 아닙니다. 주소 지정 가능 여부와 관계없이 대상이 반환됩니다. |
PRIMARY |
반환되는 모든 목적지에는 상세 주소 또는 이름이 있는 기본 장소가 있습니다. |
WEAK |
반환된 모든 도착지에는 기본 장소 또는 도로 수준 주소나 이름이 있는 하위 도착지가 있습니다. |
SearchDestinationsResponse
DestinationService.SearchDestinations의 응답 메시지입니다.
| 필드 | |
|---|---|
destinations[] |
대상 목록입니다. 기본 검색어에서 기본 목적지를 명확하게 식별할 수 있는 경우 서비스는 하나의 결과를 반환합니다. 그렇지 않으면 서비스에서 명확성 확보를 위해 여러 결과를 반환하거나 결과를 반환하지 않을 수 있습니다. |