이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Places Service

PlacesService 클래스

google.maps.places.PlacesService 클래스

장소 검색 및 장소 세부정보 검색과 관련된 메서드를 포함합니다.

const {PlacesService} = await google.maps.importLibrary("places")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

생성자
`PlacesService`	`PlacesService(attrContainer)` 매개변수: `attrContainer`: `HTMLDivElement\|Map` 지정된 컨테이너에 저작자 표시를 렌더링하는 `PlacesService`의 새 인스턴스를 만듭니다.

메서드
`findPlaceFromPhoneNumber`	`findPlaceFromPhoneNumber(request, callback)` 매개변수: `request`: `FindPlaceFromPhoneNumberRequest` `callback`: `function(Array<PlaceResult> optional, PlacesServiceStatus): void` 반환 값: 없음 전화번호를 기반으로 장소 목록을 가져옵니다. 대부분의 경우 결과 목록에 항목이 하나만 있어야 하지만 요청이 모호한 경우 두 개 이상의 결과가 반환될 수 있습니다. 콜백에 전달되는 `PlaceResult`는 전체 `PlaceResult`의 하위 집합입니다. 앱은 `PlacesService.getDetails`를 호출하고 원하는 장소의 `PlaceResult.place_id`를 전달하여 각 장소에 대한 더 자세한 `PlaceResult`를 가져올 수 있습니다.
`findPlaceFromQuery`	`findPlaceFromQuery(request, callback)` 매개변수: `request`: `FindPlaceFromQueryRequest` `callback`: `function(Array<PlaceResult> optional, PlacesServiceStatus): void` 반환 값: 없음 검색 문자열을 기반으로 장소 목록을 가져옵니다. 대부분의 경우 결과 목록에 항목이 하나만 있어야 하지만 요청이 모호한 경우 두 개 이상의 결과가 반환될 수 있습니다. 콜백에 전달되는 `PlaceResult`는 전체 `PlaceResult`의 하위 집합입니다. 앱은 `PlacesService.getDetails`를 호출하고 원하는 장소의 `PlaceResult.place_id`를 전달하여 각 장소에 대한 더 자세한 `PlaceResult`를 가져올 수 있습니다.
`getDetails`	`getDetails(request, callback)` 매개변수: `request`: `PlaceDetailsRequest` `callback`: `function(PlaceResult optional, PlacesServiceStatus): void` 반환 값: 없음 지정된 `placeId`로 식별된 장소에 대한 세부정보를 가져옵니다.
`nearbySearch`	`nearbySearch(request, callback)` 매개변수: `request`: `PlaceSearchRequest` `callback`: `function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void` 반환 값: 없음 키워드 또는 유형을 기반으로 특정 위치 근처의 장소 목록을 검색합니다. 위치는 항상 `LatLngBounds` 또는 `location` 및 `radius` 매개변수를 전달하여 지정해야 합니다. 콜백에 전달되는 `PlaceResult`는 전체 `PlaceResult`의 하위 집합입니다. 앱은 원하는 장소의 `PlaceResult.place_id`를 전달하는 장소 세부정보 요청을 전송하여 각 장소의 더 자세한 `PlaceResult`를 가져올 수 있습니다. `PlaceSearchPagination` 객체는 추가 결과 페이지를 가져오는 데 사용할 수 있습니다 (결과의 마지막 페이지이거나 결과 페이지가 하나만 있는 경우 null).
`textSearch`	`textSearch(request, callback)` 매개변수: `request`: `TextSearchRequest` `callback`: `function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void` 반환 값: 없음 검색 문자열 (예: '뉴욕의 피자' 또는 '오타와 근처의 신발 가게')을 기반으로 장소 목록을 검색합니다. 위치 매개변수는 선택사항입니다. 위치가 지정되면 결과가 해당 지역 내 장소로 제한되는 대신 주변 결과에만 편중됩니다. 임의의 문자열을 사용하여 장소를 검색하려는 경우와 검색 결과를 특정 위치로 제한하고 싶지 않은 경우에 `textSearch`를 사용하세요. `PlaceSearchPagination` 객체는 추가 결과 페이지를 가져오는 데 사용할 수 있습니다 (결과의 마지막 페이지이거나 결과 페이지가 하나만 있는 경우 null).

PlaceDetailsRequest 인터페이스

google.maps.places.PlaceDetailsRequest 인터페이스

PlacesService로 전송할 장소 세부정보 쿼리입니다.

속성
`placeId`	유형: `string` 세부정보를 요청하는 장소의 장소 ID입니다.
`fields optional`	유형: `Array<string> optional` 세부정보 응답에 포함되고 요금이 청구되는 필드입니다. 필드를 지정하지 않거나 `['ALL']`를 전달하면 사용 가능한 모든 필드가 반환되고 비용이 청구됩니다 (프로덕션 배포의 경우 권장되지 않음). 필드 목록은 `PlaceResult`를 참고하세요. 중첩된 필드는 점 경로 (예: `"geometry.location"`)로 지정할 수 있습니다.
`language optional`	유형: `string optional` 세부정보를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
`region optional`	유형: `string optional` 사용자의 지역 코드입니다. 이로 인해 반품될 사진과 기타 사항에 영향을 줄 수 있습니다. 지역 코드는 ccTLD ('최상위 도메인') 2자리 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (`.co.uk`)이지만 ISO 3166-1 코드는 'gb'입니다(기술적으로 '영국과 북아일랜드의 합중국'의 항목에 해당).
`sessionToken optional`	유형: `AutocompleteSessionToken optional` 세부정보 요청을 자동 완성 세션과 번들로 묶는 데 사용되는 고유한 참조입니다.

FindPlaceFromPhoneNumberRequest 인터페이스

google.maps.places.FindPlaceFromPhoneNumberRequest 인터페이스

PlacesService.findPlaceFromPhoneNumber로 전송할 텍스트 검색에서 장소 찾기 요청입니다.

속성
`fields`	유형: `Array<string>` 응답에 포함되고 요금이 청구되는 필드입니다. `['ALL']`가 전달되면 사용 가능한 모든 필드가 반환되고 청구됩니다 (프로덕션 배포의 경우 권장되지 않음). 필드 목록은 `PlaceResult`를 참고하세요. 중첩된 필드는 점 경로 (예: `"geometry.location"`)로 지정할 수 있습니다.
`phoneNumber`	유형: `string` 조회할 장소의 전화번호입니다. 형식은 E.164여야 합니다.
`language optional`	유형: `string optional` 이름과 주소를 반환해야 하는 언어의 언어 식별자(가능한 경우)입니다. 지원 언어 목록을 참조하세요.
`locationBias optional`	유형: `LocationBias optional` 장소를 검색할 때 사용되는 편향입니다. 결과는 지정된 `LocationBias`에 편중되지만 이 `LocationBias`로 제한되지는 않습니다.

FindPlaceFromQueryRequest 인터페이스

google.maps.places.FindPlaceFromQueryRequest 인터페이스

PlacesService.findPlaceFromQuery로 전송할 텍스트 검색에서 장소 찾기 요청입니다.

속성
`fields`	유형: `Array<string>` 응답에 포함되고 요금이 청구되는 필드입니다. `['ALL']`가 전달되면 사용 가능한 모든 필드가 반환되고 청구됩니다 (프로덕션 배포의 경우 권장되지 않음). 필드 목록은 `PlaceResult`를 참고하세요. 중첩된 필드는 점 경로 (예: `"geometry.location"`)로 지정할 수 있습니다.
`query`	유형: `string` 요청의 쿼리입니다. 예를 들어 장소의 이름이나 주소를 나타낼 수 있습니다.
`language optional`	유형: `string optional` 이름과 주소를 반환해야 하는 언어의 언어 식별자(가능한 경우)입니다. 지원 언어 목록을 참조하세요.
`locationBias optional`	유형: `LocationBias optional` 장소를 검색할 때 사용되는 편향입니다. 결과는 지정된 `LocationBias`에 편중되지만 이 `LocationBias`로 제한되지는 않습니다.

PlaceSearchRequest 인터페이스

google.maps.places.PlaceSearchRequest 인터페이스

PlacesService로 전송할 장소 검색 쿼리입니다.

속성
`bounds optional`	유형: `LatLngBounds\|LatLngBoundsLiteral optional` 장소를 검색할 경계입니다. `bounds`가 설정된 경우 `location`와 `radius`가 모두 무시됩니다.
`keyword optional`	유형: `string optional` 이름, 유형, 주소를 포함하되 이에 국한되지 않는 모든 사용 가능한 필드와 고객 리뷰 및 기타 서드 파티 콘텐츠를 포함하여 일치시킬 용어입니다.
`language optional`	유형: `string optional` 이름과 주소를 반환해야 하는 언어의 언어 식별자(가능한 경우)입니다. 지원 언어 목록을 참조하세요.
`location optional`	유형: `LatLng\|LatLngLiteral optional` 장소를 검색할 위치의 주변 위치입니다.
`maxPriceLevel optional`	유형: `number optional` 지정된 가격 수준 이하의 장소로만 결과를 제한합니다. 올바른 값의 범위는 0(가장 저렴)~4(가장 비쌈)입니다. 지정된 경우 `minPrice` 이상이어야 합니다.
`minPriceLevel optional`	유형: `number optional` 지정된 가격대 이상의 장소로만 결과를 제한합니다. 올바른 값의 범위는 0(가장 저렴)~4(가장 비쌈)입니다. 지정된 경우 `maxPrice` 이하여야 합니다.
`name optional`	지원 중단됨: 대신 `keyword`를 사용하세요. 유형: `string optional` `keyword`와 같습니다. 이 필드의 값은 `keyword` 필드의 값과 결합되어 동일한 검색 문자열의 일부로 전달됩니다.
`openNow optional`	유형: `boolean optional` 현재 영업 중인 장소로만 결과를 제한합니다.
`radius optional`	유형: `number optional` 지정된 위치에서 장소를 검색할 수 있는 최대 거리(미터)입니다. 허용되는 최대 값은 50,000입니다.
`rankBy optional`	유형: `RankBy optional` 기본값: `RankBy.PROMINENCE` 결과를 반환할 때 사용할 순위 지정 방법을 지정합니다. `rankBy`가 `DISTANCE`로 설정된 경우 `location`를 지정해야 하지만 `radius` 또는 `bounds`는 지정할 수 없습니다.
`type optional`	유형: `string optional` 지정된 유형의 장소를 검색합니다. 유형은 요청의 타겟 위치의 현지 언어로 번역되어 쿼리 문자열로 사용됩니다. 쿼리도 제공되면 현지화된 유형 문자열에 연결됩니다. 다른 유형의 결과는 응답에서 삭제됩니다. 이 필드를 사용하여 언어 및 지역과 관계없는 카테고리 검색을 실행합니다. 유효한 유형은 여기에 나와 있습니다.

TextSearchRequest 인터페이스

google.maps.places.TextSearchRequest 인터페이스

PlacesService로 전송할 텍스트 검색 요청입니다.

속성
`bounds optional`	유형: `LatLngBounds\|LatLngBoundsLiteral optional` 장소를 검색할 때 결과에 편향성을 부여하는 데 사용되는 경계 (선택사항)입니다. `bounds`가 설정된 경우 `location`와 `radius`가 모두 무시됩니다. 결과는 이 경계 내의 결과로 제한되지 않지만 경계 내의 결과가 더 높은 순위로 표시됩니다.
`language optional`	유형: `string optional` 이름과 주소를 반환해야 하는 언어의 언어 식별자(가능한 경우)입니다. 지원 언어 목록을 참조하세요.
`location optional`	유형: `LatLng\|LatLngLiteral optional` 장소를 검색할 때 검색 결과에 편향성을 부여하는 데 사용되는 영역의 중심입니다.
`query optional`	유형: `string optional` 요청의 검색어입니다. 예를 들어 장소 이름 ('에펠탑'), 카테고리 뒤에 위치 이름 ('뉴욕의 피자')이 오는 경우 또는 장소 이름 뒤에 위치 구분자가 오는 경우 ('시드니의 스타벅스')
`radius optional`	유형: `number optional` 장소를 검색할 때 결과를 편향시키는 데 사용되는 영역의 반경(미터)입니다.
`region optional`	유형: `string optional` 결과에 편향성을 부여할 지역 코드입니다. 지역 코드는 ccTLD ('최상위 도메인') 2자리 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (`.co.uk`)이지만 ISO 3166-1 코드는 'gb'입니다(기술적으로 '영국과 북아일랜드의 합중국'의 항목에 해당).
`type optional`	유형: `string optional` 지정된 유형의 장소를 검색합니다. 유형은 요청의 타겟 위치의 현지 언어로 번역되어 쿼리 문자열로 사용됩니다. 쿼리도 제공되면 현지화된 유형 문자열에 연결됩니다. 다른 유형의 결과는 응답에서 삭제됩니다. 이 필드를 사용하여 언어 및 지역과 관계없는 카테고리 검색을 실행합니다. 유효한 유형은 여기에 나와 있습니다.

RankBy 상수

google.maps.places.RankBy 상수

PlaceSearchRequest의 순위 옵션입니다.

const {RankBy} = await google.maps.importLibrary("places")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

상수
`DISTANCE`	위치에서의 거리에 따라 장소 검색 결과를 순위 지정합니다.
`PROMINENCE`	명성을 기준으로 장소 검색 결과를 순위 지정합니다.

LocationBias typedef

google.maps.places.LocationBias typedef

LocationBias는 장소를 검색할 때 사용할 수 있는 유연한 경계 또는 힌트를 나타냅니다. 지정된 지역 외부의 결과가 표시될 수 있습니다. 현재 사용자의 IP 주소를 편향으로 사용하려면 문자열 "IP_BIAS"을 지정할 수 있습니다. 참고: Circle를 사용하는 경우 중심과 반지름을 정의해야 합니다.

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

LocationRestriction은 장소를 검색할 때 사용할 엄격한 경계를 나타냅니다.

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus 상수

google.maps.places.PlacesServiceStatus 상수

검색이 완료될 때 PlacesService에서 반환하는 상태입니다. 값으로 지정하거나 상수의 이름을 사용하여 지정합니다. 예를 들어 'OK' 또는 google.maps.places.PlacesServiceStatus.OK입니다.

const {PlacesServiceStatus} = await google.maps.importLibrary("places")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

상수
`INVALID_REQUEST`	이 요청이 잘못되었습니다.
`NOT_FOUND`	참조된 장소를 찾을 수 없습니다.
`OK`	응답에 유효한 결과가 포함되어 있습니다.
`OVER_QUERY_LIMIT`	애플리케이션이 요청 할당량을 초과했습니다.
`REQUEST_DENIED`	애플리케이션에서 `PlacesService`를 사용할 수 없습니다.
`UNKNOWN_ERROR`	서버 오류로 인해 `PlacesService` 요청을 처리할 수 없습니다. 다시 시도하면 요청이 성공할 수도 있습니다.
`ZERO_RESULTS`	이 요청에서 결과를 찾지 못했습니다.

PlaceSearchPagination 인터페이스

google.maps.places.PlaceSearchPagination 인터페이스

장소 결과의 추가 페이지를 가져오는 데 사용되는 객체입니다.

속성
`hasNextPage`	유형: `boolean` 추가 결과를 사용할 수 있는지 여부를 나타냅니다. 추가 결과 페이지가 있는 경우 `true`입니다.

메서드
`nextPage`	`nextPage()` 매개변수: 없음 반환 값: `void` 결과의 다음 페이지를 가져옵니다. 첫 번째 검색 요청에 제공된 것과 동일한 콜백 함수를 사용합니다.

PlaceResult 인터페이스

google.maps.places.PlaceResult 인터페이스

장소에 대한 정보를 정의합니다.

속성
`address_components optional`	유형: `Array<GeocoderAddressComponent> optional` 이 장소의 위치에 대한 주소 구성요소 모음입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`adr_address optional`	유형: `string optional` adr 마이크로포맷으로 표시된 장소의 주소입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`aspects optional`	유형: `Array<PlaceAspectRating> optional` Google 및 Zagat 사용자 리뷰를 기반으로 이 장소의 평점이 매겨집니다. 평점은 0~30점으로 매겨집니다.
`business_status optional`	유형: `BusinessStatus optional` 장소가 비즈니스인 경우 장소의 영업 상태를 나타내는 플래그입니다 (장소가 운영 중인지 또는 일시적으로 또는 영구적으로 폐업했는지 여부를 나타냅니다). 사용 가능한 데이터가 없으면 검색 또는 세부정보 응답에 플래그가 표시되지 않습니다.
`formatted_address optional`	유형: `string optional` 장소의 전체 주소입니다.
`formatted_phone_number optional`	유형: `string optional` 지역의 전화번호 규칙에 따라 형식이 지정된 장소의 전화번호입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`geometry optional`	유형: `PlaceGeometry optional` 장소의 도형 관련 정보입니다.
`html_attributions optional`	유형: `Array<string> optional` 이 장소 결과에 대해 표시할 저작자 표시 텍스트입니다. 사용 가능한 `html_attributions`는 요청된 `fields`에 관계없이 항상 반환되며 표시되어야 합니다.
`icon optional`	유형: `string optional` 이 장소의 카테고리를 나타내는 데 사용할 수 있는 이미지 리소스의 URL입니다.
`icon_background_color optional`	유형: `string optional` 장소 아이콘과 함께 사용할 배경 색상입니다. `PlaceResult.icon_mask_base_uri`을 참고하세요.
`icon_mask_base_uri optional`	유형: `string optional` 아이콘 마스크의 URL로, 일부가 잘립니다. 파일 확장자 (예: `.svg` 또는 `.png`)를 끝에 추가하여 다양한 아이콘 유형에 액세스합니다.
`international_phone_number optional`	유형: `string optional` 장소의 전화번호(국가 코드 포함 형식) 국제 형식에는 국가 코드가 포함되며 플러스(+) 기호가 접두사로 붙습니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`name optional`	유형: `string optional` 장소의 이름입니다. 참고: 사용자가 장소를 입력한 경우 이는 사용자가 입력한 원시 텍스트입니다. 악의적인 사용자가 이 데이터를 코드 삽입 공격의 벡터로 사용하려고 할 수 있으므로 이 데이터를 사용할 때는 주의하세요 ( http://en.wikipedia.org/wiki/Code_injection 참고).
`opening_hours optional`	유형: `PlaceOpeningHours optional` 장소의 개업 또는 폐업 시간을 정의합니다.
`permanently_closed optional`	지원 중단됨: `permanently_closed`는 2020년 5월부터 지원 중단되었으며 2021년 5월에 사용 중지됩니다. `permanently_closed`는 일시적 폐업과 영구적 폐업을 구분하지 않으므로 대신 `PlaceResult.business_status`를 사용하세요. 유형: `boolean optional` 장소가 영구적으로 폐쇄되었는지 또는 임시적으로 폐쇄되었는지를 나타내는 플래그입니다. 장소가 운영 중이거나 데이터를 사용할 수 없는 경우 응답에 플래그가 표시되지 않습니다.
`photos optional`	유형: `Array<PlacePhoto> optional` 이 장소의 사진 컬렉션에는 최대 10개의 `PlacePhoto` 객체가 포함됩니다.
`place_id optional`	유형: `string optional` 장소의 고유 식별자입니다.
`plus_code optional`	유형: `PlacePlusCode optional` 장소의 오픈 위치 코드 또는 '플러스 코드'를 정의합니다.
`price_level optional`	유형: `number optional` 장소의 가격 수준으로, 0~4의 척도로 표시됩니다. 가격 수준은 다음과 같이 해석됩니다. `0`: 무료 `1`: 저렴함 `2`: 보통 `3`: 비싸다 `4`: 매우 비쌈
`rating optional`	유형: `number optional` 이 장소에 대한 사용자 리뷰를 기반으로 한 평점(1.0~5.0)입니다.
`reviews optional`	유형: `Array<PlaceReview> optional` 이 장소에 대한 리뷰 목록입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`types optional`	유형: `Array<string> optional` 이 장소의 유형 배열입니다 (예: `["political", "locality"]` 또는 `["restaurant", "establishment"]`).
`url optional`	유형: `string optional` 이 장소에 대한 공식 Google 페이지의 URL입니다. 장소에 대한 최상의 정보가 포함된 Google 소유 페이지입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`user_ratings_total optional`	유형: `number optional` 이 장소의 `PlaceResult.rating`에 기여한 사용자 평점 수입니다.
`utc_offset optional`	지원 중단됨: 2019년 11월부터 `utc_offset`가 지원 중단되었습니다. 대신 `PlaceResult.utc_offset_minutes`를 사용하세요. https://goo.gle/js-open-now를 참고하세요. 유형: `number optional` 장소의 현재 시간대와 UTC의 오프셋(분)입니다. 예를 들어 일광 절약 시간 적용 중인 오스트레일리아 시드니는 UTC보다 11시간 빠르므로 `utc_offset`는 `660`입니다. UTC보다 뒤처진 시간대의 경우 오프셋은 음수입니다. 예를 들어 카보베르데의 경우 `utc_offset`은 `-60`입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`utc_offset_minutes optional`	유형: `number optional` 장소의 현재 시간대와 UTC의 오프셋(분)입니다. 예를 들어 일광 절약 시간 적용 중인 오스트레일리아 시드니는 UTC보다 11시간 빠르므로 `utc_offset_minutes`는 `660`입니다. UTC보다 뒤처진 시간대의 경우 오프셋은 음수입니다. 예를 들어 카보베르데의 경우 `utc_offset_minutes`은 `-60`입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`vicinity optional`	유형: `string optional` 도로명, 번지, 지역은 포함하되 주/도, 우편번호, 국가는 포함되지 않은 장소의 단순화된 주소입니다. 예를 들어 Google 오스트레일리아 시드니 사무실의 근접 값은 `"48 Pirrama Road, Pyrmont"`입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`website optional`	유형: `string optional` 비즈니스 홈페이지와 같이 이 장소의 신뢰할 수 있는 웹사이트입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.

PlaceAspectRating 인터페이스

google.maps.places.PlaceAspectRating 인터페이스

사용자가 리뷰한 장소의 특성에 관한 정보를 정의합니다.

속성
`rating`	유형: `number` 이 측면의 평점입니다. 개별 리뷰의 경우 0~3 사이의 정수입니다. 장소의 집계된 평점의 경우 0~30 사이의 정수입니다.
`type`	유형: `string` 관점 유형입니다. 예를 들면 `"food"`, `"decor"`, `"service"`, `"overall"`입니다.

BusinessStatus 상수

google.maps.places.BusinessStatus 상수

장소의 영업 상태(비즈니스인 경우)로, PlaceResult에 반환됩니다(장소가 운영 중인지 또는 일시적으로 또는 영구적으로 폐업했는지 여부를 나타냅니다). 값 또는 상수의 이름 (예: 'OPERATIONAL' 또는 google.maps.places.BusinessStatus.OPERATIONAL)으로 지정합니다.

const {BusinessStatus} = await google.maps.importLibrary("places")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

상수
`CLOSED_PERMANENTLY`	비즈니스가 폐업했습니다.
`CLOSED_TEMPORARILY`	비즈니스가 임시 휴업 중입니다.
`OPERATIONAL`	비즈니스가 정상적으로 운영되고 있습니다.

PlaceGeometry 인터페이스

google.maps.places.PlaceGeometry 인터페이스

장소의 도형에 관한 정보를 정의합니다.

속성
`location optional`	유형: `LatLng optional` 장소의 위치입니다.
`viewport optional`	유형: `LatLngBounds optional` 지도에 이 장소를 표시할 때 기본 표시 영역입니다. 장소의 기본 뷰포트가 알려지지 않은 경우 이 속성은 `null`입니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.

PlaceOpeningHours 인터페이스

google.maps.places.PlaceOpeningHours 인터페이스

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

속성
`open_now optional`	지원 중단됨: 2019년 11월부터 `open_now`가 지원 중단되었습니다. 대신 `PlacesService.getDetails` 결과의 `PlaceOpeningHours.isOpen` 메서드를 사용하세요. https://goo.gle/js-open-now를 참고하세요. 유형: `boolean optional` 장소가 현재 영업 중인지 여부입니다.
`periods optional`	유형: `Array<PlaceOpeningHoursPeriod> optional` 일요일부터 시작하여 요일별 영업 시간을 시간순으로 나타냅니다. 장소가 영업하지 않는 날은 포함되지 않습니다. `PlacesService.getDetails`에서만 사용할 수 있습니다.
`weekday_text optional`	유형: `Array<string> optional` 각 요일의 형식이 지정된 영업시간을 나타내는 일곱 개 문자열의 배열입니다. Place Service는 현재 언어에 맞게 영업시간의 형식을 지정하고 현지화합니다. 이 배열에서 요소의 순서는 언어에 따라 다릅니다. 일부 언어는 월요일에 한 주를 시작하고 다른 언어는 일요일에 시작합니다. `PlacesService.getDetails`에서만 사용할 수 있습니다. 다른 호출은 빈 배열을 반환할 수 있습니다.

메서드
`isOpen`	`isOpen([date])` 매개변수: `date`: `Date optional` 반환 값: `boolean\|undefined` 날짜가 지났는지 여부에 따라 장소가 현재 영업 중인지 또는 지정된 날짜에 영업 중인지 확인합니다. 이 장소에 `PlaceResult.utc_offset_minutes` 또는 `PlaceOpeningHours.periods`가 없으면 `undefined`가 반환됩니다 (`PlaceOpeningHours.periods`는 `PlacesService.getDetails`를 통해서만 사용할 수 있음). 이 메서드는 공휴일 시간과 같은 예외적인 시간을 고려하지 않습니다.

메서드

isOpen

isOpen([date])

매개변수:

date: Date optional

반환 값: boolean|undefined

날짜가 지났는지 여부에 따라 장소가 현재 영업 중인지 또는 지정된 날짜에 영업 중인지 확인합니다. 이 장소에 PlaceResult.utc_offset_minutes 또는 PlaceOpeningHours.periods가 없으면 undefined가 반환됩니다 (PlaceOpeningHours.periods는 PlacesService.getDetails를 통해서만 사용할 수 있음). 이 메서드는 공휴일 시간과 같은 예외적인 시간을 고려하지 않습니다.

PlaceOpeningHoursPeriod 인터페이스

google.maps.places.PlaceOpeningHoursPeriod 인터페이스

장소의 영업시간에 관한 구조화된 정보를 정의합니다. 참고: 장소가 항상 열려 있는 경우 응답에서 close 섹션이 누락됩니다. 클라이언트는 항상 열려 있음을 값이 0인 day, 값이 "0000"인 time, close 없음으로 표시된 open 기간으로 표현할 수 있습니다.

속성
`open`	유형: `PlaceOpeningHoursTime` 장소의 영업 시작 시간입니다.
`close optional`	유형: `PlaceOpeningHoursTime optional` 장소의 폐쇄 시간입니다.

PlaceOpeningHoursTime 인터페이스

google.maps.places.PlaceOpeningHoursTime 인터페이스

장소의 개업 또는 폐업 시간을 정의합니다.

속성
`day`	유형: `number` 일요일부터 시작하는 [`0`, `6`] 범위의 숫자로 된 요일입니다. 예를 들어 `2`은 화요일을 의미합니다.
`hours`	유형: `number` `PlaceOpeningHoursTime.time`의 시간으로, [`0`, `23`] 범위의 숫자입니다. 장소의 시간대로 보고됩니다.
`minutes`	유형: `number` `PlaceOpeningHoursTime.time`의 분으로 [`0`, `59`] 범위의 숫자입니다. 장소의 시간대로 보고됩니다.
`time`	유형: `string` 24시간 'hhmm' 형식의 시간입니다. 값은 [`"0000"`, `"2359"`] 범위입니다. 시간은 장소의 시간대로 보고됩니다.
`nextDate optional`	유형: `number optional` 이 PlaceOpeningHoursTime의 다음 발생을 나타내는 타임스탬프 (에포크 이후 밀리초 단위로 표시됨, `new Date()`와 함께 사용하기에 적합)입니다. 주 `PlaceOpeningHoursTime.day`, `PlaceOpeningHoursTime.time`, `PlaceResult.utc_offset_minutes`에서 계산됩니다. `PlaceResult.utc_offset_minutes`이 `undefined`이면 `nextDate`은 `undefined`입니다.

PlacePlusCode 인터페이스

google.maps.places.PlacePlusCode 인터페이스

장소의 오픈 위치 코드 또는 '플러스 코드'를 정의합니다. Plus Code는 상세 주소가 없는 (건물에 번호가 지정되지 않거나 거리 이름이 없는) 장소의 상세 주소 대신 사용할 수 있습니다.

속성
`global_code`	유형: `string` 1/8000도x1/8000도 영역의 플러스 코드입니다. 예를 들면 `"8FVC9G8F+5W"`입니다.
`compound_code optional`	유형: `string optional` 1/8000도 x 1/8000도 면적의 플러스 코드로, 앞의 네 글자 (지역 코드)가 삭제되고 지역 설명으로 대체됩니다. 예를 들면 `"9G8F+5W Zurich, Switzerland"`입니다. 코드를 줄이기 위해 적절한 지역을 찾을 수 없는 경우 이 필드는 생략됩니다.

PlacePhoto 인터페이스

google.maps.places.PlacePhoto 인터페이스

장소의 사진 요소를 나타냅니다.

속성
`height`	유형: `number` 사진의 높이(픽셀)입니다.
`html_attributions`	유형: `Array<string>` 이 사진에 표시할 저작자 표시 텍스트입니다.
`width`	유형: `number` 사진의 너비(픽셀)입니다.

메서드
`getUrl`	`getUrl([opts])` 매개변수: `opts`: `PhotoOptions optional` 반환 값: `string` 지정된 옵션에 해당하는 이미지 URL을 반환합니다.

PhotoOptions 인터페이스

google.maps.places.PhotoOptions 인터페이스

사진 요청 옵션을 정의합니다.

속성
`maxHeight optional`	유형: `number optional` 반환된 이미지의 최대 높이(픽셀)입니다.
`maxWidth optional`	유형: `number optional` 반환된 이미지의 최대 너비(픽셀)입니다.

PlaceReview 인터페이스

google.maps.places.PlaceReview 인터페이스

장소에 대한 단일 리뷰를 나타냅니다.

속성
`author_name`	유형: `string` 리뷰 작성자의 이름입니다.
`language`	유형: `string` 이 리뷰가 작성된 언어를 나타내는 IETF 언어 코드입니다. 이 코드에는 국가나 지역을 나타내는 보조 태그 없이 기본 언어 태그만 포함됩니다. 예를 들어 모든 영어 리뷰는 'en-AU'나 'en-UK'가 아닌 `'en'`로 태그가 지정됩니다.
`profile_photo_url`	유형: `string` 리뷰 작성자의 프로필 이미지 URL입니다.
`relative_time_description`	유형: `string` 언어 및 국가에 적합한 형식으로 현재 시간과 관련된 리뷰 시간을 나타내는 형식 지정된 최근 시간 문자열입니다. 예를 들면 `"a month ago"`입니다.
`text`	유형: `string` 리뷰 텍스트입니다.
`time`	유형: `number` 리뷰의 타임스탬프로 에포크 이후 초 단위로 표시됩니다.
`aspects optional`	지원 중단됨: 이 필드는 더 이상 사용할 수 없습니다. 유형: `Array<PlaceAspectRating> optional` 리뷰에서 평가한 측면입니다. 0~3점의 평가입니다.
`author_url optional`	유형: `string optional` 리뷰 작성자의 프로필 URL입니다. 검토자의 프로필을 사용할 수 없는 경우 `undefined`입니다.
`rating optional`	유형: `number optional` 이 리뷰의 평점으로, 1.0~5.0 사이의 숫자입니다 (양 끝값 포함).