색인
Places
(인터페이스)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.AreaSummary
(메시지)Place.Attribution
(메시지)Place.BusinessStatus
(열거형)Place.GenerativeSummary
(메시지)Place.OpeningHours
(메시지)Place.OpeningHours.Period
(메시지)Place.OpeningHours.Period.Point
(메시지)Place.OpeningHours.SecondaryHoursType
(열거형)Place.OpeningHours.SpecialDay
(메시지)Place.ParkingOptions
(메시지)Place.PaymentOptions
(메시지)Place.PlusCode
(메시지)Place.SubDestination
(메시지)PriceLevel
(열거형)References
(메시지)Review
(메시지)SearchNearbyRequest
(메시지)SearchNearbyRequest.LocationRestriction
(메시지)SearchNearbyRequest.RankPreference
(열거형)SearchNearbyResponse
(메시지)SearchTextRequest
(메시지)SearchTextRequest.EVOptions
(메시지)SearchTextRequest.LocationBias
(메시지)SearchTextRequest.LocationRestriction
(메시지)SearchTextRequest.RankPreference
(열거형)SearchTextResponse
(메시지)
Places
Places API의 서비스 정의입니다. 참고: 모든 요청 (자동 완성 요청 제외)에는 요청 proto 외부에 설정된 필드 마스크가 필요합니다 (all/*
는 가정되지 않음). 필드 마스크는 HTTP 헤더 X-Goog-FieldMask
를 통해 설정할 수 있습니다. https://developers.google.com/maps/documentation/places/web-service/choose-fields 페이지를 참조하세요.
AutocompletePlaces |
---|
지정된 입력에 대한 예측을 반환합니다. |
GetPhotoMedia |
---|
사진 참조 문자열로 사진 미디어를 가져옵니다. |
GetPlace |
---|
리소스 이름( |
SearchNearby |
---|
위치 주변의 장소를 검색합니다. |
SearchText |
---|
텍스트 쿼리 기반 장소 검색 |
AuthorAttribution
입력란 | |
---|---|
display_name |
|
uri |
|
photo_uri |
|
AutocompletePlacesRequest
AutocompletePlaces에 대한 요청 프로토콜입니다.
입력란 | |
---|---|
input |
필수 항목입니다. 검색할 텍스트 문자열입니다. |
location_bias |
선택사항입니다. 지정된 위치에 편중된 결과를 제공합니다.
|
location_restriction |
선택사항입니다. 검색 결과를 지정된 위치로 제한합니다.
|
included_primary_types[] |
선택사항입니다. https://developers.google.com/maps/documentation/places/web-service/place-types의 기본 장소 유형 (예: '레스토랑' 또는 'gas_station')을 포함했습니다. Place는 기본 유형이 이 목록에 포함된 경우에만 반환됩니다. 최대 5개의 값을 지정할 수 있습니다. 유형을 지정하지 않으면 모든 장소 유형이 반환됩니다. |
included_region_codes[] |
선택사항입니다. 최대 15개의 CLDR 2자리 지역 코드로 지정된 지정된 지역의 결과만 포함합니다. 빈 세트는 결과를 제한하지 않습니다. |
language_code |
선택사항입니다. 결과를 반환할 때 사용할 언어입니다. 기본값은 en-US입니다. |
region_code |
선택사항입니다. CLDR 2자리 지역 코드로 지정된 지역 코드입니다. 이는 주소 형식 및 결과 순위에 영향을 미치며 반환되는 결과에 영향을 미칠 수 있습니다. 결과는 지정된 지역으로 제한되지 않습니다. 결과를 리전으로 제한하려면 |
origin |
선택사항입니다. 목적지까지의 측지 거리를 계산할 출발지입니다 ( |
input_offset |
선택사항입니다. 비어 있는 경우 기본값은 |
include_query_predictions |
선택사항입니다. true인 경우 응답에 장소 및 예상 검색어가 모두 포함됩니다. 그렇지 않으면 응답은 장소 예상 검색어만 반환합니다. |
session_token |
선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. ASCII 문자 36자 이하의 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. 세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 사용자가 장소를 선택하고 장소 세부정보 또는 주소 확인 전화를 걸면 종료됩니다. 각 세션에는 여러 개의 쿼리가 포함될 수 있으며 한 번의 장소 세부정보 또는 주소 유효성 검사 요청이 이어집니다. 세션 내에서 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 세션별로 새 토큰을 생성해야 합니다. 다음 가이드라인이 권장됩니다.
|
LocationBias
검색할 지역입니다. 결과가 지정된 지역을 중심으로 편중될 수 있습니다.
입력란 | |
---|---|
통합 필드
|
|
rectangle |
북동쪽과 남서쪽 모서리로 정의된 표시 영역 |
circle |
중심점과 반지름으로 정의되는 원입니다. |
LocationRestriction
검색할 지역입니다. 검색 결과는 지정된 지역으로 제한됩니다.
입력란 | |
---|---|
통합 필드
|
|
rectangle |
북동쪽과 남서쪽 모서리로 정의된 표시 영역 |
circle |
중심점과 반지름으로 정의되는 원입니다. |
AutocompletePlacesResponse
AutocompletePlaces에 대한 응답 proto입니다.
입력란 | |
---|---|
suggestions[] |
관련성에 따라 내림차순으로 정렬된 추천 목록이 포함되어 있습니다. |
추천
자동 완성 추천 결과입니다.
입력란 | |
---|---|
통합 필드
|
|
place_prediction |
장소에 대한 예상 검색어입니다. |
query_prediction |
쿼리에 대한 예측입니다. |
FormattableText
장소 또는 검색어 예상 검색어를 나타내는 텍스트입니다. 텍스트는 있는 그대로 사용하거나 형식이 지정된 대로 사용할 수 있습니다.
입력란 | |
---|---|
text |
그대로 사용하거나 |
matches[] |
이 값은 |
PlacePrediction
Place Autocomplete 예상 검색어의 결과입니다.
입력란 | |
---|---|
place |
추천 장소의 리소스 이름입니다. 이 이름은 장소 이름을 허용하는 다른 API에서 사용할 수 있습니다. |
place_id |
추천 장소의 고유 식별자입니다. 이 식별자는 장소 ID를 허용하는 다른 API에서 사용할 수 있습니다. |
text |
반환된 결과의 사람이 읽을 수 있는 이름을 포함합니다. 시설 결과의 경우 이는 일반적으로 비즈니스 이름과 주소입니다.
이 텍스트는 GetPlace에서 반환된 요청 |
structured_format |
장소 예상 검색어를 장소 이름을 포함하는 기본 텍스트 및 명확한 추가 지형지물 (예: 도시 또는 지역)을 포함하는 보조 텍스트로 분류한 것입니다.
|
types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 또는 표 B에서 이 장소에 적용되는 유형 목록입니다. 유형은 장소의 카테고리입니다. 공유 유형이 있는 장소는 유사한 특성을 공유합니다. |
distance_meters |
|
QueryPrediction
쿼리 자동 완성 예상 검색어의 예측 결과
입력란 | |
---|---|
text |
예상 텍스트입니다. 이 텍스트는 장소가 아니라 검색 엔드포인트 (예: 텍스트 검색)에 사용할 수 있는 텍스트 쿼리를 나타냅니다.
요청 |
structured_format |
쿼리 예측을 쿼리를 포함하는 기본 텍스트와 추가 명확한 특성 (예: 도시 또는 지역)이 포함된 보조 텍스트로 세분화합니다.
|
StringRange
지정된 텍스트 내에서 하위 문자열을 식별합니다.
입력란 | |
---|---|
start_offset |
문자열에서 첫 번째 유니코드 문자의 0부터 시작하는 오프셋입니다 (양 끝값 포함). |
end_offset |
마지막 유니코드 문자의 0 기준 오프셋 (제외) |
StructuredFormat
장소 또는 쿼리 예상 검색어의 세부 내역을 기본 텍스트와 보조 텍스트로 포함합니다.
장소 예상 검색어의 경우 기본 텍스트에 장소의 구체적인 이름이 포함됩니다. 검색어 예측의 경우 기본 텍스트에 검색어가 포함됩니다.
보조 텍스트에는 장소를 추가로 식별하거나 검색어를 세분화하기 위한 추가 구분 요소 (예: 도시 또는 지역)가 포함됩니다.
입력란 | |
---|---|
main_text |
장소 또는 쿼리의 이름을 나타냅니다. |
secondary_text |
장소를 추가로 식별하거나 검색어를 세분화하기 위해 도시 또는 지역과 같은 추가 지형지물을 나타냅니다. |
원
LatLng를 중심 및 반경으로 하는 원입니다.
입력란 | |
---|---|
center |
필수 항목입니다. 중앙의 위도 및 경도입니다. 위도 범위는 [-90.0, 90.0] 내에 있어야 합니다. 경도 범위는 [-180.0, 180.0] 내에 있어야 합니다. |
radius |
필수 항목입니다. 미터 단위로 측정된 반경입니다. 반경은 [0.0, 50000.0] 이내여야 합니다. |
ContentBlock
개별적으로 게재할 수 있는 콘텐츠 블록입니다.
입력란 | |
---|---|
topic |
콘텐츠의 주제입니다(예: '개요' 또는 '음식점'). |
content |
주제와 관련된 콘텐츠입니다. |
references |
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 이 콘텐츠 블록과 관련된 참조입니다. |
ContextualContent
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.
장소 쿼리와 관련이 있는 콘텐츠입니다.
입력란 | |
---|---|
reviews[] |
장소 쿼리와 연속된 이 장소에 대한 리뷰 목록입니다. |
photos[] |
장소 검색어와 연속된 이 장소의 사진에 대한 정보 (참조 포함)입니다. |
justifications[] |
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 장소에 대한 근거입니다. |
근거
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.
장소에 대한 근거입니다. 근거는 장소가 최종 사용자의 관심을 끌 수 있는 이유에 대한 질문에 답변합니다.
입력란 | |
---|---|
통합 필드
|
|
review_justification |
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. |
business_availability_attributes_justification |
실험용: 자세한 내용은 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 |
테이크아웃이 가능한 장소인지 여부 |
delivery |
배송 서비스를 제공하는지 여부 |
dine_in |
매장에서 매장 내 식사를 제공하는지 여부 |
ReviewJustification
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.
사용자 리뷰 근거입니다. 이렇게 하면 최종 사용자가 관심을 가질 만한 사용자 리뷰 섹션이 강조표시됩니다. 예를 들어 검색어가 '장작 피자'인 경우 리뷰 근거는 검색어와 관련된 텍스트를 강조 표시합니다.
입력란 | |
---|---|
highlighted_text |
|
review |
강조표시된 텍스트가 생성된 리뷰입니다. |
HighlightedText
사유로 강조표시된 텍스트입니다. 이는 리뷰 자체의 하위 집합입니다. 강조 표시할 정확한 단어는 HighlightedTextRange로 표시합니다. 강조 표시된 텍스트에 여러 단어가 있을 수 있습니다.
입력란 | |
---|---|
text |
|
highlighted_text_ranges[] |
강조표시된 텍스트의 범위 목록입니다. |
HighlightedTextRange
강조표시된 텍스트의 범위입니다.
입력란 | |
---|---|
start_index |
|
end_index |
|
EVChargeOptions
해당 장소에서 호스팅되는 전기자동차 충전소에 대한 정보입니다. 용어는 https://afdc.energy.gov/fuels/electricity_infrastructure.html을 따릅니다. 포트 1개로 한 번에 차량 1대를 충전할 수 있습니다. 포트 하나에 하나 이상의 커넥터가 있습니다. 스테이션 하나에는 하나 이상의 포트가 있습니다.
입력란 | |
---|---|
connector_count |
이 역의 커넥터 수입니다. 그러나 일부 포트에는 여러 개의 커넥터가 있을 수 있지만 한 번에 하나의 자동차만 충전할 수 있으므로 (예:) 커넥터 수는 동시에 충전할 수 있는 총 자동차 수보다 많을 수 있습니다. |
connector_aggregation[] |
유형이 동일하고 충전 속도가 동일한 커넥터가 포함된 EV 충전 커넥터 집계 목록입니다. |
ConnectorAggregation
[type, max_charge_rate_kw]로 그룹화된 전기자동차 충전 정보입니다. 유형과 최대 충전 속도가 동일한 커넥터의 EV 충전 집계를 키워드 단위로 표시합니다.
입력란 | |
---|---|
type |
이 집계의 커넥터 유형입니다. |
max_charge_rate_kw |
집계에 포함된 각 커넥터의 정적 최대 충전 속도(kw)입니다. |
count |
이 집계의 커넥터 수입니다. |
availability_last_update_time |
이 집계의 커넥터 가용성 정보가 마지막으로 업데이트된 시점의 타임스탬프입니다. |
available_count |
이 집계에서 현재 사용 가능한 커넥터 수입니다. |
out_of_service_count |
이 집계에서 현재 서비스가 중지된 커넥터 수입니다. |
EVConnectorType
전기자동차 충전 커넥터 유형에 관한 추가 정보 및 컨텍스트는 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 |
통합 충전 시스템 (AC 및 DC). SAE 기준입니다. Type-1 J-1772 커넥터 |
EV_CONNECTOR_TYPE_CCS_COMBO_2 |
통합 충전 시스템 (AC 및 DC). Type-2 Mennekes 커넥터 기반 |
EV_CONNECTOR_TYPE_TESLA |
일반 TESLA 커넥터입니다. 북미에서는 NACS이지만 세계 다른 지역에서는 NACS가 아닐 수도 있습니다 (예: CCS 콤보 2 (CCS2) 또는 GB/T). 이 값은 실제 커넥터 유형을 나타내지는 않으며, 테슬라 소유 충전소에서 테슬라 브랜드 차량을 충전하는 기능을 나타냅니다. |
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T |
GB/T 유형은 중국의 GB/T 표준에 해당합니다. 이 유형은 모든 GB_T 유형을 포함합니다. |
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET |
지정되지 않은 전원 콘센트 |
FuelOptions
주유소의 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다.
입력란 | |
---|---|
fuel_prices[] |
이 충전소의 각 연료 유형에 대해 알려진 마지막 연료 가격입니다. 이 충전소의 연료 유형당 항목이 하나씩 있습니다. 순서가 중요하지 않습니다. |
FuelPrice
지정된 유형의 연료 가격 정보입니다.
입력란 | |
---|---|
type |
연료 유형입니다. |
price |
연료 가격입니다. |
update_time |
연료 가격이 마지막으로 업데이트된 시간입니다. |
FuelType
연료 유형
열거형 | |
---|---|
FUEL_TYPE_UNSPECIFIED |
지정되지 않은 연료 유형입니다. |
DIESEL |
디젤 연료 |
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 |
LPG |
E80 |
E 80. |
E85 |
E 85. |
METHANE |
메탄. |
BIO_DIESEL |
바이오 디젤 |
TRUCK_DIESEL |
트럭 디젤. |
GetPhotoMediaRequest
사진 리소스 이름을 사용하여 장소의 사진 가져오기 요청입니다.
입력란 | |
---|---|
name |
필수 항목입니다. 사진 미디어의 리소스 이름( 장소 객체의 |
max_width_px |
선택사항입니다. 이미지의 최대 너비를 원하는 대로 지정합니다(단위: 픽셀). 지정한 값보다 이미지가 작은 경우 원본 이미지가 반환됩니다. 이미지의 높이 또는 너비 중 하나가 더 큰 경우에는 원래의 가로세로 비율을 유지한 채로 작은 항목에 맞게 크기가 조정됩니다. 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 |
선택사항입니다. 원하는 이미지의 최대 높이를 지정합니다(단위: 픽셀). 지정한 값보다 이미지가 작은 경우 원본 이미지가 반환됩니다. 이미지의 높이 또는 너비 중 하나가 더 큰 경우에는 원래의 가로세로 비율을 유지한 채로 작은 항목에 맞게 크기가 조정됩니다. 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 |
선택사항입니다. 설정된 경우 기본 HTTP 리디렉션 동작을 건너뛰고 텍스트 형식 (예: HTTP 사용 사례의 경우 JSON 형식)을 렌더링합니다. 설정하지 않으면 HTTP 리디렉션이 실행되어 호출을 이미지 미디어로 리디렉션합니다. HTTP가 아닌 요청의 경우 이 옵션이 무시됩니다. |
GetPlaceRequest
리소스 이름(places/{place_id}
형식의 문자열)을 기반으로 장소 가져오기 요청입니다.
입력란 | |
---|---|
name |
필수 항목입니다. 장소의 리소스 이름으로, |
language_code |
선택사항입니다. 장소 세부정보가 기본 언어와 함께 표시됩니다(사용 가능한 경우). 현재 지원되는 언어 목록은 https://developers.google.com/maps/faq#languagesupport에서 확인하세요. |
region_code |
선택사항입니다. 요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 사용 가능한 경우 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다. 매개변수는 관련 법률에 따라 결과에 영향을 줄 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참조하세요. 현재 3자리 지역 코드는 지원되지 않습니다. |
session_token |
선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. ASCII 문자 36자 이하의 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. 세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 사용자가 장소를 선택하고 장소 세부정보 또는 주소 확인 전화를 걸면 종료됩니다. 각 세션에는 여러 개의 쿼리가 포함될 수 있으며 한 번의 장소 세부정보 또는 주소 유효성 검사 요청이 이어집니다. 세션 내에서 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 세션별로 새 토큰을 생성해야 합니다. 다음 가이드라인이 권장됩니다.
|
사진
장소 사진에 대한 정보입니다.
입력란 | |
---|---|
name |
식별자. 이 장소 사진을 다시 검색하는 데 사용할 수 있는 이 장소 사진을 나타내는 참조입니다 (API '리소스' 이름: |
width_px |
사용 가능한 최대 너비(픽셀)입니다. |
height_px |
사용 가능한 최대 높이(픽셀)입니다. |
author_attributions[] |
이 사진의 작성자입니다. |
PhotoMedia
Places API의 사진 미디어입니다.
입력란 | |
---|---|
name |
사진 미디어의 리소스 이름( |
photo_uri |
사진을 렌더링하는 데 사용할 수 있는 단기 URI입니다. |
순위
장소를 나타내는 모든 정보입니다.
입력란 | |
---|---|
name |
|
id |
장소의 고유 식별자입니다. |
display_name |
장소의 현지화된 이름으로, 사람이 읽을 수 있는 짧은 설명으로 적합합니다. 예: 'Google 시드니', '스타벅스', 'Pyrmont' 등 |
types[] |
이 결과에 대한 유형 태그 집합입니다. 예: 'political' 및 'locality' 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types에서 표 A와 표 B를 참고하세요. |
primary_type |
지정된 결과의 기본 유형입니다. 이 유형은 Places API에서 지원되는 유형 중 하나여야 합니다. 예를 들어 '레스토랑', '카페', '공항' 등이 있습니다. 하나의 장소에는 하나의 기본 유형만 포함될 수 있습니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types에서 표 A와 표 B를 참고하세요. |
primary_type_display_name |
기본 유형의 표시 이름으로, 해당하는 경우 요청 언어로 현지화된 이름입니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types에서 표 A와 표 B를 참고하세요. |
national_phone_number |
사람이 읽을 수 있는 국가 형식의 전화번호입니다. |
international_phone_number |
사람이 읽을 수 있는 국제 형식의 장소 전화번호입니다. |
formatted_address |
이 장소에 대한 사람이 읽을 수 있는 전체 주소입니다. |
short_formatted_address |
사람이 읽을 수 있는 이 장소의 짧은 주소입니다. |
address_components[] |
각 지역 수준에 반복되는 구성요소 address_components[] 배열에 대한 다음 사항에 유의하세요. - 주소 구성요소 배열에 formatted_address보다 더 많은 구성요소가 포함될 수 있습니다. - 배열에는 formatted_address에 포함된 것을 제외하고 주소를 포함하는 모든 정치적 엔티티가 포함되지 않을 수 있습니다. 특정 주소가 포함된 모든 정치적 독립체를 검색하려면 역 지오코딩을 사용하여 주소의 위도/경도를 매개변수로 요청에 전달해야 합니다. - 응답 형식이 요청 간에 동일하게 유지되지 않을 수 있습니다. 특히 address_components 수는 요청된 주소에 따라 다르며 동일한 주소에 대해 시간이 지남에 따라 변경될 수 있습니다. 배열에서 구성요소의 위치가 변경될 수 있습니다. 구성요소의 유형이 변경될 수 있습니다. 특정 구성요소가 이후 응답에서 누락될 수 있습니다. |
plus_code |
장소 위치 위도/경도의 플러스 코드입니다. |
location |
이 장소의 위치입니다. |
viewport |
평균 크기의 지도에 장소를 표시하는 데 적합한 뷰포트입니다. |
rating |
이 장소에 대한 사용자 리뷰를 기반으로 한 평점은 1.0~5.0입니다. |
google_maps_uri |
이 장소에 대한 추가 정보를 제공하는 URL입니다. |
website_uri |
이 장소의 신뢰할 수 있는 웹사이트입니다(예: 업체 홈페이지). 체인점 (예: IKEA 매장)에 속한 장소의 경우 일반적으로 전체 체인점이 아닌 개별 매장의 웹사이트입니다. |
reviews[] |
이 장소에 대한 리뷰 목록으로, 관련순으로 정렬됩니다. 최대 5개의 리뷰가 반환될 수 있습니다. |
regular_opening_hours |
정규 영업시간입니다. |
photos[] |
이 장소의 사진에 대한 정보 (참조 포함)입니다. 최대 10장의 사진을 반환할 수 있습니다. |
adr_format_address |
adr microformat으로 된 장소의 주소: http://microformats.org/wiki/adr. |
business_status |
장소의 비즈니스 상태입니다. |
price_level |
장소의 가격 수준입니다. |
attributions[] |
이 결과와 함께 표시되어야 하는 데이터 제공자 집합입니다. |
icon_mask_base_uri |
아이콘 마스크의 잘린 URL입니다. 사용자는 끝에 유형 접미사를 추가하여 다양한 아이콘 유형에 액세스할 수 있습니다 (예: '.svg' 또는 '.png'). |
icon_background_color |
16진수 형식 icon_mask의 배경 색상입니다(예: #909CE1). |
current_opening_hours |
앞으로 7일간의 운영 시간입니다 (오늘 포함). 기간은 요청 날짜의 자정에 시작되어 6일 후 오후 11시 59분에 종료됩니다. 이 필드에는 전체 영업시간의 special_days 하위 필드가 포함되며 영업시간이 예외적인 날짜에 대해 설정됩니다. |
current_secondary_opening_hours[] |
비즈니스의 보조 영업시간에 대한 정보를 비롯하여 다음 7일 동안의 항목의 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점의 경우 드라이브스루 시간 또는 배달 시간을 보조 영업시간으로 지정할 수 있습니다. 이 필드는 장소 유형에 따라 사전 정의된 영업시간 유형 (예: DRIVE_THROUGH, PICKUP, TAKEOUT) 목록에서 가져온 유형 하위 필드를 채웁니다. 이 필드에는 전체 영업시간의 special_days 하위 필드가 포함되며 영업시간이 예외적인 날짜에 대해 설정됩니다. |
regular_secondary_opening_hours[] |
비즈니스의 정규 영업시간에 대한 항목의 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점의 경우 드라이브스루 시간 또는 배달 시간을 보조 영업시간으로 지정할 수 있습니다. 이 필드는 장소 유형에 따라 사전 정의된 영업시간 유형 (예: DRIVE_THROUGH, PICKUP, TAKEOUT) 목록에서 가져온 유형 하위 필드를 채웁니다. |
editorial_summary |
장소에 대한 요약을 포함합니다. 요약은 텍스트 개요로 구성되며 해당하는 경우 관련 언어 코드도 포함합니다. 요약 텍스트는 있는 그대로 표시되어야 하며 수정하거나 변경할 수 없습니다. |
payment_options |
장소에서 사용할 수 있는 결제 옵션입니다. 결제 옵션 데이터를 사용할 수 없는 경우 결제 옵션 필드가 설정 해제됩니다. |
parking_options |
장소에서 제공하는 주차 옵션입니다. |
sub_destinations[] |
장소와 관련된 하위 목적지 목록입니다. |
fuel_options |
주유소의 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다. |
ev_charge_options |
EV 충전 옵션 정보 |
generative_summary |
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 장소에 대한 AI 생성 요약입니다. |
area_summary |
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 장소가 위치한 지역에 대한 AI 생성 요약입니다. |
utc_offset_minutes |
현재 이 장소의 시간대가 UTC에서 차이 나는 시간(분)입니다. 분 단위로 표현되어 1시간의 분수로 오프셋되는 시간대를 지원합니다(예: X시간 15분). |
user_rating_count |
이 장소에 대한 총 리뷰 수 (텍스트 유무와 관계없음)입니다. |
takeout |
비즈니스에서 테이크아웃을 지원하는지 여부를 지정합니다. |
delivery |
비즈니스에서 배송을 지원하는지 여부를 지정합니다. |
dine_in |
비즈니스에서 실내 또는 실외 좌석 옵션을 지원하는지 여부를 지정합니다. |
curbside_pickup |
비즈니스에서 매장 밖 수령을 지원하는지 여부를 지정합니다. |
reservable |
장소에서 예약을 지원하는지 여부를 지정합니다. |
serves_breakfast |
장소에서 아침 식사를 제공하는지 지정합니다. |
serves_lunch |
장소에서 점심 식사를 제공하는지 지정합니다. |
serves_dinner |
저녁 식사 제공 여부를 지정합니다. |
serves_beer |
장소에서 맥주를 제공하는지 여부를 지정합니다. |
serves_wine |
장소에서 와인을 제공하는지 명시합니다. |
serves_brunch |
장소에서 브런치를 제공하는지 지정합니다. |
serves_vegetarian_food |
채식 요리를 제공하는지 여부를 지정합니다. |
outdoor_seating |
야외 좌석이 마련된 장소입니다. |
live_music |
라이브 음악을 즐길 수 있는 장소입니다. |
menu_for_children |
어린이 메뉴가 있는 장소입니다. |
serves_cocktails |
칵테일을 제공합니다. |
serves_dessert |
디저트를 판매합니다. |
serves_coffee |
커피숍에서 커피를 즐길 수 있습니다. |
good_for_children |
아이들에게 좋은 장소입니다. |
allows_dogs |
반려견 동반이 가능한 장소입니다. |
restroom |
화장실이 있는 장소입니다. |
good_for_groups |
단체가 수용 가능한 장소입니다. |
good_for_watching_sports |
스포츠 경기를 관람하기에 적합한 장소입니다. |
accessibility_options |
장소에서 제공하는 접근성 옵션에 대한 정보입니다. |
AccessibilityOptions
장소에서 제공하는 접근성 옵션에 대한 정보입니다.
입력란 | |
---|---|
wheelchair_accessible_parking |
휠체어 이용가능 주차장이 있습니다. |
wheelchair_accessible_entrance |
휠체어 이용가능 입구가 있습니다. |
wheelchair_accessible_restroom |
휠체어 이용가능 화장실이 있습니다. |
wheelchair_accessible_seating |
휠체어 이용가능 좌석이 마련되어 있습니다. |
AddressComponent
이 정보를 사용할 수 있는 경우 형식이 지정된 주소를 형성하는 구조화된 구성요소입니다.
입력란 | |
---|---|
long_text |
주소 구성요소의 전체 텍스트 설명 또는 이름입니다. 예를 들어 오스트레일리아에 대한 주소 구성요소의 경우 long_name이 'Australia'일 수 있습니다. |
short_text |
주소 구성요소의 텍스트 약칭입니다(사용 가능한 경우). 예를 들어 오스트레일리아 국가의 주소 구성요소에는 'AU'라는 short_name이 포함될 수 있습니다. |
types[] |
주소 구성요소의 유형을 나타내는 배열입니다. |
language_code |
이 구성요소의 형식을 지정하는 데 사용된 언어(CLDR 표기법)입니다. |
AreaSummary
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.
장소가 위치한 지역에 대한 AI 생성 요약입니다.
입력란 | |
---|---|
content_blocks[] |
영역 요약을 구성하는 콘텐츠 블록입니다. 각 블록에는 해당 지역에 대한 별도의 주제가 있습니다. |
기여 분석
이 장소의 데이터 제공자에 관한 정보입니다.
입력란 | |
---|---|
provider |
장소의 데이터 제공자 이름입니다. |
provider_uri |
장소의 데이터 제공자에 대한 URI입니다. |
BusinessStatus
장소의 비즈니스 상태입니다.
열거형 | |
---|---|
BUSINESS_STATUS_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
OPERATIONAL |
시설은 운영 중이며 지금 영업 중이 아닐 수도 있습니다. |
CLOSED_TEMPORARILY |
시설이 임시 휴업 상태입니다. |
CLOSED_PERMANENTLY |
시설이 폐업했습니다. |
GenerativeSummary
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.
장소에 대한 AI 생성 요약입니다.
입력란 | |
---|---|
overview |
장소의 개요입니다. |
description |
장소에 대한 자세한 설명입니다. |
references |
요약 설명을 생성하는 데 사용되는 참조입니다. |
OpeningHours
장소의 영업시간에 대한 정보입니다.
입력란 | |
---|---|
periods[] |
이 장소가 주중에 영업하는 기간입니다. 기간은 장소 현지 시간대의 일요일부터 시작하여 시간 순서대로 표시됩니다. 비어 있지만 없는 값은 없는 장소 (예: 리노베이션을 위해 임시 휴업)를 나타냅니다. |
weekday_descriptions[] |
이 장소의 영업시간을 설명하는 현지화된 문자열로, 각 요일에 해당하는 문자열입니다. 시간을 알 수 없거나 현지화된 텍스트로 변환할 수 없는 경우 비어 있습니다. 예: '일: 18:00~06:00' |
secondary_hours_type |
보조 영업시간 유형을 식별하는 데 사용되는 유형 문자열입니다. |
special_days[] |
반환된 영업시간에 해당하는 특별한 날에 대해 구조화된 정보입니다. 특별한 날은 장소의 영업시간에 영향을 줄 수 있는 날짜(예: 크리스마스)입니다. 예외적인 영업시간이 있는 경우 current_opening_hours 및 current_secondary_opening_hours로 설정됩니다. |
open_now |
이 장소가 현재 영업 중인가요? 영업시간에 대한 시간 또는 시간대 데이터가 없는 경우 항상 표시됩니다. |
기간
장소가 open_now 상태로 남아 있는 기간입니다.
입력란 | |
---|---|
open |
장소가 영업을 시작하기 시작하는 시간입니다. |
close |
장소의 영업이 종료되기 시작하는 시간입니다. |
지점
상태 변경 지점
입력란 | |
---|---|
date |
장소의 현지 시간대로 된 날짜입니다. |
truncated |
이 엔드포인트가 잘렸는지 여부입니다. 실제 시간과 그 사이의 시간 반환 시간이 이렇게 하면 요청 당일 자정으로부터 최대 24 * 7시간이 반환됩니다. |
day |
요일로, 0~6 범위의 정수로 표시됩니다. 0은 일요일, 1은 월요일 등입니다. |
hour |
시간을 2자리로 표시합니다. 범위는 00~23입니다. |
minute |
분을 2자리로 표시합니다. 범위는 00~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 |
특별한 날의 날짜입니다. |
ParkingOptions
장소의 주차 옵션에 대한 정보입니다. 주차장은 동시에 두 개 이상의 옵션을 지원할 수 있습니다.
입력란 | |
---|---|
free_parking_lot |
무료 주차장이 있습니다. |
paid_parking_lot |
유료 주차장이 있습니다. |
free_street_parking |
노상 주차는 무료입니다. |
paid_street_parking |
유료 노상 주차가 가능합니다. |
valet_parking |
발레파킹 서비스가 제공됩니다. |
free_garage_parking |
주차장을 무료로 이용할 수 있습니다. |
paid_garage_parking |
주차장은 유료로 이용할 수 있습니다. |
PaymentOptions
장소에서 사용할 수 있는 결제 옵션입니다.
입력란 | |
---|---|
accepts_credit_cards |
장소에서 신용카드로 결제할 수 있습니다. |
accepts_debit_cards |
장소에서 체크카드를 사용할 수 있습니다. |
accepts_cash_only |
장소에서는 현금으로만 결제 가능합니다. 이 속성이 있는 장소에서는 다른 결제 수단을 계속 허용할 수 있습니다. |
accepts_nfc |
NFC 결제가 가능한 장소입니다. |
PlusCode
플러스 코드 (http://plus.codes)는 두 가지 형식으로 위치 참조입니다. 하나는 14mx14m (1/8000의 1/8000) 또는 작은 직사각형을 정의하는 글로벌 코드이고 다른 하나는 복합 코드로 접두어를 참조 위치로 대체합니다.
입력란 | |
---|---|
global_code |
장소의 전역(전체) 코드(예: '9FWM33GV+HQ')로, 1/8000x1/8000도 영역(약 14x14미터)을 나타냅니다. |
compound_code |
장소의 복합 코드(예: '33GV+HQ, Ramberg, Korean')입니다. 전역 코드의 접미사가 포함되며 접두사를 참조 항목의 형식이 지정된 이름으로 대체합니다. |
SubDestination
장소와 관련된 하위 대상의 장소 리소스 이름 및 ID입니다. 예를 들어 터미널마다 공항의 목적지가 다릅니다.
입력란 | |
---|---|
name |
하위 대상의 리소스 이름입니다. |
id |
하위 목적지의 장소 ID입니다. |
PriceLevel
장소의 가격 수준입니다.
열거형 | |
---|---|
PRICE_LEVEL_UNSPECIFIED |
장소 가격 수준이 지정되지 않았거나 알 수 없습니다. |
PRICE_LEVEL_FREE |
Place는 무료 서비스를 제공합니다. |
PRICE_LEVEL_INEXPENSIVE |
장소는 저렴한 서비스를 제공합니다. |
PRICE_LEVEL_MODERATE |
합리적인 가격의 서비스를 제공합니다. |
PRICE_LEVEL_EXPENSIVE |
장소는 비싼 서비스를 제공합니다. |
PRICE_LEVEL_VERY_EXPENSIVE |
장소는 매우 비싼 서비스를 제공합니다. |
참조
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.
생성형 콘텐츠와 관련된 참조입니다.
입력란 | |
---|---|
reviews[] |
참조로 사용되는 리뷰입니다. |
places[] |
참조된 장소의 리소스 이름 목록입니다. 이 이름은 장소 리소스 이름을 허용하는 다른 API에서 사용할 수 있습니다. |
복습
장소의 리뷰에 대한 정보입니다.
입력란 | |
---|---|
name |
이 장소 리뷰를 다시 검색하는 데 사용할 수 있는 이 장소 리뷰를 나타내는 참조입니다 (API '리소스' 이름: |
relative_publish_time_description |
형식이 지정된 최근 시간의 문자열로, 현재 시간을 기준으로 한 리뷰 시간을 언어 및 국가에 적합한 형식으로 표현합니다. |
text |
리뷰의 현지화된 텍스트입니다. |
original_text |
원래 언어로 된 리뷰 텍스트입니다. |
rating |
1.0과 5.0 사이의 숫자이며 별 수라고도 합니다. |
author_attribution |
이 리뷰의 작성자입니다. |
publish_time |
리뷰의 타임스탬프입니다. |
SearchNearbyRequest
주변 검색 요청 프로토콜입니다.
입력란 | |
---|---|
language_code |
장소 세부정보가 기본 언어와 함께 표시됩니다(사용 가능한 경우). 언어 코드가 지정되지 않거나 인식할 수 없는 경우 언어의 장소 세부정보가 반환될 수 있으며 세부정보가 있는 경우 영어가 선호됩니다. 현재 지원되는 언어 목록은 https://developers.google.com/maps/faq#languagesupport에서 확인하세요. |
region_code |
요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 사용 가능한 경우 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다. 매개변수는 관련 법률에 따라 결과에 영향을 줄 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참조하세요. 현재 3자리 지역 코드는 지원되지 않습니다. |
included_types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types의 장소 유형 (예: '레스토랑' 또는 'gas_station')이 포함되었습니다. 표 A에서 최대 50개의 유형을 지정할 수 있습니다. 충돌하는 유형이 있는 경우, 즉 유형이 Include_types 및 excluded_types에 모두 표시되는 경우 INVALID_ARGUMENT 오류가 반환됩니다. 장소 유형이 여러 유형 제한과 함께 지정된 경우 모든 제한을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["레스토랑"], excluded_primary_types = ["레스토랑"]}이 있는 경우 반환되는 장소는 '레스토랑' 관련 서비스를 제공하지만 주로 '음식점'으로 운영되지는 않습니다. |
excluded_types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types에서 제외된 장소 유형 (예: '레스토랑' 또는 'gas_station')입니다. 표 A에서 최대 50개의 유형을 지정할 수 있습니다. 클라이언트가 include_types (예: 식당) 및 excluded_types (예: 카페)를 모두 제공하면 응답에 식당은 포함되지만 카페는 포함되지 않아야 합니다. 응답에 포함_유형 중 하나 이상과 일치하지만 제외_유형은 없는 장소가 포함됩니다. 충돌하는 유형이 있는 경우, 즉 유형이 Include_types 및 excluded_types에 모두 표시되는 경우 INVALID_ARGUMENT 오류가 반환됩니다. 장소 유형이 여러 유형 제한과 함께 지정된 경우 모든 제한을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["레스토랑"], excluded_primary_types = ["레스토랑"]}이 있는 경우 반환되는 장소는 '레스토랑' 관련 서비스를 제공하지만 주로 '음식점'으로 운영되지는 않습니다. |
included_primary_types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types의 기본 장소 유형 (예: '레스토랑' 또는 'gas_station')을 포함했습니다. 장소와 연결된 지원되는 유형 표의 기본 유형 하나만 장소에 포함될 수 있습니다. 표 A에서 최대 50개의 유형을 지정할 수 있습니다. 충돌하는 기본 유형이 있는 경우(즉, 유형이 include_primary_types 및 excluded_primary_types 모두에 표시되는 경우) INVALID_ARGUMENT 오류가 반환됩니다. 장소 유형이 여러 유형 제한과 함께 지정된 경우 모든 제한을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["레스토랑"], excluded_primary_types = ["레스토랑"]}이 있는 경우 반환되는 장소는 '레스토랑' 관련 서비스를 제공하지만 주로 '음식점'으로 운영되지는 않습니다. |
excluded_primary_types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types에서 기본 장소 유형 (예: '레스토랑' 또는 'gas_station')을 제외했습니다. 표 A에서 최대 50개의 유형을 지정할 수 있습니다. 충돌하는 기본 유형이 있는 경우(즉, 유형이 include_primary_types 및 excluded_primary_types 모두에 표시되는 경우) INVALID_ARGUMENT 오류가 반환됩니다. 장소 유형이 여러 유형 제한과 함께 지정된 경우 모든 제한을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["레스토랑"], excluded_primary_types = ["레스토랑"]}이 있는 경우 반환되는 장소는 '레스토랑' 관련 서비스를 제공하지만 주로 '음식점'으로 운영되지는 않습니다. |
max_result_count |
반환할 결과의 최대 수입니다. 1 이상, 20 이하여야 합니다 (기본값). 숫자를 설정하지 않으면 상한으로 대체됩니다. 숫자가 음수로 설정되거나 상한을 초과하면 INVALID_ARGUMENT 오류가 반환됩니다. |
location_restriction |
필수 항목입니다. 검색할 지역입니다. |
rank_preference |
응답에서 결과의 순위가 지정되는 방식입니다. |
LocationRestriction
검색할 지역입니다.
입력란 | |
---|---|
통합 필드
|
|
circle |
중심점과 반지름으로 정의되는 원입니다. |
RankPreference
응답에서 결과의 순위가 지정되는 방식입니다.
열거형 | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
RankPreference 값이 설정되지 않았습니다. 기본적으로 POPULARITY별 순위를 사용합니다. |
DISTANCE |
거리를 기준으로 결과의 순위를 매깁니다. |
POPULARITY |
인기도별로 검색 결과의 순위를 매깁니다. |
SearchNearbyResponse
주변 검색의 응답 프로토콜입니다.
입력란 | |
---|---|
places[] |
장소 유형, 장소 수, 구체적인 위치 제한 등 사용자의 요구사항을 충족하는 장소의 목록입니다. |
SearchTextRequest
SearchText의 요청 프로토콜입니다.
입력란 | |
---|---|
text_query |
필수 항목입니다. 텍스트 검색을 위한 텍스트 쿼리입니다. |
language_code |
장소 세부정보가 기본 언어와 함께 표시됩니다(사용 가능한 경우). 언어 코드가 지정되지 않거나 인식할 수 없는 경우 언어의 장소 세부정보가 반환될 수 있으며 세부정보가 있는 경우 영어가 선호됩니다. 현재 지원되는 언어 목록은 https://developers.google.com/maps/faq#languagesupport에서 확인하세요. |
region_code |
요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 사용 가능한 경우 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다. 매개변수는 관련 법률에 따라 결과에 영향을 줄 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참조하세요. 현재 3자리 지역 코드는 지원되지 않습니다. |
rank_preference |
응답에서 결과의 순위가 지정되는 방식입니다. |
included_type |
요청된 장소 유형입니다. 지원되는 유형의 전체 목록: https://developers.google.com/maps/documentation/places/web-service/place-types 포함된 유형 1개만 지원합니다. |
open_now |
현재 열려 있는 장소로 검색을 제한하는 데 사용됩니다. 기본값은 false입니다. |
min_rating |
평균 사용자 평점이 이 한도보다 낮은 결과를 필터링합니다. 유효한 값은 0.5 케이던스([0, 0.5, 1.0, ... , 5.0] 포함)로 0과 5 사이의 부동 소수점이어야 합니다. 입력 평점은 가장 가까운 0.5(최대)로 반올림됩니다. 예를 들어 평점이 0.6이면 평점이 1.0 미만인 모든 결과가 제외됩니다. |
max_result_count |
지원 중단됨: 대신 페이지당 반환할 수 있는 최대 결과 수입니다. 사용 가능한 결과 수가
|
page_size |
선택사항입니다. 페이지당 반환할 수 있는 최대 결과 수입니다. 사용 가능한 결과 수가
|
page_token |
선택사항입니다. 이전 TextSearch 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 TextSearch에 제공된 |
price_levels[] |
특정 가격 수준으로 표시된 장소로 검색을 제한하는 데 사용됩니다. 사용자는 가격 수준의 조합을 선택할 수 있습니다. 기본적으로 모든 가격 수준을 선택합니다. |
strict_type_filtering |
include_type에 엄격한 유형 필터링을 설정하는 데 사용됩니다. true로 설정하면 같은 유형의 결과만 반환됩니다. 기본값은 false입니다. |
location_bias |
검색할 지역입니다. 이 위치는 지정된 위치를 둘러싼 결과가 반환될 수 있다는 의미로 바이어스 역할을 합니다. location_restriction과 함께 설정할 수는 없습니다. |
location_restriction |
검색할 지역입니다. 이 위치는 제한 역할을 하므로 지정된 위치를 벗어난 결과는 반환되지 않습니다. location_bias와 함께 설정할 수 없습니다. |
ev_options |
선택사항입니다. 장소 검색 요청의 검색 가능한 EV 옵션을 설정합니다. |
EVOptions
장소 검색 요청의 검색 가능한 EV 옵션입니다.
입력란 | |
---|---|
minimum_charging_rate_kw |
선택사항입니다. 필요한 최소 충전 속도(킬로와트 단위) 충전율이 지정된 요금보다 낮은 장소가 필터링됩니다. |
connector_types[] |
선택사항입니다. 기본 EV 커넥터 유형의 목록입니다. 나열된 커넥터 유형을 지원하지 않는 장소는 필터링됩니다. |
LocationBias
검색할 지역입니다. 이 위치는 지정된 위치를 둘러싼 결과가 반환될 수 있다는 의미로 바이어스 역할을 합니다.
입력란 | |
---|---|
통합 필드
|
|
rectangle |
북동쪽과 남서쪽 모서리로 정의된 직사각형 상자. |
circle |
중심점과 반지름으로 정의되는 원입니다. |
LocationRestriction
검색할 지역입니다. 이 위치는 제한 역할을 하므로 지정된 위치를 벗어난 결과는 반환되지 않습니다.
입력란 | |
---|---|
통합 필드
|
|
rectangle |
북동쪽과 남서쪽 모서리로 정의된 직사각형 상자. |
RankPreference
응답에서 결과의 순위가 지정되는 방식입니다.
열거형 | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
'뉴욕의 식당'과 같은 범주형 쿼리의 경우 RELEVANCE는 기본값입니다. '캘리포니아 마운틴뷰'와 같이 카테고리가 없는 쿼리의 경우 rankPreference를 설정하지 않은 상태로 두는 것이 좋습니다. |
DISTANCE |
거리를 기준으로 결과의 순위를 매깁니다. |
RELEVANCE |
관련성을 기준으로 결과의 순위를 매깁니다. 일반 순위 스택에 따라 결정된 정렬 순서입니다. |
SearchTextResponse
SearchText의 응답 프로토콜입니다.
입력란 | |
---|---|
places[] |
사용자의 텍스트 검색 기준에 맞는 장소의 목록입니다. |
contextual_contents[] |
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 각 항목이 장소 필드의 동일한 색인에 있는 해당 장소와 연결되는 상황별 콘텐츠 목록입니다. 요청의 |
next_page_token |
다음 페이지를 검색하기 위해 |