Package google.maps.places.v1

색인

Places

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

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

지정된 입력에 대한 예측을 반환합니다.

GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

사진 참조 문자열로 사진 미디어를 가져옵니다.

GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

리소스 이름(places/{place_id} 형식의 문자열)을 기반으로 장소의 세부정보를 가져옵니다.

SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

위치 주변의 장소를 검색합니다.

SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

텍스트 쿼리 기반 장소 검색

AuthorAttribution

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

입력란
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의 기본 장소 유형 (예: '레스토랑' 또는 'gas_station')을 포함했습니다. Place는 기본 유형이 이 목록에 포함된 경우에만 반환됩니다. 최대 5개의 값을 지정할 수 있습니다. 유형을 지정하지 않으면 모든 장소 유형이 반환됩니다.

included_region_codes[]

string

선택사항입니다. 최대 15개의 CLDR 2자리 지역 코드로 지정된 지정된 지역의 결과만 포함합니다. 빈 세트는 결과를 제한하지 않습니다. location_restrictionincluded_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의 커서 위치를 나타내는 input의 0부터 시작하는 유니코드 문자 오프셋입니다. 커서 위치는 반환되는 예측에 영향을 줄 수 있습니다.

비어 있는 경우 기본값은 input입니다.

include_query_predictions

bool

선택사항입니다. true인 경우 응답에 장소 및 예상 검색어가 모두 포함됩니다. 그렇지 않으면 응답은 장소 예상 검색어만 반환합니다.

session_token

string

선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. ASCII 문자 36자 이하의 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 사용자가 장소를 선택하고 장소 세부정보 또는 주소 확인 전화를 걸면 종료됩니다. 각 세션에는 여러 개의 쿼리가 포함될 수 있으며 한 번의 장소 세부정보 또는 주소 유효성 검사 요청이 이어집니다. 세션 내에서 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 세션별로 새 토큰을 생성해야 합니다. session_token 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다 (각 요청에는 별도로 요금이 청구됩니다).

다음 가이드라인이 권장됩니다.

  • 모든 Place Autocomplete 호출에 세션 토큰을 사용합니다.
  • 각 세션에 대해 새 토큰을 생성합니다. 버전 4 UUID를 사용하는 것이 좋습니다.
  • 한 세션 내의 모든 Place Autocomplete, Place Details, Address Validation 요청에 사용된 사용자 인증 정보가 동일한 Cloud 콘솔 프로젝트에 속하는지 확인합니다.
  • 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 2개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.

LocationBias

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

입력란

통합 필드 type.

type는 다음 중 하나여야 합니다.

rectangle

Viewport

북동쪽과 남서쪽 모서리로 정의된 표시 영역

circle

Circle

중심점과 반지름으로 정의되는 원입니다.

LocationRestriction

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

입력란

통합 필드 type.

type는 다음 중 하나여야 합니다.

rectangle

Viewport

북동쪽과 남서쪽 모서리로 정의된 표시 영역

circle

Circle

중심점과 반지름으로 정의되는 원입니다.

AutocompletePlacesResponse

AutocompletePlaces에 대한 응답 proto입니다.

입력란
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_formattext로 파싱해서는 안 되며 그 반대의 경우도 마찬가지입니다.

이 텍스트는 GetPlace에서 반환된 display_name와 다를 수 있습니다.

요청 inputlanguage_code가 다른 언어로 되어 있거나 장소에 현지 언어에서 language_code로 번역되지 않은 경우 혼합 언어일 수 있습니다.

structured_format

StructuredFormat

장소 예상 검색어를 장소 이름을 포함하는 기본 텍스트 및 명확한 추가 지형지물 (예: 도시 또는 지역)을 포함하는 보조 텍스트로 분류한 것입니다.

structured_format는 서로 다르지만 관련된 두 가지 UI 요소를 표시하려는 개발자에게 권장됩니다. 단일 UI 요소를 표시하려는 개발자는 대신 text를 사용하는 것이 좋습니다. 두 가지 방법으로 장소 예상 검색어를 나타냅니다. 사용자는 structured_formattext로 파싱해서는 안 되며 그 반대의 경우도 마찬가지입니다.

types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 또는 표 B에서 이 장소에 적용되는 유형 목록입니다.

유형은 장소의 카테고리입니다. 공유 유형이 있는 장소는 유사한 특성을 공유합니다.

distance_meters

int32

origin가 지정된 경우 origin부터 최단 거리의 길이(미터)입니다. 경로와 같은 특정 예측은 이 입력란을 채우지 않을 수도 있습니다.

QueryPrediction

쿼리 자동 완성 예상 검색어의 예측 결과

입력란
text

FormattableText

예상 텍스트입니다. 이 텍스트는 장소가 아니라 검색 엔드포인트 (예: 텍스트 검색)에 사용할 수 있는 텍스트 쿼리를 나타냅니다.

text는 단일 UI 요소를 표시하려는 개발자에게 권장됩니다. 서로 별개이지만 서로 관련이 있는 두 가지 UI 요소를 표시하려는 개발자는 대신 structured_format를 사용하는 것이 좋습니다. 이 둘은 쿼리 예측을 표현하는 두 가지 방법입니다. 사용자는 structured_formattext로 파싱해서는 안 되며 그 반대의 경우도 마찬가지입니다.

요청 inputlanguage_code가 다른 언어로 되어 있거나 쿼리의 일부에 현지 언어에서 language_code로의 번역이 없는 경우 혼합 언어일 수 있습니다.

structured_format

StructuredFormat

쿼리 예측을 쿼리를 포함하는 기본 텍스트와 추가 명확한 특성 (예: 도시 또는 지역)이 포함된 보조 텍스트로 세분화합니다.

structured_format는 서로 다르지만 관련된 두 가지 UI 요소를 표시하려는 개발자에게 권장됩니다. 단일 UI 요소를 표시하려는 개발자는 대신 text를 사용하는 것이 좋습니다. 이 둘은 쿼리 예측을 표현하는 두 가지 방법입니다. 사용자는 structured_formattext로 파싱해서는 안 되며 그 반대의 경우도 마찬가지입니다.

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

개별적으로 게재할 수 있는 콘텐츠 블록입니다.

입력란
topic

string

콘텐츠의 주제입니다(예: '개요' 또는 '음식점').

content

LocalizedText

주제와 관련된 콘텐츠입니다.

references

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[]

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을 따릅니다. 포트 1개로 한 번에 차량 1대를 충전할 수 있습니다. 포트 하나에 하나 이상의 커넥터가 있습니다. 스테이션 하나에는 하나 이상의 포트가 있습니다.

입력란
connector_count

int32

이 역의 커넥터 수입니다. 그러나 일부 포트에는 여러 개의 커넥터가 있을 수 있지만 한 번에 하나의 자동차만 충전할 수 있으므로 (예:) 커넥터 수는 동시에 충전할 수 있는 총 자동차 수보다 많을 수 있습니다.

connector_aggregation[]

ConnectorAggregation

유형이 동일하고 충전 속도가 동일한 커넥터가 포함된 EV 충전 커넥터 집계 목록입니다.

ConnectorAggregation

[type, max_charge_rate_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

전기자동차 충전 커넥터 유형에 관한 추가 정보 및 컨텍스트는 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

이 충전소의 각 연료 유형에 대해 알려진 마지막 연료 가격입니다. 이 충전소의 연료 유형당 항목이 하나씩 있습니다. 순서가 중요하지 않습니다.

FuelPrice

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

입력란
type

FuelType

연료 유형입니다.

price

Money

연료 가격입니다.

update_time

Timestamp

연료 가격이 마지막으로 업데이트된 시간입니다.

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

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

선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. ASCII 문자 36자 이하의 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 사용자가 장소를 선택하고 장소 세부정보 또는 주소 확인 전화를 걸면 종료됩니다. 각 세션에는 여러 개의 쿼리가 포함될 수 있으며 한 번의 장소 세부정보 또는 주소 유효성 검사 요청이 이어집니다. 세션 내에서 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 세션별로 새 토큰을 생성해야 합니다. session_token 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다 (각 요청에는 별도로 요금이 청구됩니다).

다음 가이드라인이 권장됩니다.

  • 모든 Place Autocomplete 호출에 세션 토큰을 사용합니다.
  • 각 세션에 대해 새 토큰을 생성합니다. 버전 4 UUID를 사용하는 것이 좋습니다.
  • 한 세션 내의 모든 Place Autocomplete, Place Details, Address Validation 요청에 사용된 사용자 인증 정보가 동일한 Cloud 콘솔 프로젝트에 속하는지 확인합니다.
  • 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 2개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.

사진

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

입력란
name

string

식별자. 이 장소 사진을 다시 검색하는 데 사용할 수 있는 이 장소 사진을 나타내는 참조입니다 (API '리소스' 이름: places/{place_id}/photos/{photo}라고도 함).

width_px

int32

사용 가능한 최대 너비(픽셀)입니다.

height_px

int32

사용 가능한 최대 높이(픽셀)입니다.

author_attributions[]

AuthorAttribution

이 사진의 작성자입니다.

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 시드니', '스타벅스', 'Pyrmont' 등

types[]

string

이 결과에 대한 유형 태그 집합입니다. 예: 'political' 및 'locality' 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types에서 표 A와 표 B를 참고하세요.

primary_type

string

지정된 결과의 기본 유형입니다. 이 유형은 Places API에서 지원되는 유형 중 하나여야 합니다. 예를 들어 '레스토랑', '카페', '공항' 등이 있습니다. 하나의 장소에는 하나의 기본 유형만 포함될 수 있습니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types에서 표 A와 표 B를 참고하세요.

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

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

address_components[]

AddressComponent

각 지역 수준에 반복되는 구성요소 address_components[] 배열에 대한 다음 사항에 유의하세요. - 주소 구성요소 배열에 formatted_address보다 더 많은 구성요소가 포함될 수 있습니다. - 배열에는 formatted_address에 포함된 것을 제외하고 주소를 포함하는 모든 정치적 엔티티가 포함되지 않을 수 있습니다. 특정 주소가 포함된 모든 정치적 독립체를 검색하려면 역 지오코딩을 사용하여 주소의 위도/경도를 매개변수로 요청에 전달해야 합니다. - 응답 형식이 요청 간에 동일하게 유지되지 않을 수 있습니다. 특히 address_components 수는 요청된 주소에 따라 다르며 동일한 주소에 대해 시간이 지남에 따라 변경될 수 있습니다. 배열에서 구성요소의 위치가 변경될 수 있습니다. 구성요소의 유형이 변경될 수 있습니다. 특정 구성요소가 이후 응답에서 누락될 수 있습니다.

plus_code

PlusCode

장소 위치 위도/경도의 플러스 코드입니다.

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

정규 영업시간입니다.

photos[]

Photo

이 장소의 사진에 대한 정보 (참조 포함)입니다. 최대 10장의 사진을 반환할 수 있습니다.

adr_format_address

string

adr microformat으로 된 장소의 주소: 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

16진수 형식 icon_mask의 배경 색상입니다(예: #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

EV 충전 옵션 정보

generative_summary

GenerativeSummary

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

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

area_summary

AreaSummary

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

장소가 위치한 지역에 대한 AI 생성 요약입니다.

utc_offset_minutes

int32

현재 이 장소의 시간대가 UTC에서 차이 나는 시간(분)입니다. 분 단위로 표현되어 1시간의 분수로 오프셋되는 시간대를 지원합니다(예: 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

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

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

주소 구성요소의 텍스트 약칭입니다(사용 가능한 경우). 예를 들어 오스트레일리아 국가의 주소 구성요소에는 'AU'라는 short_name이 포함될 수 있습니다.

types[]

string

주소 구성요소의 유형을 나타내는 배열입니다.

language_code

string

이 구성요소의 형식을 지정하는 데 사용된 언어(CLDR 표기법)입니다.

AreaSummary

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

장소가 위치한 지역에 대한 AI 생성 요약입니다.

입력란
content_blocks[]

ContentBlock

영역 요약을 구성하는 콘텐츠 블록입니다. 각 블록에는 해당 지역에 대한 별도의 주제가 있습니다.

기여 분석

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

입력란
provider

string

장소의 데이터 제공자 이름입니다.

provider_uri

string

장소의 데이터 제공자에 대한 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

LocalizedText

장소의 개요입니다.

description

LocalizedText

장소에 대한 자세한 설명입니다.

references

References

요약 설명을 생성하는 데 사용되는 참조입니다.

OpeningHours

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

입력란
periods[]

Period

이 장소가 주중에 영업하는 기간입니다. 기간은 장소 현지 시간대의 일요일부터 시작하여 시간 순서대로 표시됩니다. 비어 있지만 없는 값은 없는 장소 (예: 리노베이션을 위해 임시 휴업)를 나타냅니다.

weekday_descriptions[]

string

이 장소의 영업시간을 설명하는 현지화된 문자열로, 각 요일에 해당하는 문자열입니다. 시간을 알 수 없거나 현지화된 텍스트로 변환할 수 없는 경우 비어 있습니다. 예: '일: 18:00~06:00'

secondary_hours_type

SecondaryHoursType

보조 영업시간 유형을 식별하는 데 사용되는 유형 문자열입니다.

special_days[]

SpecialDay

반환된 영업시간에 해당하는 특별한 날에 대해 구조화된 정보입니다. 특별한 날은 장소의 영업시간에 영향을 줄 수 있는 날짜(예: 크리스마스)입니다. 예외적인 영업시간이 있는 경우 current_opening_hours 및 current_secondary_opening_hours로 설정됩니다.

open_now

bool

이 장소가 현재 영업 중인가요? 영업시간에 대한 시간 또는 시간대 데이터가 없는 경우 항상 표시됩니다.

기간

장소가 open_now 상태로 남아 있는 기간입니다.

입력란
open

Point

장소가 영업을 시작하기 시작하는 시간입니다.

close

Point

장소의 영업이 종료되기 시작하는 시간입니다.

지점

상태 변경 지점

입력란
date

Date

장소의 현지 시간대로 된 날짜입니다.

truncated

bool

이 엔드포인트가 잘렸는지 여부입니다. 실제 시간과 그 사이의 시간 반환 시간이 이렇게 하면 요청 당일 자정으로부터 최대 24 * 7시간이 반환됩니다.

day

int32

요일로, 0~6 범위의 정수로 표시됩니다. 0은 일요일, 1은 월요일 등입니다.

hour

int32

시간을 2자리로 표시합니다. 범위는 00~23입니다.

minute

int32

분을 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

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

플러스 코드 (http://plus.codes)는 두 가지 형식으로 위치 참조입니다. 하나는 14mx14m (1/8000의 1/8000) 또는 작은 직사각형을 정의하는 글로벌 코드이고 다른 하나는 복합 코드로 접두어를 참조 위치로 대체합니다.

입력란
global_code

string

장소의 전역(전체) 코드(예: '9FWM33GV+HQ')로, 1/8000x1/8000도 영역(약 14x14미터)을 나타냅니다.

compound_code

string

장소의 복합 코드(예: '33GV+HQ, Ramberg, Korean')입니다. 전역 코드의 접미사가 포함되며 접두사를 참조 항목의 형식이 지정된 이름으로 대체합니다.

SubDestination

장소와 관련된 하위 대상의 장소 리소스 이름 및 ID입니다. 예를 들어 터미널마다 공항의 목적지가 다릅니다.

입력란
name

string

하위 대상의 리소스 이름입니다.

id

string

하위 목적지의 장소 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[]

Review

참조로 사용되는 리뷰입니다.

places[]

string

참조된 장소의 리소스 이름 목록입니다. 이 이름은 장소 리소스 이름을 허용하는 다른 API에서 사용할 수 있습니다.

복습

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

입력란
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

리뷰의 타임스탬프입니다.

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의 장소 유형 (예: '레스토랑' 또는 'gas_station')이 포함되었습니다.

표 A에서 최대 50개의 유형을 지정할 수 있습니다.

충돌하는 유형이 있는 경우, 즉 유형이 Include_types 및 excluded_types에 모두 표시되는 경우 INVALID_ARGUMENT 오류가 반환됩니다.

장소 유형이 여러 유형 제한과 함께 지정된 경우 모든 제한을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["레스토랑"], excluded_primary_types = ["레스토랑"]}이 있는 경우 반환되는 장소는 '레스토랑' 관련 서비스를 제공하지만 주로 '음식점'으로 운영되지는 않습니다.

excluded_types[]

string

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[]

string

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[]

string

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

int32

반환할 결과의 최대 수입니다. 1 이상, 20 이하여야 합니다 (기본값). 숫자를 설정하지 않으면 상한으로 대체됩니다. 숫자가 음수로 설정되거나 상한을 초과하면 INVALID_ARGUMENT 오류가 반환됩니다.

location_restriction

LocationRestriction

필수 항목입니다. 검색할 지역입니다.

rank_preference

RankPreference

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

LocationRestriction

검색할 지역입니다.

입력란

통합 필드 type.

type는 다음 중 하나여야 합니다.

circle

Circle

중심점과 반지름으로 정의되는 원입니다.

RankPreference

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

열거형
RANK_PREFERENCE_UNSPECIFIED RankPreference 값이 설정되지 않았습니다. 기본적으로 POPULARITY별 순위를 사용합니다.
DISTANCE 거리를 기준으로 결과의 순위를 매깁니다.
POPULARITY 인기도별로 검색 결과의 순위를 매깁니다.

SearchNearbyResponse

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

입력란
places[]

Place

장소 유형, 장소 수, 구체적인 위치 제한 등 사용자의 요구사항을 충족하는 장소의 목록입니다.

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 포함된 유형 1개만 지원합니다.

open_now

bool

현재 열려 있는 장소로 검색을 제한하는 데 사용됩니다. 기본값은 false입니다.

min_rating

double

평균 사용자 평점이 이 한도보다 낮은 결과를 필터링합니다. 유효한 값은 0.5 케이던스([0, 0.5, 1.0, ... , 5.0] 포함)로 0과 5 사이의 부동 소수점이어야 합니다. 입력 평점은 가장 가까운 0.5(최대)로 반올림됩니다. 예를 들어 평점이 0.6이면 평점이 1.0 미만인 모든 결과가 제외됩니다.

max_result_count
(deprecated)

int32

지원 중단됨: 대신 page_size를 사용하세요.

페이지당 반환할 수 있는 최대 결과 수입니다. 사용 가능한 결과 수가 max_result_count보다 크면 next_page_token가 반환되며 이 결과를 page_token에 전달하여 후속 요청에서 결과의 다음 페이지를 가져올 수 있습니다. 0을 제공하거나 값을 제공하지 않으면 기본값 20이 사용됩니다. 최댓값은 20이며, 20을 초과하는 값은 20으로 강제 변환됩니다. 음수 값은 INVALID_ARGUMENT 오류를 반환합니다.

max_result_countpage_size를 모두 지정하면 max_result_count가 무시됩니다.

page_size

int32

선택사항입니다. 페이지당 반환할 수 있는 최대 결과 수입니다. 사용 가능한 결과 수가 page_size보다 크면 next_page_token가 반환되며 이 결과를 page_token에 전달하여 후속 요청에서 결과의 다음 페이지를 가져올 수 있습니다. 0을 제공하거나 값을 제공하지 않으면 기본값 20이 사용됩니다. 최댓값은 20이며, 20보다 큰 값은 20으로 설정됩니다. 음수 값은 INVALID_ARGUMENT 오류를 반환합니다.

max_result_countpage_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

include_type에 엄격한 유형 필터링을 설정하는 데 사용됩니다. true로 설정하면 같은 유형의 결과만 반환됩니다. 기본값은 false입니다.

location_bias

LocationBias

검색할 지역입니다. 이 위치는 지정된 위치를 둘러싼 결과가 반환될 수 있다는 의미로 바이어스 역할을 합니다. location_restriction과 함께 설정할 수는 없습니다.

location_restriction

LocationRestriction

검색할 지역입니다. 이 위치는 제한 역할을 하므로 지정된 위치를 벗어난 결과는 반환되지 않습니다. location_bias와 함께 설정할 수 없습니다.

ev_options

EVOptions

선택사항입니다. 장소 검색 요청의 검색 가능한 EV 옵션을 설정합니다.

EVOptions

장소 검색 요청의 검색 가능한 EV 옵션입니다.

입력란
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 관련성을 기준으로 결과의 순위를 매깁니다. 일반 순위 스택에 따라 결정된 정렬 순서입니다.

SearchTextResponse

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

입력란
places[]

Place

사용자의 텍스트 검색 기준에 맞는 장소의 목록입니다.

contextual_contents[]

ContextualContent

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

각 항목이 장소 필드의 동일한 색인에 있는 해당 장소와 연결되는 상황별 콘텐츠 목록입니다. 요청의 text_query와 관련된 콘텐츠가 선호됩니다. 장소 중 하나에 대해 문맥 콘텐츠를 사용할 수 없는 경우 문맥이 없는 콘텐츠를 반환합니다. 이 장소에 대한 콘텐츠가 없는 경우에만 비어 있습니다. 이 목록에는 요청된 경우 장소 목록만큼 항목이 있어야 합니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token로 전송할 수 있는 토큰입니다. 이 필드가 생략되거나 비어 있는 경우 다음 페이지가 표시되지 않습니다.