Package google.maps.places.v1

색인

• Places(인터페이스)
• AddressDescriptor(메시지)
• AddressDescriptor.Area(메시지)
• AddressDescriptor.Area.Containment(열거형)
• AddressDescriptor.Landmark(메시지)
• AddressDescriptor.Landmark.SpatialRelationship(열거형)
• AuthorAttribution(메시지)
• AutocompletePlacesRequest(메시지)
• AutocompletePlacesRequest.LocationBias(메시지)
• AutocompletePlacesRequest.LocationRestriction(메시지)
• AutocompletePlacesResponse(메시지)
• AutocompletePlacesResponse.Suggestion(메시지)
• AutocompletePlacesResponse.Suggestion.FormattableText(메시지)
• AutocompletePlacesResponse.Suggestion.PlacePrediction(메시지)
• AutocompletePlacesResponse.Suggestion.QueryPrediction(메시지)
• AutocompletePlacesResponse.Suggestion.StringRange(메시지)
• AutocompletePlacesResponse.Suggestion.StructuredFormat(메시지)
• Circle(메시지)
• ContentBlock(메시지)
• ContextualContent(메시지)
• ContextualContent.Justification(메시지)
• ContextualContent.Justification.BusinessAvailabilityAttributesJustification(메시지)
• ContextualContent.Justification.ReviewJustification(메시지)
• ContextualContent.Justification.ReviewJustification.HighlightedText(메시지)
• ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange(메시지)
• EVChargeOptions(메시지)
• EVChargeOptions.ConnectorAggregation(메시지)
• EVConnectorType(열거형)
• FuelOptions(메시지)
• FuelOptions.FuelPrice(메시지)
• FuelOptions.FuelPrice.FuelType(열거형)
• GetPhotoMediaRequest(메시지)
• GetPlaceRequest(메시지)
• Photo(메시지)
• PhotoMedia(메시지)
• Place(메시지)
• Place.AccessibilityOptions(메시지)
• Place.AddressComponent(메시지)
• Place.Attribution(메시지)
• Place.BusinessStatus(열거형)
• Place.ConsumerAlert(메시지)
• Place.ConsumerAlert.Details(메시지)
• Place.ConsumerAlert.Details.Link(메시지)
• Place.ContainingPlace(메시지)
• Place.EvChargeAmenitySummary(메시지)
• Place.GenerativeSummary(메시지)
• Place.GoogleMapsLinks(메시지)
• Place.NeighborhoodSummary(메시지)
• Place.OpeningHours(메시지)
• Place.OpeningHours.Period(메시지)
• Place.OpeningHours.Period.Point(메시지)
• Place.OpeningHours.SecondaryHoursType(열거형)
• Place.OpeningHours.SpecialDay(메시지)
• Place.ParkingOptions(메시지)
• Place.PaymentOptions(메시지)
• Place.PlusCode(메시지)
• Place.ReviewSummary(메시지)
• Place.SubDestination(메시지)
• Polyline(메시지)
• PriceLevel(열거형)
• PriceRange(메시지)
• Review(메시지)
• RouteModifiers(메시지)
• RoutingParameters(메시지)
• RoutingPreference(열거형)
• RoutingSummary(메시지)
• RoutingSummary.Leg(메시지)
• SearchNearbyRequest(메시지)
• SearchNearbyRequest.LocationRestriction(메시지)
• SearchNearbyRequest.RankPreference(열거형)
• SearchNearbyResponse(메시지)
• SearchTextRequest(메시지)
• SearchTextRequest.EVOptions(메시지)
• SearchTextRequest.LocationBias(메시지)
• SearchTextRequest.LocationRestriction(메시지)
• SearchTextRequest.RankPreference(열거형)
• SearchTextRequest.SearchAlongRouteParameters(메시지)
• SearchTextResponse(메시지)
• TravelMode(열거형)

장소

Places API의 서비스 정의입니다. 참고: 모든 요청 (Autocomplete 및 GetPhotoMedia 요청 제외)에는 요청 프로토콜 (all/*, 가정되지 않음) 외부에 설정된 필드 마스크가 필요합니다. 필드 마스크는 HTTP 헤더 X-Goog-FieldMask를 통해 설정할 수 있습니다. https://developers.google.com/maps/documentation/places/web-service/choose-fields를 참고하세요.

AutocompletePlaces
rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse) 지정된 입력에 대한 예측을 반환합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/cloud-platform

GetPhotoMedia
rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia) 사진 참조 문자열이 있는 사진 미디어를 가져옵니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/cloud-platform

GetPlace
rpc GetPlace(GetPlaceRequest) returns (Place) places/{place_id} 형식의 문자열인 리소스 이름을 기반으로 장소의 세부정보를 가져옵니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/cloud-platform

SearchNearby
rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse) 위치 주변의 장소를 검색합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/cloud-platform

SearchText
rpc SearchText(SearchTextRequest) returns (SearchTextResponse) 텍스트 쿼리 기반 장소 검색입니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

위치의 관계형 설명입니다. 주변 명소의 순위가 지정된 집합과 정확한 포함 영역 및 타겟 위치와의 관계를 포함합니다.

필드
landmarks[]	Landmark 주변 명소의 순위가 매겨진 목록입니다. 가장 잘 알려져 있고 가까운 명소가 먼저 표시됩니다.
areas[]	Area 포함된 영역 또는 인접한 영역의 순위가 지정된 목록입니다. 가장 인식하기 쉽고 정확한 영역이 1위로 표시됩니다.

지역

지역 정보와 대상 위치와의 지역 관계입니다.

지역에는 위치를 설명하는 데 유용한 정확한 하위 지역, 동네, 대규모 단지가 포함됩니다.

필드
name	string 지역의 리소스 이름입니다.
place_id	string 지역의 장소 ID입니다.
display_name	LocalizedText 지역의 표시 이름입니다.
containment	Containment 타겟 위치와 영역 간의 공간적 관계를 정의합니다.

격리

타겟 위치와 영역 간의 공간적 관계를 정의합니다.

열거형
CONTAINMENT_UNSPECIFIED	포함이 지정되지 않았습니다.
WITHIN	타겟 위치가 영역 리전 내에 있으며 중심에 가깝습니다.
OUTSKIRTS	타겟 위치가 영역 리전 내에 있으며 가장자리에 가깝습니다.
NEAR	타겟 위치가 지역 영역 외부에 있지만 가까운 곳에 있습니다.

명소

기본적인 랜드마크 정보와 랜드마크와 타겟 위치의 관계입니다.

랜드마크는 위치를 설명하는 데 사용할 수 있는 유명한 장소입니다.

필드
name	string 랜드마크의 리소스 이름입니다.
place_id	string 랜드마크의 장소 ID입니다.
display_name	LocalizedText 랜드마크의 표시 이름입니다.
types[]	string 이 랜드마크의 유형 태그 집합입니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types를 참고하세요.
spatial_relationship	SpatialRelationship 타겟 위치와 랜드마크 간의 공간적 관계를 정의합니다.
straight_line_distance_meters	float 타겟의 중심점과 랜드마크의 중심점 사이의 직선 거리(미터)입니다. 경우에 따라 이 값이 travel_distance_meters보다 길어질 수 있습니다.
travel_distance_meters	float 타겟에서 랜드마크까지의 도로 네트워크를 따라 이동한 거리(미터)입니다(알려진 경우). 이 값은 도보, 운전, 자전거와 같은 교통수단을 고려하지 않습니다.

SpatialRelationship

타겟 위치와 랜드마크 간의 공간적 관계를 정의합니다.

열거형
NEAR	아래의 더 구체적인 내용이 적용되지 않는 경우 기본 관계입니다.
WITHIN	랜드마크에 공간 지오메트리가 있고 타겟이 경계 내에 있습니다.
BESIDE	타겟이 랜드마크에 바로 인접해 있습니다.
ACROSS_THE_ROAD	타겟이 도로 건너편의 랜드마크와 정반대입니다.
DOWN_THE_ROAD	랜드마크와 동일한 경로에 있지만 옆이나 건너편에 있지 않습니다.
AROUND_THE_CORNER	랜드마크와 동일한 경로에 있지 않지만 한 번만 회전하면 됩니다.
BEHIND	랜드마크의 구조에 가깝지만 거리 입구에서 더 멀리 떨어져 있습니다.

AuthorAttribution

UGC 데이터의 작성자에 관한 정보입니다. Photo 및 Review에서 사용됩니다.

필드
display_name	string Photo 또는 Review의 작성자 이름입니다.
uri	string Photo 또는 Review의 작성자 URI입니다.
photo_uri	string Photo 또는 Review 작성자의 프로필 사진 URI입니다.

AutocompletePlacesRequest

AutocompletePlaces의 요청 프로토입니다.

필드
input	string 필수 항목입니다. 검색할 텍스트 문자열입니다.
location_bias	LocationBias 선택사항입니다. 지정된 위치에 편중된 결과 location_bias 또는 location_restriction 중 하나만 설정해야 합니다. 둘 다 설정되지 않은 경우 결과는 IP 주소에 따라 편향됩니다. 즉, IP 주소가 부정확한 위치에 매핑되고 편향 신호로 사용됩니다.
location_restriction	LocationRestriction 선택사항입니다. 결과를 지정된 위치로 제한합니다. location_bias 또는 location_restriction 중 하나만 설정해야 합니다. 둘 다 설정되지 않은 경우 결과는 IP 주소에 따라 편향됩니다. 즉, IP 주소가 부정확한 위치에 매핑되고 편향 신호로 사용됩니다.
included_primary_types[]	string 선택사항입니다. 장소 유형 (https://developers.google.com/maps/documentation/places/web-service/place-types))에 포함된 기본 장소 유형 (예: 'restaurant' 또는 'gas_station') 또는 (regions)만 또는 (cities)만 기본 유형이 이 목록에 포함된 경우에만 장소가 반환됩니다. 최대 5개의 값을 지정할 수 있습니다. 유형을 지정하지 않으면 모든 장소 유형이 반환됩니다.
included_region_codes[]	string 선택사항입니다. 최대 15개의 CLDR 2자리 지역 코드로 지정된 지역의 결과만 포함합니다. 빈 집합은 결과를 제한하지 않습니다. location_restriction와 included_region_codes가 모두 설정된 경우 결과는 교차 영역에 위치합니다.
language_code	string 선택사항입니다. 결과를 반환할 언어입니다. 기본값은 en-US입니다. input에 사용된 언어가 language_code와 다르거나 반환된 장소에 현지 언어에서 language_code로의 번역이 없는 경우 결과가 혼합된 언어로 표시될 수 있습니다.
region_code	string 선택사항입니다. 지역 코드입니다. CLDR 2자리 지역 코드로 지정됩니다. 이는 주소 형식, 결과 순위에 영향을 미치며 반환되는 결과에 영향을 줄 수 있습니다. 이렇게 해도 결과가 지정된 지역으로 제한되지는 않습니다. 결과를 리전으로 제한하려면 region_code_restriction을 사용합니다.
origin	LatLng 선택사항입니다. 목적지까지의 측지 거리를 계산할 원점입니다 (distance_meters로 반환됨). 이 값을 생략하면 측지 거리가 반환되지 않습니다.
input_offset	int32 선택사항입니다. input의 커서 위치를 나타내는 0부터 시작하는 유니코드 문자 오프셋 input입니다. 커서 위치는 반환되는 예측에 영향을 줄 수 있습니다. 비어 있으면 기본값은 input의 길이입니다.
include_query_predictions	bool 선택사항입니다. true인 경우 응답에 장소와 쿼리 예측이 모두 포함됩니다. 그렇지 않으면 응답에서 장소 예상 검색어만 반환합니다.
session_token	string 선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. 최대 길이가 36개의 ASCII 문자인 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. 세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 장소를 선택하고 Place Details 또는 Address Validation 호출이 이루어지면 종료됩니다. 세션마다 여러 개의 쿼리가 포함될 수 있으며 하나의 장소 세부정보 또는 주소 유효성 검사 요청이 이어집니다. 세션 내 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱에서 각 세션에 대해 새 토큰을 생성해야 합니다. session_token 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨). 다음 가이드라인이 권장됩니다. 모든 Place Autocomplete 호출에 세션 토큰을 사용합니다. 각 세션에 대해 새 토큰을 생성합니다. 버전 4 UUID를 사용하는 것이 좋습니다. 세션 내의 모든 Place Autocomplete, Place Details, Address Validation 요청에 사용되는 사용자 인증 정보가 동일한 Cloud Console 프로젝트에 속하는지 확인합니다. 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 두 개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.
include_pure_service_area_businesses	bool 선택사항입니다. 필드가 true로 설정된 경우 순수 방문 서비스 업체를 포함합니다. 순수 방문 서비스 업체는 고객에게 방문 또는 배달 서비스를 제공하지만 비즈니스 주소지에서는 고객에게 서비스를 제공하지 않는 비즈니스입니다. 청소 서비스 또는 배관공 등의 비즈니스가 있습니다. 이러한 비즈니스에는 Google 지도에 실제 주소나 위치가 없습니다. 장소에서는 이러한 비즈니스에 대해 location, plus_code 및 기타 위치 관련 필드를 반환하지 않습니다.

LocationBias

검색할 지역입니다. 결과가 지정된 지역을 중심으로 편향될 수 있습니다.

필드
통합 필드 type. type는 다음 중 하나여야 합니다.
rectangle	Viewport 북동쪽 모서리와 남서쪽 모서리로 정의된 뷰포트입니다.
circle	Circle 중심점과 반지름으로 정의된 원입니다.

LocationRestriction

검색할 지역입니다. 결과는 지정된 지역으로 제한됩니다.

필드
통합 필드 type. type는 다음 중 하나여야 합니다.
rectangle	Viewport 북동쪽 모서리와 남서쪽 모서리로 정의된 뷰포트입니다.
circle	Circle 중심점과 반지름으로 정의된 원입니다.

AutocompletePlacesResponse

AutocompletePlaces의 응답 프로토입니다.

필드
suggestions[]	Suggestion 관련성의 내림차순으로 정렬된 제안 목록이 포함됩니다.

추천

자동 완성 추천 결과입니다.

필드
통합 필드 kind. kind는 다음 중 하나여야 합니다.
place_prediction	PlacePrediction 장소에 대한 예측입니다.
query_prediction	QueryPrediction 질문에 대한 예측입니다.

FormattableText

장소 또는 쿼리 예측을 나타내는 텍스트입니다. 텍스트는 그대로 사용하거나 서식을 지정하여 사용할 수 있습니다.

필드
text	string 그대로 사용하거나 matches로 형식을 지정할 수 있는 텍스트입니다.
matches[]	StringRange text에서 입력 요청이 일치하는 위치를 식별하는 문자열 범위 목록입니다. 범위를 사용하여 text의 특정 부분의 형식을 지정할 수 있습니다. 문자열 일치 외의 기준 (예: 맞춤법 수정 또는 음역)에 따라 일치가 결정된 경우 하위 문자열이 input과 정확히 일치하지 않을 수 있습니다. 이러한 값은 text의 유니코드 문자 오프셋입니다. 범위는 오프셋 값이 증가하는 순서로 정렬됩니다.

PlacePrediction

Place Autocomplete 예상 검색어의 예상 결과입니다.

필드
place	string 추천 장소의 리소스 이름입니다. 이 이름은 장소 이름을 허용하는 다른 API에서 사용할 수 있습니다.
place_id	string 추천 장소의 고유 식별자입니다. 이 식별자는 장소 ID를 허용하는 다른 API에서 사용할 수 있습니다.
text	FormattableText 반환된 결과의 사람이 읽을 수 있는 이름을 포함합니다. 시설 결과의 경우 일반적으로 업체 이름과 주소입니다. text는 단일 UI 요소를 표시하려는 개발자에게 권장됩니다. 별개이지만 관련이 있는 두 UI 요소를 표시하려는 개발자는 대신 structured_format를 사용하는 것이 좋습니다. 장소 예측을 나타내는 두 가지 방법입니다. 사용자는 structured_format를 text로 파싱하거나 그 반대로 파싱하려고 하면 안 됩니다. 이 텍스트는 GetPlace에서 반환된 display_name와 다를 수 있습니다. 요청 input 및 language_code이 서로 다른 언어로 되어 있거나 장소에 현지 언어에서 language_code으로의 번역이 없는 경우 혼합된 언어로 표시될 수 있습니다.
structured_format	StructuredFormat 장소 예측을 장소 이름을 포함하는 기본 텍스트와 추가적인 명확성 기능 (예: 도시 또는 지역)을 포함하는 보조 텍스트로 분류합니다. structured_format는 별개이지만 관련이 있는 두 UI 요소를 표시하려는 개발자에게 권장됩니다. 단일 UI 요소를 표시하려는 개발자는 대신 text를 사용하는 것이 좋습니다. 장소 예측을 나타내는 두 가지 방법입니다. 사용자는 structured_format를 text로 파싱하거나 그 반대로 파싱하려고 하면 안 됩니다.
types[]	string https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 또는 표 B에 나오는 이 장소에 적용되는 유형 목록입니다. 유형은 장소의 분류입니다. 공유 유형이 있는 장소는 유사한 특징을 공유합니다.
distance_meters	int32 origin가 지정된 경우 origin에서 최단 거리의 길이(미터)입니다. 경로와 같은 일부 예측은 이 필드를 채우지 않을 수 있습니다.

QueryPrediction

Query Autocomplete 예측의 예측 결과입니다.

필드
text	FormattableText 예측된 텍스트입니다. 이 텍스트는 장소를 나타내는 것이 아니라 검색 엔드포인트 (예: 텍스트 검색)에서 사용할 수 있는 텍스트 쿼리를 나타냅니다. text는 단일 UI 요소를 표시하려는 개발자에게 권장됩니다. 별개이지만 관련이 있는 두 UI 요소를 표시하려는 개발자는 대신 structured_format를 사용하는 것이 좋습니다. 이는 쿼리 예측을 나타내는 두 가지 방법입니다. 사용자는 structured_format를 text로 파싱하거나 그 반대로 파싱하려고 하면 안 됩니다. 요청 input과 language_code이 서로 다른 언어로 되어 있거나 쿼리의 일부가 현지 언어에서 language_code으로 번역되지 않은 경우 언어가 혼합될 수 있습니다.
structured_format	StructuredFormat 질문을 포함하는 기본 텍스트와 추가적인 명확성 확보 기능 (예: 도시 또는 지역)을 포함하는 보조 텍스트로 질문 예측이 분류됩니다. structured_format는 별개이지만 관련이 있는 두 UI 요소를 표시하려는 개발자에게 권장됩니다. 단일 UI 요소를 표시하려는 개발자는 대신 text를 사용하는 것이 좋습니다. 이는 쿼리 예측을 나타내는 두 가지 방법입니다. 사용자는 structured_format를 text로 파싱하거나 그 반대로 파싱하려고 하면 안 됩니다.

StringRange

주어진 텍스트 내에서 하위 문자열을 식별합니다.

필드
start_offset	int32 문자열의 첫 번째 유니코드 문자의 0 기반 오프셋입니다 (포함).
end_offset	int32 마지막 유니코드 문자의 0부터 시작하는 오프셋입니다 (제외).

StructuredFormat

장소 또는 쿼리 예측을 기본 텍스트와 보조 텍스트로 분류한 내용을 포함합니다.

장소 예측의 경우 기본 텍스트에 장소의 구체적인 이름이 포함됩니다. 질문 예측의 경우 기본 텍스트에 질문이 포함됩니다.

보조 텍스트에는 장소를 추가로 식별하거나 쿼리를 구체화하기 위한 추가적인 명확성 기능 (예: 도시 또는 지역)이 포함됩니다.

필드
main_text	FormattableText 장소 또는 검색어의 이름을 나타냅니다.
secondary_text	FormattableText 장소를 추가로 식별하거나 쿼리를 구체화하기 위한 추가적인 명확성 확보 기능 (예: 도시 또는 지역)을 나타냅니다.

원

LatLng를 중심과 반경으로 하는 원입니다.

필드
center	LatLng 필수 항목입니다. 중심 위도 및 경도입니다. 위도 범위는 [-90.0, 90.0]이어야 합니다. 경도 범위는 [-180.0, 180.0]이어야 합니다.
radius	double 필수 항목입니다. 반지름(단위: 미터)입니다. 반지름은 [0.0, 50000.0] 범위 내에 있어야 합니다.

ContentBlock

개별적으로 제공될 수 있는 콘텐츠 블록입니다.

필드
content	LocalizedText 주제와 관련된 콘텐츠
referenced_places[]	string 참조된 장소의 리소스 이름 목록입니다. 이 이름은 장소 리소스 이름을 허용하는 다른 API에서 사용할 수 있습니다.

ContextualContent

실험 단계: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

장소 쿼리와 관련된 콘텐츠

필드
reviews[]	Review 이 장소에 대한 리뷰 목록으로, 장소 쿼리와 관련이 있습니다.
photos[]	Photo 이 장소의 사진에 관한 정보 (참조 포함)로, 장소 쿼리와 관련이 있습니다.
justifications[]	Justification 실험 단계: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 장소에 대한 근거입니다.

근거

실험 단계: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

장소에 대한 근거입니다. 근거는 장소가 최종 사용자에게 흥미로울 수 있는 이유에 대한 질문에 답합니다.

필드
통합 필드 justification. justification는 다음 중 하나여야 합니다.
review_justification	ReviewJustification 실험 단계: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.
business_availability_attributes_justification	BusinessAvailabilityAttributesJustification 실험 단계: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

BusinessAvailabilityAttributesJustification

실험 단계: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. BusinessAvailabilityAttributes 근거입니다. 비즈니스에 최종 사용자의 관심을 끌 수 있는 속성이 표시됩니다.

필드
takeout	bool 장소에서 테이크아웃을 제공하는지 여부입니다.
delivery	bool 장소에서 배달을 제공하는 경우
dine_in	bool 장소에서 매장 내 식사를 제공하는지 여부입니다.

ReviewJustification

실험 단계: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

사용자 리뷰 근거입니다. 최종 사용자의 관심을 끌 만한 사용자 리뷰의 섹션을 강조 표시합니다. 예를 들어 검색어가 '장작 피자'인 경우 리뷰 근거에는 검색어와 관련된 텍스트가 강조 표시됩니다.

필드
highlighted_text	HighlightedText
review	Review 강조 표시된 텍스트가 생성된 리뷰입니다.

HighlightedText

근거에 의해 강조 표시된 텍스트입니다. 이는 리뷰 자체의 하위 집합입니다. 강조 표시할 정확한 단어는 HighlightedTextRange로 표시됩니다. 텍스트에서 여러 단어가 강조 표시될 수 있습니다.

필드
text	string
highlighted_text_ranges[]	HighlightedTextRange 강조 표시된 텍스트의 범위 목록입니다.

HighlightedTextRange

강조 표시된 텍스트의 범위입니다.

필드
start_index	int32
end_index	int32

EVChargeOptions

장소에 호스팅된 전기자동차 충전소에 관한 정보입니다. 용어는 https://afdc.energy.gov/fuels/electricity_infrastructure.html을 따릅니다. 한 포트에서 한 번에 한 대의 자동차를 충전할 수 있습니다. 하나의 포트에는 하나 이상의 커넥터가 있습니다. 하나의 충전소에는 하나 이상의 포트가 있습니다.

필드
connector_count	int32 이 충전소의 커넥터 수입니다. 하지만 일부 포트에는 커넥터가 여러 개 있을 수 있지만 한 번에 한 대의 자동차만 충전할 수 있으므로 (예:) 커넥터 수가 동시에 충전할 수 있는 자동차의 총수보다 클 수 있습니다.
connector_aggregation[]	ConnectorAggregation 동일한 유형과 동일한 충전 속도의 커넥터가 포함된 EV 충전 커넥터 집계 목록입니다.

ConnectorAggregation

[type, max_charge_rate_kw]별로 그룹화된 EV 충전 정보입니다. 유형과 최대 충전 속도(kW)가 동일한 커넥터의 EV 충전 집계를 표시합니다.

필드
type	EVConnectorType 이 집계의 커넥터 유형입니다.
max_charge_rate_kw	double 집계에 있는 각 커넥터의 정적 최대 충전 속도(kW)입니다.
count	int32 이 집계의 커넥터 수입니다.
availability_last_update_time	Timestamp 이 집계의 커넥터 가용성 정보가 마지막으로 업데이트된 타임스탬프입니다.
available_count	int32 현재 사용 가능한 이 집계의 커넥터 수입니다.
out_of_service_count	int32 현재 서비스 중단된 이 집계의 커넥터 수입니다.

EVConnectorType

EV 충전 커넥터 유형에 관한 추가 정보/맥락은 http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107을 참고하세요.

열거형
EV_CONNECTOR_TYPE_UNSPECIFIED	지정되지 않은 커넥터입니다.
EV_CONNECTOR_TYPE_OTHER	기타 커넥터 유형입니다.
EV_CONNECTOR_TYPE_J1772	J1772 유형 1 커넥터
EV_CONNECTOR_TYPE_TYPE_2	IEC 62196 유형 2 커넥터 MENNEKES라고도 합니다.
EV_CONNECTOR_TYPE_CHADEMO	CHAdeMO 유형 커넥터
EV_CONNECTOR_TYPE_CCS_COMBO_1	Combined Charging System (AC 및 DC) SAE를 기반으로 합니다. 타입 1 J-1772 커넥터
EV_CONNECTOR_TYPE_CCS_COMBO_2	Combined Charging System (AC 및 DC) Type-2 Mennekes 커넥터 기반
EV_CONNECTOR_TYPE_TESLA	일반 TESLA 커넥터입니다. 북미에서는 NACS이지만 세계 다른 지역에서는 NACS가 아닐 수 있습니다 (예: CCS Combo 2 (CCS2) 또는 GB/T). 이 값은 실제 커넥터 유형을 나타내기보다는 Tesla 소유 충전소에서 Tesla 브랜드 차량을 충전할 수 있는 기능을 나타냅니다.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T	GB/T 유형은 중국의 GB/T 표준에 해당합니다. 이 유형은 모든 GB_T 유형을 포함합니다.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET	지정되지 않은 전원 콘센트입니다.
EV_CONNECTOR_TYPE_NACS	북미 충전 시스템 (NACS), SAE J3400으로 표준화됨

FuelOptions

주유소의 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다.

필드
fuel_prices[]	FuelPrice 이 주유소에서 판매하는 각 연료 유형의 마지막으로 알려진 연료 가격입니다. 이 주유소에서 판매하는 연료 유형당 하나의 항목이 있습니다. 순서는 중요하지 않습니다.

FuelPrice

특정 유형의 연료 가격 정보입니다.

필드
type	FuelType 연료 유형입니다.
price	Money 연료 가격입니다.
update_time	Timestamp 연료 가격이 마지막으로 업데이트된 시간입니다.

FuelType

연료 유형입니다.

열거형
FUEL_TYPE_UNSPECIFIED	지정되지 않은 연료 유형입니다.
DIESEL	디젤 연료
DIESEL_PLUS	디젤 연료
REGULAR_UNLEADED	일반 무연
MIDGRADE	중급
PREMIUM	Premium
SP91	SP 91.
SP91_E10	SP 91 E10
SP92	SP 92.
SP95	SP 95.
SP95_E10	SP95 E10
SP98	SP 98.
SP99	SP 99.
SP100	SP 100
LPG	액화 석유 가스
E80	E 80.
E85	E 85.
E100	E 100.
METHANE	메탄
BIO_DIESEL	바이오디젤
TRUCK_DIESEL	트럭 디젤

GetPhotoMediaRequest

사진 리소스 이름을 사용하여 장소의 사진을 가져오기 위한 요청입니다.

필드
name	string 필수 항목입니다. 사진 미디어의 리소스 이름입니다(places/{place_id}/photos/{photo_reference}/media 형식). 장소 객체의 photos.name 필드에 반환되는 사진의 리소스 이름은 places/{place_id}/photos/{photo_reference} 형식입니다. 사진 미디어 리소스 이름을 가져오려면 사진 리소스 끝에 /media을 추가해야 합니다.
max_width_px	int32 선택사항입니다. 이미지의 원하는 최대 너비를 픽셀 단위로 지정합니다. 이미지가 지정된 값보다 작은 경우 원래 이미지가 반환됩니다. 이미지가 두 측정기준 중 하나에서 더 큰 경우 원래 가로세로 비율로 제한된 두 측정기준 중 더 작은 측정기준에 맞게 조정됩니다. max_height_px 및 max_width_px 속성은 모두 1~4800(포함) 사이의 정수를 허용합니다. 값이 허용된 범위 내에 있지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. max_height_px 또는 max_width_px 중 하나 이상을 지정해야 합니다. max_height_px와 max_width_px가 모두 지정되지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
max_height_px	int32 선택사항입니다. 이미지의 원하는 최대 높이를 픽셀 단위로 지정합니다. 이미지가 지정된 값보다 작은 경우 원래 이미지가 반환됩니다. 이미지가 두 측정기준 중 하나에서 더 큰 경우 원래 가로세로 비율로 제한된 두 측정기준 중 더 작은 측정기준에 맞게 조정됩니다. max_height_px 및 max_width_px 속성은 모두 1~4800(포함) 사이의 정수를 허용합니다. 값이 허용된 범위 내에 있지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. max_height_px 또는 max_width_px 중 하나 이상을 지정해야 합니다. max_height_px와 max_width_px가 모두 지정되지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
skip_http_redirect	bool 선택사항입니다. 설정된 경우 기본 HTTP 리디렉션 동작을 건너뛰고 텍스트 형식 (예: HTTP 사용 사례의 경우 JSON 형식) 응답을 렌더링합니다. 설정되지 않은 경우 호출을 이미지 미디어로 리디렉션하는 HTTP 리디렉션이 실행됩니다. HTTP가 아닌 요청의 경우 이 옵션은 무시됩니다.

GetPlaceRequest

places/{place_id} 형식의 문자열인 리소스 이름을 기반으로 장소를 가져오기 위한 요청입니다.

필드
name	string 필수 항목입니다. places/{place_id} 형식의 장소 리소스 이름입니다.
language_code	string 선택사항입니다. 사용 가능한 경우 기본 언어로 장소 세부정보가 표시됩니다. 현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport
region_code	string 선택사항입니다. 요청이 전송된 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 사용 가능한 경우 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칠 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참고하세요. 현재 3자리 지역 코드는 지원되지 않습니다.
session_token	string 선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. 최대 길이가 36개의 ASCII 문자인 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. 세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 장소를 선택하고 Place Details 또는 Address Validation 호출이 이루어지면 종료됩니다. 세션마다 여러 개의 쿼리가 포함될 수 있으며 하나의 장소 세부정보 또는 주소 유효성 검사 요청이 이어집니다. 세션 내 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱에서 각 세션에 대해 새 토큰을 생성해야 합니다. session_token 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨). 다음 가이드라인이 권장됩니다. 모든 Place Autocomplete 호출에 세션 토큰을 사용합니다. 각 세션에 대해 새 토큰을 생성합니다. 버전 4 UUID를 사용하는 것이 좋습니다. 세션 내의 모든 Place Autocomplete, Place Details, Address Validation 요청에 사용되는 사용자 인증 정보가 동일한 Cloud Console 프로젝트에 속하는지 확인합니다. 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 두 개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.

사진

장소의 사진에 관한 정보입니다.

필드
name	string 식별자. 이 장소 사진을 나타내는 참조로, 이 장소 사진을 다시 조회하는 데 사용할 수 있습니다 (API '리소스' 이름: places/{place_id}/photos/{photo}이라고도 함).
width_px	int32 사용 가능한 최대 너비(픽셀)입니다.
height_px	int32 사용 가능한 최대 높이(픽셀)입니다.
author_attributions[]	AuthorAttribution 이 사진의 작성자입니다.
flag_content_uri	string 사용자가 사진 문제를 신고할 수 있는 링크
google_maps_uri	string Google 지도에 사진을 표시하는 링크

PhotoMedia

Places API의 사진 미디어입니다.

필드
name	string 사진 미디어의 리소스 이름입니다(places/{place_id}/photos/{photo_reference}/media 형식).
photo_uri	string 사진을 렌더링하는 데 사용할 수 있는 단기 URI입니다.

장소

장소를 나타내는 모든 정보입니다.

필드
name	string 이 장소의 리소스 이름입니다(places/{place_id} 형식). 장소를 조회하는 데 사용할 수 있습니다.
id	string 장소의 고유 식별자입니다.
display_name	LocalizedText 사람이 읽을 수 있는 짧은 설명으로 적합한 장소의 현지화된 이름입니다. 예: 'Google 시드니', '스타벅스', '파이어몬트' 등
types[]	string 이 결과의 유형 태그 집합입니다. 예를 들어 'political' 및 'locality'가 있습니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A와 표 B를 참고하세요.
primary_type	string 주어진 결과의 기본 유형입니다. 이 유형은 Places API 지원 유형 중 하나여야 합니다. 예를 들어 'restaurant', 'cafe', 'airport' 등이 있습니다. 장소에는 하나의 기본 유형만 있을 수 있습니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A와 표 B를 참고하세요. 장소의 기본 유형이 지원되는 유형이 아닌 경우 기본 유형이 누락될 수 있습니다. 기본 유형이 있는 경우 항상 types 필드의 유형 중 하나입니다.
primary_type_display_name	LocalizedText 기본 유형의 표시 이름입니다. 요청 언어로 현지화됩니다(해당하는 경우). 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A와 표 B를 참고하세요. 장소의 기본 유형이 지원되는 유형이 아닌 경우 기본 유형이 누락될 수 있습니다.
national_phone_number	string 국가 코드 포함 형식의 사람이 읽을 수 있는 장소의 전화번호입니다.
international_phone_number	string 장소의 사람이 읽을 수 있는 전화번호(국가 코드 포함 형식)입니다.
formatted_address	string 이 장소의 전체 주소(사람이 읽을 수 있는 형식)입니다.
short_formatted_address	string 이 장소의 짧고 사람이 읽을 수 있는 주소입니다.
postal_address	PostalAddress 우편 주소 형식의 주소입니다.
address_components[]	AddressComponent 각 지역 수준에 대해 반복되는 구성요소입니다. address_components[] 배열에 관한 다음 사실을 참고하세요. - 주소 구성요소의 배열에 formatted_address보다 더 많은 구성요소가 포함될 수도 있습니다. - 배열에는 formatted_address에 포함된 것 외에 주소가 포함된 모든 정치적 독립체가 포함되지 않을 수 있습니다. 특정 주소가 포함된 모든 정치적 독립체를 가져오려면 역 지오코딩을 사용하여 주소의 위도/경도를 매개변수로 요청에 전달해야 합니다. - 응답의 형식이 요청 간에 동일하게 유지되지 않을 수도 있습니다. 특히 address_components의 수는 요청된 주소에 따라 다르며 동일한 주소에 대해서도 시간이 지남에 따라 변경될 수 있습니다. 배열에서 구성요소의 위치가 변경될 수 있습니다. 구성요소의 유형이 변경될 수 있습니다. 특정 구성요소가 이후 응답에서 누락될 수 있습니다.
plus_code	PlusCode 장소 위치의 위도/경도에 해당하는 Plus Code입니다.
location	LatLng 이 장소의 위치입니다.
viewport	Viewport 평균 크기의 지도에 장소를 표시하는 데 적합한 표시 영역입니다. 이 뷰포트는 비즈니스의 실제 경계 또는 서비스 지역으로 사용하면 안 됩니다.
rating	double 이 장소에 대한 사용자 리뷰를 기반으로 한 평점(1.0~5.0)입니다.
google_maps_uri	string 이 장소에 대한 자세한 정보를 제공하는 URL입니다.
website_uri	string 이 장소의 신뢰할 수 있는 웹사이트(예: 비즈니스 홈페이지)입니다. 체인에 속한 장소 (예: IKEA 매장)의 경우 일반적으로 전체 체인이 아닌 개별 매장의 웹사이트가 표시됩니다.
reviews[]	Review 이 장소에 관한 리뷰 목록입니다. 관련성순으로 정렬됩니다. 최대 5개의 리뷰가 반환될 수 있습니다.
regular_opening_hours	OpeningHours 정규 영업시간입니다. 장소가 항상 열려 있는 경우 (24시간) close 필드가 설정되지 않습니다. 클라이언트는 항상 열려 있음 (24시간)이 값이 0인 day, 값이 0인 hour, 값이 0인 minute를 포함하는 open 기간으로 표시된다고 가정할 수 있습니다.
time_zone	TimeZone IANA 시간대 데이터베이스 시간대입니다. 예를 들면 "America/New_York"입니다.
photos[]	Photo 이 장소의 사진에 관한 정보 (참조 포함)입니다. 최대 10장의 사진이 반환될 수 있습니다.
adr_format_address	string adr 마이크로 형식의 장소 주소입니다(http://microformats.org/wiki/adr).
business_status	BusinessStatus 장소의 비즈니스 상태입니다.
price_level	PriceLevel 장소의 가격대입니다.
attributions[]	Attribution 이 결과와 함께 표시되어야 하는 데이터 제공자 집합입니다.
icon_mask_base_uri	string 아이콘 마스크의 잘린 URL입니다. 사용자는 유형 접미사('.svg' 또는 '.png' 등)를 끝에 추가하여 다양한 아이콘 유형에 액세스할 수 있습니다.
icon_background_color	string icon_mask의 배경색입니다(16진수 형식, 예: #909CE1).
current_opening_hours	OpeningHours 다음 7일간 (오늘 포함)의 영업시간입니다. 기간은 요청일의 자정에 시작하여 6일 후 오후 11시 59분에 종료됩니다. 이 필드에는 예외적인 영업시간이 있는 날짜에 설정된 모든 영업시간의 special_days 하위 필드가 포함됩니다.
current_secondary_opening_hours[]	OpeningHours 비즈니스의 보조 영업시간에 관한 정보를 비롯해 향후 7일간의 항목 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점은 드라이브 스루 영업시간이나 배달 시간을 보조 영업시간으로 지정할 수 있습니다. 이 필드는 장소 유형에 따라 미리 정의된 영업시간 유형 목록 (예: DRIVE_THROUGH, PICKUP, TAKEOUT)에서 가져온 유형 하위 필드를 채웁니다. 이 필드에는 예외적인 영업시간이 있는 날짜에 설정된 모든 영업시간의 special_days 하위 필드가 포함됩니다.
regular_secondary_opening_hours[]	OpeningHours 비즈니스의 정규 보조 영업시간에 관한 정보의 항목 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점은 드라이브 스루 영업시간이나 배달 시간을 보조 영업시간으로 지정할 수 있습니다. 이 필드는 장소 유형에 따라 미리 정의된 영업시간 유형 목록 (예: DRIVE_THROUGH, PICKUP, TAKEOUT)에서 가져온 유형 하위 필드를 채웁니다.
editorial_summary	LocalizedText 장소의 요약을 포함합니다. 요약은 텍스트 개요로 구성되며, 해당하는 경우 언어 코드도 포함됩니다. 요약 텍스트는 있는 그대로 표시해야 하며 수정하거나 변경할 수 없습니다.
payment_options	PaymentOptions 장소에서 허용하는 결제 옵션입니다. 결제 옵션 데이터를 사용할 수 없는 경우 결제 옵션 필드가 설정되지 않습니다.
parking_options	ParkingOptions 장소에서 제공하는 주차 옵션입니다.
sub_destinations[]	SubDestination 장소와 관련된 하위 대상 목록입니다.
fuel_options	FuelOptions 주유소의 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다.
ev_charge_options	EVChargeOptions 전기 자동차 충전 옵션에 관한 정보입니다.
generative_summary	GenerativeSummary 장소에 대한 AI 생성 요약입니다.
containing_places[]	ContainingPlace 현재 장소가 있는 장소 목록입니다.
address_descriptor	AddressDescriptor 장소의 주소 설명자입니다. 주소 설명어에는 명소와 지역을 사용하여 위치를 설명하는 데 도움이 되는 추가 정보가 포함됩니다. https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage에서 주소 설명자 지역별 지원 범위를 확인하세요.
google_maps_links	GoogleMapsLinks 다양한 Google 지도 작업을 트리거하는 링크
price_range	PriceRange 장소와 관련된 가격대입니다.
review_summary	ReviewSummary 사용자 리뷰를 사용하여 AI가 생성한 장소 요약입니다.
ev_charge_amenity_summary	EvChargeAmenitySummary 전기자동차 충전소 주변 편의시설의 요약입니다.
neighborhood_summary	NeighborhoodSummary 장소 근처의 관심 장소 요약입니다.
consumer_alert	ConsumerAlert 비즈니스에서 의심스러운 리뷰 활동이 감지되거나 비즈니스가 Google 정책을 위반하는 경우 장소에 표시되는 소비자 알림 메시지입니다.
utc_offset_minutes	int32 이 장소의 시간대가 현재 UTC에서 오프셋된 시간(분)입니다. 시간의 일부로 오프셋되는 표준 시간대(예: X시간 15분)를 지원하기 위해 분 단위로 표현됩니다.
user_rating_count	int32 이 장소에 대한 총 리뷰 수 (텍스트 유무와 관계없음)입니다.
takeout	bool 비즈니스에서 테이크아웃을 지원하는지 여부를 지정합니다.
delivery	bool 비즈니스에서 배송을 지원하는지 여부를 지정합니다.
dine_in	bool 비즈니스에서 실내 또는 야외 좌석 옵션을 지원하는지 여부를 지정합니다.
curbside_pickup	bool 비즈니스에서 차량 수령을 지원하는지 여부를 지정합니다.
reservable	bool 장소에서 예약을 지원하는지 여부를 지정합니다.
serves_breakfast	bool 장소에서 아침 식사를 제공하는지 여부를 지정합니다.
serves_lunch	bool 장소에서 점심을 제공하는지 여부를 지정합니다.
serves_dinner	bool 장소에서 저녁 식사를 제공하는지 여부를 지정합니다.
serves_beer	bool 장소에서 맥주를 판매하는지 여부를 지정합니다.
serves_wine	bool 장소에서 와인을 판매하는지 여부를 지정합니다.
serves_brunch	bool 장소에서 브런치를 제공하는지 여부를 지정합니다.
serves_vegetarian_food	bool 장소에서 채식 요리를 제공하는지 여부를 지정합니다.
outdoor_seating	bool 야외 좌석이 마련되어 있습니다.
live_music	bool 라이브 음악을 제공하는 장소입니다.
menu_for_children	bool 어린이 메뉴가 있습니다.
serves_cocktails	bool 칵테일을 제공하는 장소입니다.
serves_dessert	bool 디저트를 제공하는 곳입니다.
serves_coffee	bool 커피를 제공하는 장소입니다.
good_for_children	bool 어린이에게 적합한 장소입니다.
allows_dogs	bool 반려견 동반이 가능한 장소입니다.
restroom	bool 화장실이 있는 장소입니다.
good_for_groups	bool 단체 숙박 가능 여부
good_for_watching_sports	bool 스포츠 경기를 관람하기에 적합한 장소입니다.
accessibility_options	AccessibilityOptions 장소에서 제공하는 접근성 옵션에 관한 정보입니다.
pure_service_area_business	bool 장소가 순수 방문 서비스 업체인지 여부를 나타냅니다. 순수 방문 서비스 업체는 고객에게 방문 또는 배달 서비스를 제공하지만 비즈니스 주소지에서는 고객에게 서비스를 제공하지 않는 비즈니스입니다. 청소 서비스 또는 배관공 등의 비즈니스가 있습니다. 이러한 비즈니스에는 Google 지도에 실제 주소나 위치가 없을 수 있습니다.

AccessibilityOptions

장소에서 제공하는 접근성 옵션에 관한 정보입니다.

필드
wheelchair_accessible_parking	bool 휠체어 이용 가능 주차장을 제공하는 장소입니다.
wheelchair_accessible_entrance	bool 장소에 휠체어 진입로가 있습니다.
wheelchair_accessible_restroom	bool 장소에 휠체어 이용 가능 화장실이 있습니다.
wheelchair_accessible_seating	bool 휠체어 이용 가능 좌석이 있는 장소입니다.

AddressComponent

이 정보가 제공되는 경우 서식이 지정된 주소를 구성하는 구조화된 구성요소입니다.

필드
long_text	string 주소 구성요소의 전체 텍스트 설명 또는 이름입니다. 예를 들어 오스트레일리아 국가의 주소 구성요소에는 long_name이 'Australia'일 수 있습니다.
short_text	string 주소 구성요소의 축약된 텍스트 이름입니다(해당하는 경우). 예를 들어 오스트레일리아 국가의 주소 구성요소에는 short_name이 'AU'일 수 있습니다.
types[]	string 주소 구성요소의 유형을 나타내는 배열입니다.
language_code	string 이 구성요소의 형식을 지정하는 데 사용되는 언어입니다(CLDR 표기법).

기여 분석

이 장소의 데이터 제공업체에 관한 정보입니다.

필드
provider	string 장소의 데이터 제공업체 이름입니다.
provider_uri	string 장소의 데이터 제공업체에 대한 URI입니다.

BusinessStatus

장소의 비즈니스 상태입니다.

열거형
BUSINESS_STATUS_UNSPECIFIED	기본값 이 값은 사용되지 않습니다.
OPERATIONAL	이 시설은 운영 중이지만 현재 영업 중이 아닐 수도 있습니다.
CLOSED_TEMPORARILY	이 시설은 임시 휴업 중입니다.
CLOSED_PERMANENTLY	이 시설은 폐업했습니다.

ConsumerAlert

비즈니스에서 의심스러운 리뷰 활동이 감지되거나 비즈니스가 Google 정책을 위반하는 경우 장소에 표시되는 소비자 알림 메시지입니다.

필드
overview	string 소비자 알림 메시지의 개요입니다.
details	Details 소비자 알림 메시지의 세부정보입니다.ƒ
language_code	string 소비자 알림 메시지의 언어 코드입니다. BCP 47 언어 코드입니다.

세부정보

소비자 알림 메시지의 세부정보입니다.

필드
title	string 설명과 함께 표시할 제목입니다.
description	string 소비자 알림 메시지에 대한 설명입니다.
about_link	Link 자세한 정보를 제공하기 위해 설명과 함께 표시할 링크입니다.

링크

자세한 정보를 제공하기 위해 설명과 함께 표시할 링크입니다.

필드
title	string 링크에 표시할 제목입니다.
uri	string 링크의 URI입니다.

ContainingPlace

이 장소가 위치한 장소에 관한 정보입니다.

필드
name	string 이 장소가 위치한 장소의 리소스 이름입니다.
id	string 이 장소가 위치한 장소의 장소 ID입니다.

EvChargeAmenitySummary

전기자동차 충전소 주변 편의시설의 요약입니다. electric_vehicle_charging_station 유형의 장소에만 적용됩니다. overview 필드는 제공되지만 다른 필드는 선택사항입니다.

필드
overview	ContentBlock 이용 가능한 편의시설의 개요입니다. 이 값은 항상 제공됩니다.
coffee	ContentBlock 근처 카페 옵션의 요약
restaurant	ContentBlock 근처 음식점의 요약입니다.
store	ContentBlock 근처 매장의 요약입니다.
flag_content_uri	string 사용자가 요약의 문제를 신고할 수 있는 링크
disclosure_text	LocalizedText AI 공개 메시지 'Gemini로 요약됨' (및 현지화된 변형) 사용 가능한 경우 요청에 지정된 언어로 표시됩니다.

GenerativeSummary

장소에 대한 AI 생성 요약입니다.

필드
overview	LocalizedText 장소의 개요입니다.
overview_flag_content_uri	string 사용자가 개요 요약의 문제를 신고할 수 있는 링크
disclosure_text	LocalizedText AI 공개 메시지 'Gemini로 요약됨' (및 현지화된 변형) 사용 가능한 경우 요청에 지정된 언어로 표시됩니다.

GoogleMapsLinks

다양한 Google 지도 작업을 트리거하는 링크

필드
directions_uri	string 장소로 가는 길을 표시하는 링크입니다. 이 링크는 대상 위치만 채우고 기본 이동 모드 DRIVE를 사용합니다.
place_uri	string 이 장소를 표시하는 링크입니다.
write_a_review_uri	string Google 지도에서 이 장소에 대한 리뷰를 작성할 수 있는 링크입니다.
reviews_uri	string Google 지도에서 이 장소의 리뷰를 표시하는 링크입니다.
photos_uri	string Google 지도에서 이 장소의 리뷰를 표시하는 링크입니다.

NeighborhoodSummary

장소 근처의 관심 장소 요약입니다.

필드
overview	ContentBlock 동네의 개요 요약입니다.
description	ContentBlock 인근 지역에 대한 자세한 설명입니다.
flag_content_uri	string 사용자가 요약의 문제를 신고할 수 있는 링크
disclosure_text	LocalizedText AI 공개 메시지 'Gemini로 요약됨' (및 현지화된 변형) 사용 가능한 경우 요청에 지정된 언어로 표시됩니다.

OpeningHours

장소의 영업시간에 관한 정보입니다.

필드
periods[]	Period 이 장소가 주중에 영업하는 기간입니다. 기간은 장소의 현지 시간대를 기준으로 시간순으로 표시됩니다. 비어 있지만 누락되지 않은 값은 리모델링으로 인해 일시적으로 폐쇄되는 등 절대 열리지 않는 장소를 나타냅니다. periods의 시작일은 고정되어 있지 않으며 일요일이라고 가정해서는 안 됩니다. API는 다양한 요인을 기반으로 시작일을 결정합니다. 예를 들어 24시간 연중무휴 비즈니스의 경우 첫 번째 기간이 요청 당일에 시작될 수 있습니다. 다른 비즈니스의 경우 영업하는 첫 번째 요일일 수 있습니다. 참고: periods 배열의 순서는 weekday_descriptions 배열의 순서와 무관합니다. 두 캠페인이 같은 날에 시작된다고 가정하지 마세요.
weekday_descriptions[]	string 이 장소의 영업시간을 설명하는 현지화된 문자열입니다. 요일별로 하나의 문자열이 있습니다. 참고: 요일 순서와 한 주의 시작은 언어 및 지역에 따라 결정됩니다. periods 배열의 순서는 weekday_descriptions 배열의 순서와 무관합니다. 두 캠페인이 같은 날에 시작된다고 가정하지 마세요. 시간을 알 수 없거나 현지화된 텍스트로 변환할 수 없는 경우 비어 있습니다. 예: '일: 18:00~06:00'
secondary_hours_type	SecondaryHoursType 보조 시간의 유형을 식별하는 데 사용되는 유형 문자열입니다.
special_days[]	SpecialDay 반환된 영업시간에 포함되는 특별한 날짜에 관한 구조화된 정보입니다. 특별한 날은 장소의 영업시간에 영향을 미칠 수 있는 날입니다(예: 크리스마스). 예외적인 시간이 있는 경우 current_opening_hours 및 current_secondary_opening_hours에 설정합니다.
next_open_time	Timestamp 현재 영업시간 기간이 시작되는 다음 시간(최대 7일 후) 이 필드는 요청이 처리되는 시점에 영업시간 기간이 활성 상태가 아닌 경우에만 채워집니다.
next_close_time	Timestamp 현재 영업시간 기간이 최대 7일 후에 종료되는 다음 시간입니다. 이 필드는 요청이 처리되는 시점에 영업시간 기간이 활성 상태인 경우에만 채워집니다.
open_now	bool 영업시간 기간이 현재 활성 상태인지 여부입니다. 정규 영업시간과 현재 영업시간의 경우 이 필드는 장소가 영업 중인지 여부를 의미합니다. 보조 영업시간 및 현재 보조 영업시간의 경우 이 필드는 이 장소의 보조 영업시간이 활성 상태인지 여부를 의미합니다.

기간

장소가 open_now 상태로 유지되는 기간입니다.

필드
open	Point 장소가 영업을 시작하는 시간입니다.
close	Point 장소가 폐쇄되기 시작하는 시간입니다.

점

상태 변경 지점

필드
date	Date 장소의 현지 시간대 날짜입니다.
truncated	bool 이 엔드포인트가 잘렸는지 여부입니다. 실제 시간이 Google에서 반환하려는 시간 범위를 벗어나면 잘림이 발생하므로 시간을 이러한 경계로 다시 자릅니다. 이렇게 하면 요청 당일 자정부터 최대 24 * 7시간이 반환됩니다.
day	int32 요일(0~6 범위의 정수)입니다. 0은 일요일, 1은 월요일 등입니다.
hour	int32 24시간 형식의 시간입니다. 범위는 0~23입니다.
minute	int32 분 범위는 0~59입니다.

SecondaryHoursType

보조 시간의 유형을 식별하는 데 사용되는 유형입니다.

열거형
SECONDARY_HOURS_TYPE_UNSPECIFIED	보조 시간 유형이 지정되지 않은 경우의 기본값입니다.
DRIVE_THROUGH	은행, 음식점 또는 약국의 드라이브 스루 영업시간입니다.
HAPPY_HOUR	해피아워
DELIVERY	배송 시간입니다.
TAKEOUT	테이크아웃 시간입니다.
KITCHEN	주방 영업시간입니다.
BREAKFAST	아침 시간입니다.
LUNCH	점심시간
DINNER	저녁 식사 시간입니다.
BRUNCH	브런치 시간
PICKUP	수령 시간입니다.
ACCESS	보관 장소의 액세스 시간입니다.
SENIOR_HOURS	노인을 위한 특별 영업시간입니다.
ONLINE_SERVICE_HOURS	온라인 서비스 시간입니다.

SpecialDay

반환된 영업시간에 포함되는 특별한 날짜에 관한 구조화된 정보입니다. 특별한 날은 장소의 영업시간에 영향을 미칠 수 있는 날입니다(예: 크리스마스).

필드
date	Date 이 특별한 날의 날짜입니다.

ParkingOptions

장소의 주차 옵션에 관한 정보입니다. 주차장에서 동시에 두 개 이상의 옵션을 지원할 수 있습니다.

필드
free_parking_lot	bool 무료 주차장이 있습니다.
paid_parking_lot	bool 유료 주차장을 제공하는 장소입니다.
free_street_parking	bool 무료 노상 주차장이 있습니다.
paid_street_parking	bool 유료 노상 주차장이 있습니다.
valet_parking	bool 발레파킹 서비스를 제공하는 장소입니다.
free_garage_parking	bool 주차장을 무료로 이용할 수 있습니다.
paid_garage_parking	bool 유료 차고 주차장이 있습니다.

PaymentOptions

장소에서 허용하는 결제 옵션입니다.

필드
accepts_credit_cards	bool 신용카드로 결제가 가능한 장소입니다.
accepts_debit_cards	bool 체크카드로 결제가 가능한 장소입니다.
accepts_cash_only	bool 현금만 결제 수단으로 허용됩니다. 이 속성이 있는 장소에서도 다른 결제 수단을 허용할 수 있습니다.
accepts_nfc	bool NFC 결제가 가능한 장소입니다.

PlusCode

Plus Code (http://plus.codes)는 14mx14m (1/8000도) 이하의 직사각형을 정의하는 글로벌 코드와 접두사를 참조 위치로 대체하는 복합 코드의 두 가지 형식이 있는 위치 참조입니다.

필드
global_code	string 1/8000x1/8000도 영역(~14x14미터)을 나타내는 장소의 전역(전체) 코드입니다(예: '9FWM33GV+HQ').
compound_code	string 글로벌 코드의 접미사를 포함하고 접두사를 형식화된 참조 항목 이름으로 대체하는 장소의 복합 코드입니다(예: '33GV+HQ, Ramberg, Norway').

ReviewSummary

사용자 리뷰를 사용하여 AI가 생성한 장소 요약입니다.

필드
text	LocalizedText 사용자 리뷰 요약입니다.
flag_content_uri	string 사용자가 요약의 문제를 신고할 수 있는 링크
disclosure_text	LocalizedText AI 공개 메시지 'Gemini로 요약됨' (및 현지화된 변형) 사용 가능한 경우 요청에 지정된 언어로 표시됩니다.
reviews_uri	string Google 지도에서 이 장소의 리뷰를 표시하는 링크입니다.

SubDestination

하위 목적지는 기본 장소와 연결된 구체적인 장소입니다. 이러한 정보는 공항, 국립공원, 대학교, 경기장과 같이 크거나 복잡한 장소 내에서 검색하는 사용자에게 더 구체적인 목적지를 제공합니다. 예를 들어 공항의 하위 목적지에는 관련 터미널과 주차장이 포함될 수 있습니다. 하위 목적지는 장소 ID와 장소 리소스 이름을 반환하며, 이는 후속 장소 세부정보 (신규) 요청에서 하위 목적지의 표시 이름과 위치를 비롯한 더 풍부한 세부정보를 가져오는 데 사용할 수 있습니다.

필드
name	string 하위 도착 페이지의 리소스 이름입니다.
id	string 하위 목적지의 장소 ID입니다.

폴리라인

경로 폴리라인입니다. 인코딩된 다중선만 지원하며, 이는 문자열로 전달될 수 있고 손실이 최소화된 압축을 포함합니다. 이는 Routes API 기본 출력입니다.

필드
통합 필드 polyline_type. 폴리라인의 유형을 캡슐화합니다. Routes API 출력은 기본적으로 encoded_polyline입니다. polyline_type은 다음 중 하나일 수 있습니다.
encoded_polyline	string Routes API에서 기본적으로 반환되는 인코딩된 폴리라인입니다. 인코더 및 디코더 도구를 참고하세요.

PriceLevel

장소의 가격대입니다.

열거형
PRICE_LEVEL_UNSPECIFIED	장소 가격대가 지정되지 않았거나 알 수 없습니다.
PRICE_LEVEL_FREE	무료 서비스를 제공하는 장소입니다.
PRICE_LEVEL_INEXPENSIVE	저렴한 서비스를 제공하는 장소입니다.
PRICE_LEVEL_MODERATE	이 장소는 적당한 가격의 서비스를 제공합니다.
PRICE_LEVEL_EXPENSIVE	비싼 서비스를 제공하는 장소입니다.
PRICE_LEVEL_VERY_EXPENSIVE	장소에서 매우 비싼 서비스를 제공합니다.

PriceRange

장소와 관련된 가격대입니다. end_price는 설정되지 않을 수 있으며, 이는 상한이 없는 범위를 나타냅니다 (예: '100달러 이상').

필드
start_price	Money 가격 범위의 하한 (포함)입니다. 가격은 이 금액 이상이어야 합니다.
end_price	Money 가격대의 상한 (해당 값 제외)입니다. 가격이 이 금액보다 낮아야 합니다.

검토

장소 리뷰에 관한 정보입니다.

필드
name	string 이 장소 리뷰를 나타내는 참조로, 이 장소 리뷰를 다시 조회하는 데 사용할 수 있습니다 (API '리소스' 이름: places/{place_id}/reviews/{review}).
relative_publish_time_description	string 최근 시간을 형식화한 문자열로, 언어와 국가에 적합한 형식으로 현재 시간에 대한 리뷰 시간을 표현합니다.
text	LocalizedText 리뷰의 현지화된 텍스트입니다.
original_text	LocalizedText 원래 언어로 된 리뷰 텍스트입니다.
rating	double 1.0~5.0 사이의 숫자입니다. 별 개수라고도 합니다.
author_attribution	AuthorAttribution 이 리뷰의 작성자입니다.
publish_time	Timestamp 리뷰의 타임스탬프입니다.
flag_content_uri	string 사용자가 리뷰 문제를 신고할 수 있는 링크
google_maps_uri	string Google 지도에 리뷰를 표시하는 링크입니다.
visit_date	Date 작성자가 장소를 방문한 날짜입니다. 월로 잘립니다.

RouteModifiers

경로를 계산할 때 충족해야 하는 선택적 조건 집합을 캡슐화합니다.

필드
avoid_tolls	bool 선택사항입니다. true로 설정하면 합리적인 경우 유료 도로를 피하고 유료 도로가 포함되지 않은 경로를 우선합니다. DRIVE 및 TWO_WHEELER TravelMode에만 적용됩니다.
avoid_highways	bool 선택사항입니다. true로 설정하면 합리적인 경우 고속도로를 피하고 고속도로가 포함되지 않은 경로를 우선합니다. DRIVE 및 TWO_WHEELER TravelMode에만 적용됩니다.
avoid_ferries	bool 선택사항입니다. true로 설정하면 합리적인 경우 페리를 피하고 페리가 포함되지 않은 경로를 우선합니다. DRIVE 및 TWO_WHEELER TravelMode에만 적용됩니다.
avoid_indoor	bool 선택사항입니다. true로 설정하면 실내 내비게이션이 포함되지 않은 경로를 우선하여 적절한 경우 실내 탐색을 피합니다. WALK TravelMode에만 적용됩니다.

RoutingParameters

경로를 따라 (결과 순위에 영향을 미침) 응답의 장소로의 라우팅 계산을 구성하고 결과의 이동 시간을 계산하는 파라미터입니다.

필드
origin	LatLng 선택사항입니다. 다중선에 정의된 원점을 재정의하는 명시적 라우팅 원점입니다. 기본적으로 폴리라인 원점이 사용됩니다.
travel_mode	TravelMode 선택사항입니다. 이동 수단입니다.
route_modifiers	RouteModifiers 선택사항입니다. 경로 수정자입니다.
routing_preference	RoutingPreference 선택사항입니다. 라우팅 요약을 계산하는 방법을 지정합니다. 서버는 선택한 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 트래픽 인식 라우팅 환경설정은 DRIVE 또는 TWO_WHEELER travelMode에만 사용할 수 있습니다.

RoutingPreference

경로를 계산할 때 고려해야 하는 요소를 지정하는 값의 집합입니다.

열거형
ROUTING_PREFERENCE_UNSPECIFIED	지정된 라우팅 환경설정이 없습니다. 기본값은 TRAFFIC_UNAWARE입니다.
TRAFFIC_UNAWARE	실시간 교통 상황을 고려하지 않고 경로를 계산합니다. 교통상황이 중요하지 않거나 적용되지 않는 경우에 적합합니다. 이 값을 사용하면 지연 시간이 가장 짧습니다. 참고: TravelMode, DRIVE, TWO_WHEELER의 경우 현재 도로 상황이 아닌 도로망 및 평균 시간과 무관한 교통상황을 기반으로 경로 및 소요 시간이 선택됩니다. 따라서 경로에는 일시적으로 폐쇄된 도로가 포함될 수 있습니다. 지정된 요청의 결과는 도로망의 변화, 평균 교통상황의 업데이트 및 분산된 서비스 특성으로 인해 시간이 지남에 따라 달라질 수도 있습니다. 거의 동일한 경로 간에도 언제든지 또는 수시로 결과가 다를 수도 있습니다.
TRAFFIC_AWARE	실시간 교통상황을 고려하여 경로를 계산합니다. TRAFFIC_AWARE_OPTIMAL와 달리 일부 최적화는 지연 시간을 크게 줄이기 위해 적용됩니다.
TRAFFIC_AWARE_OPTIMAL	대부분의 성능 최적화를 적용하지 않고 실시간 교통 상황을 고려하여 경로를 계산합니다. 이 값을 사용하면 지연 시간이 가장 길어집니다.

RoutingSummary

요청된 경우 라우팅 출발지에서 응답의 장소까지의 거리와 시간, 해당 장소에서 목적지까지의 두 번째 구간입니다. 참고: 요청에 routingParameters.origin 매개변수 또는 searchAlongRouteParameters.polyline.encodedPolyline 매개변수를 포함하지 않고 필드 마스크에 routingSummaries를 추가하면 오류가 발생합니다.

필드
legs[]	Leg 여행 구간입니다. 설정된 출발지에서 이동 시간과 거리를 계산하면 legs에 출발지에서 목적지까지의 시간과 거리가 포함된 단일 구간이 포함됩니다. 경로를 따라 검색하면 legs에 두 구간이 포함됩니다. 하나는 출발지에서 장소까지이고 다른 하나는 장소에서 목적지까지입니다.
directions_uri	string 지정된 경로 요약의 경유지를 사용하여 Google 지도에 경로를 표시하는 링크입니다. 이 링크로 생성된 경로가 라우팅 요약을 생성하는 데 사용된 경로와 동일하지 않을 수 있습니다. 이 링크는 요청에 제공된 정보를 사용하여 길찾기 링크를 생성합니다. 여기에는 해당하는 경우 routingParameters 및 searchAlongRouteParameters 필드가 포함됩니다.

다리

구간은 한 위치에서 다른 위치로 이동하는 여정의 단일 부분입니다.

필드
duration	Duration 이 여정 구간을 완료하는 데 걸리는 시간입니다.
distance_meters	int32 이 여행 구간의 거리입니다.

SearchNearbyRequest

주변 검색 요청 프로토입니다.

필드
language_code	string 사용 가능한 경우 기본 언어로 장소 세부정보가 표시됩니다. 언어 코드가 지정되지 않았거나 인식되지 않는 경우 언어 세부정보가 반환될 수 있으며, 이러한 세부정보가 있는 경우 영어로 반환됩니다. 현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport
region_code	string 요청이 전송된 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 사용 가능한 경우 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칠 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참고하세요. 현재 3자리 지역 코드는 지원되지 않습니다.
included_types[]	string https://developers.google.com/maps/documentation/places/web-service/place-types의 포함된 장소 유형 (예: 'restaurant' 또는 'gas_station')입니다. 표 A에서 최대 50개의 유형을 지정할 수 있습니다. 충돌하는 유형(예: 포함된 유형과 제외된 유형 모두에 유형이 표시됨)이 있으면 INVALID_ARGUMENT 오류가 반환됩니다. 여러 유형 제한사항과 함께 장소 유형이 지정되면 모든 제한사항을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}가 있는 경우 반환된 장소는 '레스토랑' 관련 서비스를 제공하지만 주로 '레스토랑'으로 운영되지는 않습니다.
excluded_types[]	string https://developers.google.com/maps/documentation/places/web-service/place-types에서 제외된 장소 유형 (예: 'restaurant' 또는 'gas_station')입니다. 표 A에서 최대 50개의 유형을 지정할 수 있습니다. 클라이언트가 포함된 유형 (예: 레스토랑)과 제외된 유형 (예: 카페)을 모두 제공하는 경우 응답에는 레스토랑이지만 카페는 아닌 장소가 포함되어야 합니다. 응답에는 포함된 유형 중 하나 이상과 일치하고 제외된 유형과 일치하지 않는 장소가 포함됩니다. 충돌하는 유형(예: 포함된 유형과 제외된 유형 모두에 유형이 표시됨)이 있으면 INVALID_ARGUMENT 오류가 반환됩니다. 여러 유형 제한사항과 함께 장소 유형이 지정되면 모든 제한사항을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}가 있는 경우 반환된 장소는 '레스토랑' 관련 서비스를 제공하지만 주로 '레스토랑'으로 운영되지는 않습니다.
included_primary_types[]	string https://developers.google.com/maps/documentation/places/web-service/place-types의 기본 장소 유형 (예: 'restaurant' 또는 'gas_station')이 포함됩니다. 장소에는 지원되는 유형 표의 기본 유형 하나만 연결할 수 있습니다. 표 A에서 최대 50개의 유형을 지정할 수 있습니다. 충돌하는 기본 유형(예: 포함된 기본 유형과 제외된 기본 유형 모두에 유형이 표시됨)이 있으면 INVALID_ARGUMENT 오류가 반환됩니다. 여러 유형 제한사항과 함께 장소 유형이 지정되면 모든 제한사항을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}가 있는 경우 반환된 장소는 '레스토랑' 관련 서비스를 제공하지만 주로 '레스토랑'으로 운영되지는 않습니다.
excluded_primary_types[]	string https://developers.google.com/maps/documentation/places/web-service/place-types에서 제외된 기본 장소 유형 (예: 'restaurant' 또는 'gas_station')입니다. 표 A에서 최대 50개의 유형을 지정할 수 있습니다. 충돌하는 기본 유형(예: 포함된 기본 유형과 제외된 기본 유형 모두에 유형이 표시됨)이 있으면 INVALID_ARGUMENT 오류가 반환됩니다. 여러 유형 제한사항과 함께 장소 유형이 지정되면 모든 제한사항을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}가 있는 경우 반환된 장소는 '레스토랑' 관련 서비스를 제공하지만 주로 '레스토랑'으로 운영되지는 않습니다.
max_result_count	int32 반환할 결과의 최대 수입니다. 1~20 (기본값) 사이여야 합니다. 숫자가 설정되지 않은 경우 상한으로 대체됩니다. 숫자가 음수로 설정되거나 상한을 초과하면 INVALID_ARGUMENT 오류가 반환됩니다.
location_restriction	LocationRestriction 필수 항목입니다. 검색할 지역입니다.
rank_preference	RankPreference 대답에서 결과의 순위가 지정되는 방식입니다.
routing_parameters	RoutingParameters 선택사항입니다. 검색 결과로의 라우팅에 영향을 미치는 매개변수입니다.

LocationRestriction

검색할 지역입니다.

필드
통합 필드 type. type는 다음 중 하나여야 합니다.
circle	Circle 중심점과 반지름으로 정의된 원입니다.

RankPreference

대답에서 결과의 순위가 지정되는 방식입니다.

열거형
RANK_PREFERENCE_UNSPECIFIED	RankPreference 값이 설정되지 않았습니다. 기본적으로 인기순으로 순위를 지정합니다.
DISTANCE	거리에 따라 결과를 순위 지정합니다.
POPULARITY	인기도를 기준으로 결과를 순위 지정합니다.

SearchNearbyResponse

주변 검색의 응답 프로토콜입니다.

필드
places[]	Place 장소 유형, 장소 수, 특정 위치 제한과 같은 사용자 요구사항을 충족하는 장소 목록입니다.
routing_summaries[]	RoutingSummary 각 항목이 places 필드의 동일한 색인에 있는 해당 장소와 연결되는 라우팅 요약 목록입니다. 장소 중 하나에 대한 경로 요약을 사용할 수 없는 경우 빈 항목이 포함됩니다. 이 목록에는 요청된 경우 장소 목록만큼 많은 항목이 있어야 합니다.

SearchTextRequest

SearchText의 요청 프로토콜입니다.

필드
text_query	string 필수 항목입니다. 텍스트 검색을 위한 텍스트 쿼리입니다.
language_code	string 사용 가능한 경우 기본 언어로 장소 세부정보가 표시됩니다. 언어 코드가 지정되지 않았거나 인식되지 않는 경우 언어 세부정보가 반환될 수 있으며, 이러한 세부정보가 있는 경우 영어로 반환됩니다. 현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport
region_code	string 요청이 전송된 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 사용 가능한 경우 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다. 이 매개변수는 관련 법규에 따라 결과에 영향을 미칠 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참고하세요. 현재 3자리 지역 코드는 지원되지 않습니다.
rank_preference	RankPreference 대답에서 결과의 순위가 지정되는 방식입니다.
included_type	string 요청된 장소 유형입니다. 지원되는 유형의 전체 목록: https://developers.google.com/maps/documentation/places/web-service/place-types 포함된 유형은 하나만 지원됩니다.
open_now	bool 현재 영업 중인 장소로 검색을 제한하는 데 사용됩니다. 기본값은 false입니다.
min_rating	double 평균 사용자 평가가 이 한도보다 엄격하게 낮은 결과를 필터링합니다. 유효한 값은 0.5 간격으로 0~5(포함) 사이의 부동 소수점이어야 합니다(예: [0, 0.5, 1.0, ... , 5.0] 포함). 입력된 평점은 가장 가까운 0.5(올림)로 반올림됩니다. 예를 들어 등급이 0.6이면 등급이 1.0 미만인 결과가 모두 삭제됩니다.
max_result_count (deprecated)	int32 이 항목은 지원 중단되었습니다. 지원 중단됨: 대신 page_size을 사용하세요. 페이지당 반환할 수 있는 최대 결과 수입니다. 사용 가능한 결과 수가 max_result_count보다 크면 page_token에 전달하여 후속 요청에서 결과의 다음 페이지를 가져올 수 있는 next_page_token이 반환됩니다. 0 또는 값이 제공되지 않으면 기본값 20이 사용됩니다. 최댓값은 20이며, 20을 초과하는 값은 20으로 변환됩니다. 음수 값은 INVALID_ARGUMENT 오류를 반환합니다. max_result_count과 page_size이 모두 지정된 경우 max_result_count이 무시됩니다.
page_size	int32 선택사항입니다. 페이지당 반환할 수 있는 최대 결과 수입니다. 사용 가능한 결과 수가 page_size보다 크면 page_token에 전달하여 후속 요청에서 결과의 다음 페이지를 가져올 수 있는 next_page_token이 반환됩니다. 0 또는 값이 제공되지 않으면 기본값 20이 사용됩니다. 최댓값은 20이며, 20을 초과하는 값은 20으로 설정됩니다. 음수 값은 INVALID_ARGUMENT 오류를 반환합니다. max_result_count과 page_size이 모두 지정된 경우 max_result_count이 무시됩니다.
page_token	string 선택사항입니다. 이전 TextSearch 호출에서 수신한 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우 TextSearch에 제공된 page_token, page_size, max_result_count 이외의 모든 매개변수는 페이지 토큰을 제공한 초기 호출과 일치해야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
price_levels[]	PriceLevel 검색을 특정 가격대로 표시된 장소로 제한하는 데 사용됩니다. 사용자는 가격 등급을 원하는 대로 조합할 수 있습니다. 기본적으로 모든 가격 수준이 선택됩니다.
strict_type_filtering	bool 포함된 유형에 대해 엄격한 유형 필터링을 설정하는 데 사용됩니다. true로 설정하면 동일한 유형의 결과만 반환됩니다. 기본값은 false입니다.
location_bias	LocationBias 검색할 지역입니다. 이 위치는 편향으로 작용하므로 지정된 위치 주변의 결과가 반환될 수 있습니다. location_restriction과 함께 설정할 수 없습니다.
location_restriction	LocationRestriction 검색할 지역입니다. 이 위치는 제한으로 작용하므로 지정된 위치 외부의 결과는 반환되지 않습니다. location_bias와 함께 설정할 수 없습니다.
ev_options	EVOptions 선택사항입니다. 장소 검색 요청의 검색 가능한 EV 옵션을 설정합니다.
routing_parameters	RoutingParameters 선택사항입니다. 결과로 라우팅하기 위한 추가 매개변수입니다.
search_along_route_parameters	SearchAlongRouteParameters 선택사항입니다. 경로를 따라 검색하기 위한 추가 매개변수 프로토콜입니다.
include_pure_service_area_businesses	bool 선택사항입니다. 필드가 true로 설정된 경우 순수 방문 서비스 업체를 포함합니다. 순수 방문 서비스 업체는 고객에게 방문 또는 배달 서비스를 제공하지만 비즈니스 주소지에서는 고객에게 서비스를 제공하지 않는 비즈니스입니다. 청소 서비스 또는 배관공 등의 비즈니스가 있습니다. 이러한 비즈니스에는 Google 지도에 실제 주소나 위치가 없습니다. 장소에서는 이러한 비즈니스에 대해 location, plus_code 및 기타 위치 관련 필드를 반환하지 않습니다.

EVOptions

장소 검색 요청의 검색 가능한 전기 자동차 옵션입니다.

필드
minimum_charging_rate_kw	double 선택사항입니다. 필요한 최소 충전 속도(킬로와트)입니다. 충전 요금이 지정된 요금보다 낮은 장소는 필터링됩니다.
connector_types[]	EVConnectorType 선택사항입니다. 선호하는 EV 커넥터 유형 목록입니다. 나열된 커넥터 유형을 지원하지 않는 장소는 필터링됩니다.

LocationBias

검색할 지역입니다. 이 위치는 편향으로 작용하므로 지정된 위치 주변의 결과가 반환될 수 있습니다.

필드
통합 필드 type. type는 다음 중 하나여야 합니다.
rectangle	Viewport 북동쪽 및 남서쪽 모서리로 정의된 직사각형 상자입니다. rectangle.high()은 직사각형 뷰포트의 북동쪽 지점이어야 합니다. rectangle.low()는 사각형 뷰포트의 남서쪽 지점이어야 합니다. rectangle.low().latitude()은 rectangle.high().latitude()보다 클 수 없습니다. 이렇게 하면 위도 범위가 비게 됩니다. 직사각형 뷰포트는 180도보다 넓을 수 없습니다.
circle	Circle 중심점과 반지름으로 정의된 원입니다.

LocationRestriction

검색할 지역입니다. 이 위치는 제한으로 작용하므로 지정된 위치 외부의 결과는 반환되지 않습니다.

필드
통합 필드 type. type는 다음 중 하나여야 합니다.
rectangle	Viewport 북동쪽 및 남서쪽 모서리로 정의된 직사각형 상자입니다. rectangle.high()은 직사각형 뷰포트의 북동쪽 지점이어야 합니다. rectangle.low()는 사각형 뷰포트의 남서쪽 지점이어야 합니다. rectangle.low().latitude()은 rectangle.high().latitude()보다 클 수 없습니다. 이렇게 하면 위도 범위가 비게 됩니다. 직사각형 뷰포트는 180도보다 넓을 수 없습니다.

RankPreference

대답에서 결과의 순위가 지정되는 방식입니다.

열거형
RANK_PREFERENCE_UNSPECIFIED	'뉴욕시의 레스토랑'과 같은 카테고리 쿼리의 경우 RELEVANCE가 기본값입니다. '캘리포니아 마운틴뷰'와 같은 비카테고리 쿼리의 경우 rankPreference를 설정하지 않은 상태로 두는 것이 좋습니다.
DISTANCE	거리에 따라 결과를 순위 지정합니다.
RELEVANCE	관련성을 기준으로 결과를 순위 지정합니다. 일반 순위 스택에 따라 정렬 순서가 결정됩니다.

SearchAlongRouteParameters

검색할 경로를 정의하는 Routes API의 사전 계산된 폴리라인을 지정합니다. 경로를 따라 검색하는 것은 locationBias 또는 locationRestriction 요청 옵션을 사용하여 검색 결과에 편향을 주는 것과 유사합니다. locationBias 및 locationRestriction 옵션을 사용하면 검색 결과에 편향을 줄 지역을 지정할 수 있지만 이 옵션을 사용하면 여행 경로를 따라 결과에 편향을 줄 수 있습니다.

결과는 제공된 경로를 따라 표시되지 않으며, 폴리라인과 선택적으로 locationBias 또는 locationRestriction에 의해 정의된 검색 영역 내에서 출발지에서 목적지까지의 최소 우회 시간을 기준으로 순위가 지정됩니다. 특히 제공된 폴리라인이 출발지에서 목적지까지의 최적 경로를 정의하지 않는 경우 결과가 대체 경로를 따라 표시될 수 있습니다.

필드
polyline	Polyline 필수 항목입니다. 경로 폴리라인입니다.

SearchTextResponse

SearchText의 응답 프로토콜입니다.

필드
places[]	Place 사용자의 텍스트 검색 기준을 충족하는 장소 목록입니다.
routing_summaries[]	RoutingSummary 각 항목이 places 필드의 동일한 색인에 있는 해당 장소와 연결되는 라우팅 요약 목록입니다. 장소 중 하나에 대한 경로 요약을 사용할 수 없는 경우 빈 항목이 포함됩니다. 이 목록에는 요청된 경우 장소 목록만큼 많은 항목이 있습니다.
contextual_contents[]	ContextualContent 실험 단계: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 각 항목이 장소 필드의 동일한 색인에 있는 해당 장소와 연결되는 맥락 콘텐츠 목록입니다. 요청의 text_query와 관련된 콘텐츠가 선호됩니다. 한 장소에 문맥 콘텐츠가 제공되지 않으면 문맥이 없는 콘텐츠가 반환됩니다. 이 장소에서 콘텐츠를 사용할 수 없는 경우에만 비어 있습니다. 이 목록에는 요청된 경우 장소 목록만큼 많은 항목이 있습니다.
next_page_token	string 다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드가 생략되거나 비어 있으면 후속 페이지가 없습니다.
search_uri	string 링크를 통해 사용자는 요청에 지정된 것과 동일한 텍스트 쿼리로 Google 지도에서 검색할 수 있습니다.

TravelMode

이동 수단 옵션입니다. 이러한 옵션은 Routes API에서 제공하는 기능에 매핑됩니다.

열거형
TRAVEL_MODE_UNSPECIFIED	지정된 이동 수단이 없습니다. 기본값은 DRIVE입니다.
DRIVE	승용차로 이동합니다.
BICYCLE	자전거로 이동합니다. search_along_route_parameters에서는 지원되지 않습니다.
WALK	도보로 이동 search_along_route_parameters에서는 지원되지 않습니다.
TWO_WHEELER	스쿠터, 오토바이 등 모든 종류의 전동 이륜차 이는 인력으로 이동하는 수단을 포함하는 BICYCLE 이동 모드와는 다릅니다. search_along_route_parameters에서는 지원되지 않습니다. 오토바이 경로가 지원되는 국가 및 지역에 나열된 국가에서만 지원됩니다.