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

주소의 일부를 설명하는 이 구성요소의 이름입니다. 예: '캘리포니아', 'Amphitheatre Parkway'

component_text_short_form

string

짧은 형식의 구성요소 텍스트입니다. 예를 들어 '캘리포니아'의 경우 'CA', '미국'의 경우 '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

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

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

필수 항목입니다. 요청이 발생한 위치의 유니코드 국가/지역 코드 (예: '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

장소와 연결된 텍스트 필드의 언어 코드입니다. 예를 들어 '이름' 및 '주소'입니다.

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

도착예정시간이 계산되는 이동 모드입니다.

estimated_arrival_time

Timestamp

예상 도착 시간입니다. compute_walking_eta가 요청에 설정된 경우 검색 위치에서 수령 지점 위치까지의 도보 예상 시간이 계산됩니다. 운전 도착 예정 시간은 요청에 compute_driving_eta 및 destination이 설정된 경우, 요청된 비도보 이동 수단별로 픽업 지점 위치에서 목적지까지 계산됩니다. 도착 예상 시간은 교통량을 고려하여 계산되며, 혼잡 제한은 적용되지 않습니다.

traffic_restriction

TrafficRestriction

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

TravelModeEnums

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

TravelMode

이동 수단의 값입니다.

열거형
TRAVEL_MODE_UNSPECIFIED 이동 모드가 지정되지 않았습니다.
WALKING Walking(보행): 보행자에게 사용됩니다.
DRIVING 운전: 승용차에 사용됩니다.
TWO_WHEELER 모터가 장착된 이륜차(예: 오토바이 또는 모페드)

WiFiAccessPoint

Wi-Fi 액세스 포인트 정보

필드
mac_address

int64

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

strength_dbm

sint32

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