Method: geocode.destinations.searchDestinations

이 메서드는 대상 조회를 실행하고 대상 목록을 반환합니다.

HTTP 요청

POST https://geocode.googleapis.com/v4alpha/geocode/destinations

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

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "travelModes": [
    enum (NavigationPoint.TravelMode)
  ],
  "languageCode": string,
  "regionCode": string,

  // Union field primary_query can be only one of the following:
  "place": string,
  "addressQuery": {
    object (SearchDestinationsRequest.AddressQuery)
  },
  "locationQuery": {
    object (SearchDestinationsRequest.LocationQuery)
  }
  // End of list of possible types for union field primary_query.
}
필드
travelModes[]

enum (NavigationPoint.TravelMode)

선택사항입니다. 탐색 포인트를 필터링할 이동 모드입니다. 이는 응답에 반환되는 navigationPoints 필드에 영향을 줍니다. 비어 있으면 모든 이동 수단의 탐색 지점이 반환될 수 있습니다.
languageCode

string

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

string

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

통합 필드 primary_query. 기본 목적지를 쿼리합니다. 장소, 완전히 지정된 주소 또는 LatLng 위치일 수 있습니다. 정보가 최소한으로 제공된 일부 장소와 주소는 목적지로 설정할 수 없습니다.

대상은 지정된 기본 쿼리를 중심으로 빌드됩니다.

참고: 탐색 목적지가 있을 수 있는 장소와 주소만 지원됩니다. 예를 들어 주택이나 아파트 단지를 나타내는 장소는 기본 쿼리로 사용할 수 있지만, 지역이나 행정 구역을 나타내는 장소는 기본 쿼리로 사용할 수 없습니다. primary_query는 다음 중 하나여야 합니다.
place

string

places/{placeId} 형식의 장소 리소스 이름입니다.
addressQuery

object (SearchDestinationsRequest.AddressQuery)

상세 주소입니다.
locationQuery

object (SearchDestinationsRequest.LocationQuery)

정확한 위치

응답 본문

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

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "destinations": [
    {
      object (Destination)
    }
  ]
}
필드
destinations[]

object (Destination)

도착 페이지 목록입니다.

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

승인 범위

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

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

SearchDestinationsRequest.AddressQuery

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

JSON 표현 
{

  // Union field kind can be only one of the following:
  "address": {
    object (PostalAddress)
  },
  "addressQuery": string
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 주소 쿼리입니다. kind은 다음 중 하나여야 합니다.
address

object (PostalAddress)

우편 주소 형식의 상세 주소입니다.
addressQuery

string

한 줄로 형식이 갖춰진 상세 주소입니다.

SearchDestinationsRequest.LocationQuery

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

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

JSON 표현 
{

  // Union field kind can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 위치 쿼리입니다. kind은 다음 중 하나여야 합니다.
location

object (LatLng)

정확한 LatLng 위치입니다.

대상

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

JSON 표현 
{
  "primary": {
    object (PlaceView)
  },
  "containingPlaces": [
    {
      object (PlaceView)
    }
  ],
  "subDestinations": [
    {
      object (PlaceView)
    }
  ],
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "entrances": [
    {
      object (Entrance)
    }
  ],
  "navigationPoints": [
    {
      object (NavigationPoint)
    }
  ]
}
필드
primary

object (PlaceView)

요청의 primary_query로 식별된 기본 장소입니다.
containingPlaces[]

object (PlaceView)

기본 장소가 포함된 덜 정확한 장소입니다. 예를 들어 이 건물이 포함된 아파트 단지입니다.
subDestinations[]

object (PlaceView)

기본 장소의 더 정확한 하위 목적지입니다. 예를 들어 건물에 포함된 단위입니다.

참고: 이 하위 목적지 목록은 Places API에서 반환하는 SubDestination에 비해 더 포괄적이며 각 하위 목적지에는 더 많은 정보가 포함되어 있습니다.
landmarks[]

object (Landmark)

목적지의 위치를 알리거나 도착을 돕는 데 사용할 수 있는 명소입니다.
entrances[]

object (Entrance)

이 목적지의 입구입니다.
navigationPoints[]

object (NavigationPoint)

이 목적지의 탐색 지점입니다.

PlaceView

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

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

JSON 표현 
{
  "place": string,
  "displayName": {
    object (LocalizedText)
  },
  "primaryType": string,
  "types": [
    string
  ],
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "structureType": enum (PlaceView.StructureType),
  "location": {
    object (LatLng)
  },
  "displayPolygon": {
    object
  }
}
필드
place

string

이 장소의 리소스 이름입니다(places/{placeId} 형식).
displayName

object (LocalizedText)

사람이 읽을 수 있는 장소 설명입니다. 예: 'B 게이트', '맥도날드'
primaryType

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를 참고하세요.
formattedAddress

string

한 줄 주소입니다.
postalAddress

object (PostalAddress)

구조화된 주소입니다.
structureType

enum (PlaceView.StructureType)

이 장소에 해당하는 구조의 유형입니다.
location

object (LatLng)

이 장소의 위치입니다. 표시 다각형이 있는 장소의 경우 지도에 마커를 배치하기에 적합한 위치를 나타낼 수 있습니다.
displayPolygon

object (Struct format)

RFC 7946 형식(https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6)을 사용하는 GeoJSON 형식의 장소 폴리곤 윤곽선입니다.

참고: RFC 7946 형식은 MultiPolygon을 지원하므로 하나의 displayPolygon 객체가 여러 다각형을 나타낼 수 있습니다.

PlaceView.StructureType

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

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

명소

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

JSON 표현 
{
  "tags": [
    enum (Landmark.Tag)
  ],

  // Union field landmark can be only one of the following:
  "place": {
    object (PlaceView)
  }
  // End of list of possible types for union field landmark.
}
필드
tags[]

enum (Landmark.Tag)

대상 컨텍스트에서 랜드마크를 사용할 수 있는 방법을 설명하는 태그입니다.
통합 필드 landmark. 명소입니다. landmark은 다음 중 하나여야 합니다.
place

object (PlaceView)

이 랜드마크를 나타내는 장소입니다.

Landmark.Tag

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

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

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

현관

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

JSON 표현 
{
  "location": {
    object (LatLng)
  },
  "tags": [
    enum (Entrance.Tag)
  ],
  "place": string
}
필드
location

object (LatLng)

입구의 위치입니다.
tags[]

enum (Entrance.Tag)

입구를 설명하는 태그 목록입니다.
place

string

이 입구가 물리적으로 위치한 구조입니다(places/{placeId} 형식).

Entrance.Tag

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

열거형
TAG_UNSPECIFIED 사용되지 않음.
PREFERRED

입구는 반환된 목적지의 기본 장소에 대한 물리적 액세스를 제공할 가능성이 높습니다. 장소에는 기본 출입구가 여러 개 있을 수 있습니다. 출입구에 이 태그가 없으면 출입구가 기본 장소와 동일한 건물에 있지만 반드시 장소에 대한 액세스를 제공하지는 않는다는 의미입니다.

예를 들어 기본 장소가 스트립 몰에 있는 음식점인 경우 '기본' 출입구는 음식점 자체로 이어질 가능성이 높은 출입구이고, 반환된 다른 출입구는 스트립 몰에 있는 다른 음식점의 출입구와 같은 건물의 다른 출입구입니다.

기본 장소가 건물 자체인 경우 PREFERRED 출입구는 건물의 '메인' 부분으로 이어지는 출입구입니다. 예를 들어 쇼핑센터에서 PREFERRED 출입구는 메인 로비로 연결되는 출입구입니다. 하지만 건물 측면에 있는 매장으로만 연결되는 출입구는 PREFERRED 출입구가 아닙니다.

참고: PREFERRED 출입구는 기본 장소에 대한 액세스를 제공하지 않을 수 있으며, PREFERRED이 아닌 출입구는 기본 장소에 대한 액세스를 제공할 수 있습니다.