Package google.maps.locationselection.v1beta

색인

LocationSelectionBeta

주변 장소 및 관련 승차 및 하차 지점을 확인하는 서비스입니다.

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

지정된 위치의 주변 장소를 찾습니다.

FindPickupPointsForLocation

rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse)

지정된 위치의 승차 위치를 찾습니다.

FindPickupPointsForPlace

rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse)

특정 장소의 승차 지점을 찾습니다.

주소

장소의 주소입니다.

필드
formatted_address

FormattedAddress

이 장소의 사람이 읽을 수 있는 전체 주소입니다.

address_components[]

AddressComponent

주소 구성요소의 목록입니다.

AddressComponent

주소의 한 부분을 설명하는 주소 구성요소입니다.

필드
component_text

string

주소의 일부를 설명하는 이 구성요소의 이름입니다. 예: '서울', '강남구'

component_text_short_form

string

짧은 형식의 구성요소 텍스트입니다. 예를 들어 'California'를 'CA'로, 'United States'를 'US'로 지정할 수 있습니다.

types[]

string

주소의 일부를 설명하는 이 구성요소의 유형입니다. 지원되는 유형 목록은 https://developers.google.com/places/web-service/supported_types#table2를 참고하세요.

복합

장소와 연결된 복합입니다.

필드
type

CompoundType

복합 유형입니다.

geometry

Geometry

복합물과 연결된 도형입니다.

entrances[]

Entrance

복합 시설과 관련된 출입구 목록입니다.

CompoundTypeEnums

화합물의 유형

CompoundType

복합 유형의 값입니다.

열거형
COMPOUND_TYPE_UNSPECIFIED 복합 유형을 알 수 없습니다.
SECTION 복합 섹션. https://support.google.com/mapskb/answer/7054299
BUILDING 복합 건물. https://support.google.com/mapskb/answer/7013011
GROUNDS 복합 지구. https://support.google.com/mapskb/answer/7046859

현관

장소의 입구입니다.

필드
location

LatLng

입구의 위치입니다.

FindNearbyPlacesRequest

주변 장소 찾기 요청 메시지입니다.

필드
localization_preferences

LocalizationPreferences

필수 항목입니다. 응답으로 텍스트를 현지화하는 데 사용되는 환경설정입니다(예: 이름, 주소).

search_location

LatLng

필수 항목입니다. 장소를 찾아야 하는 위치입니다.

max_results

int32

필수 항목입니다. 반환할 최대 결과 수입니다. 0보다 커야 합니다.

wifi_access_points[]

WiFiAccessPoint

요청 위치 주변의 Wi-Fi 액세스 포인트입니다. 더 높은 품질의 검색결과를 제공하는 데 사용됩니다.

FindNearbyPlacesResponse

지정된 위치 응답 메시지에 대해 주변 장소를 찾습니다.

필드
place_results[]

PlaceResult

찾은 장소의 순서가 지정된 목록입니다. 요청 위치 주변에 장소가 없는 경우 비어 있을 수 있습니다. 순서는 가능성과 거리의 조합을 기준으로 합니다.

FindPickupPointsForLocationRequest

FindPickupPointsForLocation 요청 메시지입니다.

필드
localization_preferences

LocalizationPreferences

필수 항목입니다. 응답으로 텍스트를 현지화하는 데 사용되는 환경설정입니다(예: 이름, 주소).

search_location

LatLng

필수 항목입니다. 승차 지점을 검색하고 승차 지점까지의 거리와 도착예정시간을 계산하는 데 사용하는 위치입니다.

order_by

PickupPointOrder

필수 항목입니다. 결과를 반환할 때 사용할 순서입니다.

destination

LatLng

고객의 의도된 목적지 위치입니다. 목적지 도착예정시간을 기준으로 정렬된 승차 지점을 요청할 때 설정합니다.

max_results

int32

필수 항목입니다. 반환할 최대 결과 수입니다. 0보다 커야 합니다.

travel_modes[]

TravelMode

필수 항목입니다. 지정된 이동 수단을 하나 이상 허용하는 승차 지점만 반환됩니다. 지원되는 이동 수단은 DRIVING 및 TWO_WHEELER입니다. 모드를 하나 이상 지정해야 합니다.

compute_walking_eta

bool

true인 경우 검색 위치에서 승차 지점까지의 도보 도착예정시간이 계산됩니다.

compute_driving_eta

bool

true이고 목적지가 지정된 경우 승차 지점에서 목적지까지의 운전 예상 소요 시간이 계산됩니다.

wifi_access_points[]

WiFiAccessPoint

검색 위치 주변의 WiFi 액세스 포인트 더 높은 품질의 검색결과를 제공하는 데 사용됩니다.

FindPickupPointsForLocationResponse

위치 응답 메시지의 수령 지점을 찾습니다.

필드
place_pickup_point_results[]

PlacePickupPointResult

연결된 장소 ID가 있는 주변 수령 지점 이 목록의 결과는 요청에 지정된 기준에 따라 정렬됩니다. 'place_pickup_point_results'의 결과 수가 'place_results'의 결과 수를 초과할 수 있습니다.

place_results[]

PlaceResult

주변 승차 지점과 관련된 장소에 대한 세부정보입니다. 이 목록의 결과는 정렬되지 않습니다.

FindPickupPointsForPlaceRequest

FindPickupPointsForPlace 요청 메시지입니다.

필드
place_id

string

필수 항목입니다. 승차 위치가 요청된 장소의 장소 ID입니다.

localization_preferences

LocalizationPreferences

필수 항목입니다. 응답으로 텍스트를 현지화하는 데 사용되는 환경설정입니다(예: 이름, 주소).

search_location

LatLng

승차 지점을 검색하고 승차 지점까지의 거리와 도착예정시간을 계산하는 데 사용하는 위치입니다. 설정하지 않으면 지정된 장소 ID와 연결된 장소의 위치가 사용됩니다.

order_by

PickupPointOrder

필수 항목입니다. 결과를 반환할 때 사용할 순서입니다.

destination

LatLng

고객의 의도된 목적지 위치입니다. 목적지 도착예정시간에 따라 승차 위치를 주문하도록 요청하는 경우 설정합니다.

max_results

int32

필수 항목입니다. 반환할 최대 결과 수입니다. 0보다 커야 합니다.

travel_modes[]

TravelMode

필수 항목입니다. 지정된 이동 수단을 하나 이상 허용하는 승차 지점만 반환됩니다. 지원되는 이동 수단은 DRIVING 및 TWO_WHEELER입니다. 모드를 하나 이상 지정해야 합니다.

compute_walking_eta

bool

true인 경우 검색 위치에서 승차 지점까지의 도보 도착예정시간이 계산됩니다.

compute_driving_eta

bool

true이고 목적지가 지정된 경우 승차 지점에서 목적지까지의 운전 예상 소요 시간이 계산됩니다.

FindPickupPointsForPlaceResponse

장소 응답 메시지의 수령 지점을 찾습니다.

필드
pickup_point_results[]

PickupPointResult

요청 기준과 일치하는 승차 지점 요청 기준과 일치하는 승차 지점이 없는 경우 비어 있을 수 있습니다.

place_result

PlaceResult

요청한 장소 ID와 연결된 장소입니다.

FormattedAddress

이 메시지가 포함된 개체에 대한 사람이 읽을 수 있는 전체 주소입니다.

필드
lines[]

string

주소를 설명하는 텍스트 줄 행이 하나 이상 있어야 합니다.

도형

장소의 도형입니다.

필드
location

LatLng

이 메시지가 포함된 항목의 중심점입니다.

viewport

Viewport

평균 크기의 지도에 장소를 표시하는 데 적합한 표시 영역입니다.

display_boundary

Struct

GeoJSON 다각형 형식을 사용하여 다각형을 지정합니다.

LocalizationPreferences

이 메시지가 포함된 개체에 대한 사람이 읽을 수 있는 전체 주소입니다.

필드
language_code

string

필수 항목입니다. 텍스트를 현지화하는 데 사용되는 BCP-47 언어 태그입니다. 언어 태그의 예로는 'en-US', 'hi-IN', 'fr-CA' 등이 있습니다.

region_code

string

필수 항목입니다. 요청이 발생한 위치의 유니코드 국가/지역 코드(CLDR)입니다(예: 'US' 및 '419').

자세한 내용은 http://www.unicode.org/reports/tr35/#unicode_region_subtag를 참조하세요.

PickupPoint

승차 또는 하차 지점에 관한 세부정보입니다.

필드
id

string

승차 지점의 고유 ID. 있어야 합니다.

display_name

string

사람이 읽을 수 있는 승차 지점의 짧은 이름입니다. 요청 시 제공된 환경설정에 따라 현지화됩니다.

address

Address

승차 지점의 주소입니다.

description

string

승차 위치에 대한 더 긴 설명(위치에 도착하는 방법이 포함될 수 있음)

location

LatLng

탑승자 또는 수신자가 운전자와 만나는 승차 지점의 위치입니다. 있어야 합니다.

PickupPointOrderEnums

일치하는 픽업 지점의 정렬 순서를 지정하는 값의 집합입니다.

PickupPointOrder

수령 지점 주문 금액입니다.

열거형
PICKUP_POINT_ORDER_UNSPECIFIED 수령 지점 순서가 지정되지 않았습니다. 기본값은 DISTANCE_FROM_ORIGIN입니다.
DISTANCE_FROM_SEARCH_LOCATION 검색 위치에서 반환된 승차 지점까지 직선 거리의 오름차순입니다.
WALKING_ETA_FROM_SEARCH_LOCATION 검색 위치에서 승차 지점까지 소비자의 도보 시간을 기준으로 하는 오름차순입니다.
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION 수령 지점에서 소비자의 목적지까지 도착예정시간을 운전하여 주문 오름차순 이 모드는 대상이 설정되어 있고 compute_driving_eta가 true인 경우에만 사용할 수 있습니다. 여러 travel_mode가 요청에 제공되는 경우 순서는 요청의 첫 번째 travel_mode를 기준으로 합니다.

PickupPointResult

승차 지점 검색 결과에 대한 세부정보입니다.

필드
pickup_point

PickupPoint

요청과 일치하는 실제 승차 지점입니다.

distance_meters

float

이 승차 지점에서 요청에 지정된 search_location까지의 직선 거리입니다.

travel_details[]

TravelDetail

요청된 각 이동 수단에 대해 이 승차 위치를 오가는 이동과 관련된 세부정보입니다.

순위

장소에 대한 세부정보입니다.

필드
place_id

string

장소의 장소 ID입니다. 장소 ID는 장소를 고유하게 나타내는 텍스트입니다. https://developers.google.com/places/web-service/place-id

display_name

string

현지화된 장소의 이름입니다. 요청 시 제공된 환경설정에 따라 현지화됩니다.

language_code

string

장소와 연결된 텍스트 필드의 언어 코드입니다. 예: 'name', 'address'.

address

Address

장소의 주소입니다.

geometry

Geometry

장소의 도형입니다.

types[]

string

이 결과의 유형 태그 집합입니다. 예: 'political' 및 'locality' https://developers.google.com/places/web-service/supported_types

associated_compounds[]

Compound

장소와 연결된 화합물입니다.

PlacePickupPointResult

연결된 장소 ID가 있는 승차 지점

필드
pickup_point_result

PickupPointResult

승차 장소에 대한 세부정보입니다. 있어야 합니다.

associated_place_id

string

연결된 장소의 장소 ID입니다.

PlaceResult

장소 검색결과에 대한 세부정보입니다.

필드
place

Place

장소에 대한 세부정보입니다.

distance_meters

float

검색 위치에서 장소 도형 또는 중심까지의 직선 거리입니다.

TrafficRestrictionEnums

위치의 교통 제한 유형입니다.

TrafficRestriction

트래픽 제한의 값입니다.

열거형
TRAFFIC_RESTRICTION_UNSPECIFIED 제한사항이 지정되지 않았습니다.
NO_RESTRICTION 적용된 트래픽 제한이 없습니다.
OTHER_RESTRICTION 사유 도로이거나 관련 위치 이용 시 수수료를 내야 하는 경우 등 일부 교통 제한이 적용될 수 있습니다.

TravelDetail

여행과 관련된 세부정보입니다.

필드
travel_mode

TravelMode

ETA가 계산되는 이동 수단입니다.

estimated_arrival_time

Timestamp

예상 도착 시간입니다. 도보 도착예정시간은 요청에 compute_walking_eta가 설정되면 검색 위치에서 승차 지점 위치까지 계산됩니다. compute_driving_eta 및 목적지가 요청에 설정된 경우 운전 도착예정시간은 승차 지점 위치에서부터 보행자가 아닌 사람이 요청한 각 이동 수단에 대한 목적지까지 계산됩니다. 운전 도착예정시간은 교통정보를 바탕으로 계산되며 정체 제한이 적용되지 않습니다.

traffic_restriction

TrafficRestriction

이동 수단에 적용되는 제한사항입니다.

TravelModeEnums

특정 위치로 이동하는 데 사용할 수 있는 이동 수단의 목록입니다.

TravelMode

이동 수단의 값입니다.

열거형
TRAVEL_MODE_UNSPECIFIED 이동 모드가 지정되지 않았습니다.
WALKING 보행자 전용 도로입니다.
DRIVING 운전, 승용차에 사용됩니다.
TWO_WHEELER 전동식 오토바이 (예: 오토바이, 모페드)

WiFiAccessPoint

Wi-Fi 액세스 포인트 정보

필드
mac_address

int64

액세스 포인트의 MAC 주소입니다.

strength_dbm

sint32

액세스 포인트의 신호 강도(dBm)입니다.