공지사항: 새로운 기본 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트, 현대화된 핀, 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

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

Place

장소 클래스

google.maps.places.Place 클래스

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

생성자
`Place`	`Place(options)` 매개변수: `options`: `PlaceOptions`

정적 메소드
`searchByText`	`searchByText(request)` 매개변수: `request`: `SearchByTextRequest` 반환 값: `Promise<{places:Array<Place>}>` 텍스트 쿼리 기반 장소 검색
`searchNearby`	`searchNearby(request)` 매개변수: `request`: `SearchNearbyRequest` 반환 값: `Promise<{places:Array<Place>}>` 주변 장소 검색

속성
`accessibilityOptions`	유형: `AccessibilityOptions optional` 이 장소의 접근성 옵션입니다. `undefined`: 서버에서 접근성 옵션 데이터를 호출하지 않은 경우
`addressComponents`	유형: `Array<AddressComponent> optional` 이 장소의 위치에 대한 주소 구성요소 모음입니다. 알려진 주소 데이터가 없는 경우 빈 객체입니다. 서버에서 주소 데이터를 호출하지 않은 경우 `undefined`입니다.
`adrFormatAddress`	유형: `string optional` adr 마이크로포맷으로 표시된 장소의 주소입니다.
`allowsDogs`	유형: `boolean optional`
`attributions`	유형: `Array<Attribution> optional` 이 장소 결과에 대해 표시할 저작자 표시 텍스트입니다.
`businessStatus`	유형: `BusinessStatus optional` 위치의 운영 상태입니다. 알려진 상태가 없는 경우 `null`입니다. `undefined`: 상태 데이터가 서버에서 로드되지 않은 경우
`displayName`	유형: `string optional` 위치의 표시 이름입니다. 이름이 없는 경우 `null`입니다. 이름 데이터가 서버에서 로드되지 않은 경우 `undefined`입니다.
`displayNameLanguageCode`	유형: `string optional` 위치의 표시 이름 언어입니다. 이름이 없는 경우 `null`입니다. 이름 데이터가 서버에서 로드되지 않은 경우 `undefined`입니다.
`editorialSummary`	유형: `string optional` 이 장소에 대한 편집 요약입니다. 편집자 요약이 없는 경우 `null`입니다. 이 필드가 아직 요청되지 않은 경우 `undefined`입니다.
`editorialSummaryLanguageCode`	유형: `string optional` 이 장소의 편집 요약 언어입니다. 편집자 요약이 없는 경우 `null`입니다. 이 필드가 아직 요청되지 않은 경우 `undefined`입니다.
`evChargeOptions`	유형: `EVChargeOptions optional` 장소에서 제공하는 전기자동차 충전 옵션입니다. 서버에서 EV 충전 옵션을 호출하지 않은 경우 `undefined`
`formattedAddress`	유형: `string optional` 위치의 전체 주소입니다.
`fuelOptions`	유형: `FuelOptions optional` 장소에서 제공하는 연료 옵션입니다. 서버에서 연료 옵션을 호출하지 않은 경우 `undefined`
`googleMapsURI`	유형: `string optional` 이 장소에 대한 공식 Google 페이지의 URL입니다. 장소에 대한 최상의 정보가 포함된 Google 소유 페이지입니다.
`hasCurbsidePickup`	유형: `boolean optional` 매장 밖 수령이 가능한지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`hasDelivery`	유형: `boolean optional` 장소에 배달 서비스가 있는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`hasDineIn`	유형: `boolean optional` 장소에 식사 공간이 있는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`hasLiveMusic`	유형: `boolean optional`
`hasMenuForChildren`	유형: `boolean optional`
`hasOutdoorSeating`	유형: `boolean optional`
`hasRestroom`	유형: `boolean optional`
`hasTakeout`	유형: `boolean optional` 음식점에 테이크아웃이 가능한지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`hasWiFi`	유형: `boolean optional`
`iconBackgroundColor`	유형: `string optional` 장소 카테고리의 기본 16진수 색상 코드입니다.
`id`	유형: `string` 고유한 장소 ID입니다.
`internationalPhoneNumber`	유형: `string optional` 장소의 전화번호(국가 코드 포함 형식) 국제 형식에는 국가 코드가 포함되며 플러스(+) 기호가 접두사로 붙습니다.
`isGoodForChildren`	유형: `boolean optional`
`isGoodForGroups`	유형: `boolean optional`
`isGoodForWatchingSports`	유형: `boolean optional`
`isReservable`	유형: `boolean optional` 장소를 예약할 수 있는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`location`	유형: `LatLng optional` 장소의 위치입니다.
`nationalPhoneNumber`	유형: `string optional` 지역의 전화번호 규칙에 따라 형식이 지정된 장소의 전화번호입니다.
`parkingOptions`	유형: `ParkingOptions optional` 장소에서 제공하는 주차 옵션입니다. 주차 옵션 데이터가 서버에서 호출되지 않은 경우 `undefined`입니다.
`paymentOptions`	유형: `PaymentOptions optional` 장소에서 제공하는 결제 옵션입니다. 서버에서 결제 옵션 데이터를 호출하지 않은 경우 `undefined`입니다.
`photos`	유형: `Array<Photo> optional` 이 장소의 사진 컬렉션에는 최대 10개의 `Photo` 객체가 포함됩니다.
`plusCode`	유형: `PlusCode optional`
`priceLevel`	유형: `PriceLevel optional` 장소의 가격 수준입니다. 이 속성은 다음 값 중 하나를 반환할 수 있습니다. `Free` `Inexpensive` `Moderate` `Expensive` `Very Expensive`
`primaryType`	유형: `string optional` 위치의 기본 유형입니다. 유형이 없는 경우 `null` `undefined`: 유형 데이터가 서버에서 로드되지 않은 경우
`primaryTypeDisplayName`	유형: `string optional` 위치의 기본 유형 표시 이름입니다. 유형이 없는 경우 `null` `undefined`: 유형 데이터가 서버에서 로드되지 않은 경우
`primaryTypeDisplayNameLanguageCode`	유형: `string optional` 위치의 기본 유형 표시 이름 언어입니다. 유형이 없는 경우 `null` `undefined`: 유형 데이터가 서버에서 로드되지 않은 경우
`rating`	유형: `number optional` 이 장소에 대한 사용자 리뷰를 기반으로 한 평점(1.0~5.0)입니다.
`regularOpeningHours`	유형: `OpeningHours optional`
`requestedLanguage`	유형: `string optional` 이 장소에 대해 요청된 언어입니다.
`requestedRegion`	유형: `string optional` 이 장소에 대해 요청된 지역입니다.
`reviews`	유형: `Array<Review> optional` 이 장소에 대한 리뷰 목록입니다.
`servesBeer`	유형: `boolean optional` 맥주를 판매하는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`servesBreakfast`	유형: `boolean optional` 조식을 제공하는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`servesBrunch`	유형: `boolean optional` 브런치를 제공하는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`servesCocktails`	유형: `boolean optional`
`servesCoffee`	유형: `boolean optional`
`servesDessert`	유형: `boolean optional`
`servesDinner`	유형: `boolean optional` 저녁 식사를 제공하는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`servesLunch`	유형: `boolean optional` 점심식사를 제공하는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`servesVegetarianFood`	유형: `boolean optional` 채식 음식을 판매하는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`servesWine`	유형: `boolean optional` 와인을 제공하는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`svgIconMaskURI`	유형: `string optional` 장소 카테고리를 나타내는 데 사용할 수 있는 svg 이미지 마스크 리소스의 URI입니다.
`types`	유형: `Array<string> optional` 이 장소의 유형 배열입니다 (예: `["political", "locality"]` 또는 `["restaurant", "establishment"]`).
`userRatingCount`	유형: `number optional` 이 장소의 `Place.rating`에 기여한 사용자 평점 수입니다.
`utcOffsetMinutes`	유형: `number optional` 장소의 현재 시간대와 UTC의 오프셋(분)입니다. 예를 들어 일광 절약 시간의 오스트레일리아 동부 표준시 (GMT+10)는 UTC보다 11시간 빠르므로 `utc_offset_minutes`은 `660`입니다. UTC보다 뒤처진 시간대의 경우 오프셋은 음수입니다. 예를 들어 카보베르데의 경우 `utc_offset_minutes`은 `-60`입니다.
`viewport`	유형: `LatLngBounds optional` 지도에 이 장소를 표시할 때 기본 표시 영역입니다.
`websiteURI`	유형: `string optional` 비즈니스 홈페이지와 같이 이 장소의 신뢰할 수 있는 웹사이트입니다.
`openingHours`	지원 중단됨: 대신 `Place.regularOpeningHours`를 사용하세요. 유형: `OpeningHours optional`

메서드
`fetchFields`	`fetchFields(options)` 매개변수: `options`: `FetchFieldsRequest` 반환 값: `Promise<{place:Place}>`
`getNextOpeningTime`	참고: v=beta 채널에서만 사용할 수 있습니다. `getNextOpeningTime([date])` 매개변수: `date`: `Date optional` 반환 값: `Promise<Date optional>` 다음 OpeningHoursTime을 나타내는 날짜를 계산합니다. 결과를 계산하기에 데이터가 충분하지 않거나 이 장소가 운영되지 않는 경우 정의되지 않은 값을 반환합니다.
`isOpen`	참고: v=beta 채널에서만 사용할 수 있습니다. `isOpen([date])` 매개변수: `date`: `Date optional` 현재로 기본 설정됩니다. 반환 값: `Promise<boolean optional>` 지정된 날짜/시간에 장소가 영업 중인지 확인합니다. 위치에 대한 알려진 데이터가 이를 계산하기에 충분하지 않은 경우(예: 영업시간이 등록되지 않은 경우) `undefined`로 확인됩니다.
`toJSON`	`toJSON()` 매개변수: 없음 반환 값: `Object` 요청된 모든 장소 속성이 포함된 JSON 객체입니다.

PlaceOptions 인터페이스

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

장소를 구성하기 위한 옵션입니다.

속성
`id`	유형: `string` 고유한 장소 ID입니다.
`requestedLanguage optional`	유형: `string optional` 세부정보를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
`requestedRegion optional`	유형: `string optional` 사용자의 지역 코드입니다. 이로 인해 반품될 사진과 기타 사항에 영향을 줄 수 있습니다. 지역 코드는 ccTLD ('최상위 도메인') 2자리 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (`.co.uk`)이지만 ISO 3166-1 코드는 'gb'입니다(기술적으로 '영국과 북아일랜드의 합중국'의 항목에 해당).

AccessibilityOptions 클래스

google.maps.places.AccessibilityOptions 클래스

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

속성
`hasWheelchairAccessibleEntrance`	유형: `boolean optional` 장소에 휠체어 진입로가 있는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`hasWheelchairAccessibleParking`	유형: `boolean optional` 장소에 휠체어 이용 가능 주차장이 있는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`hasWheelchairAccessibleRestroom`	유형: `boolean optional` 장소에 휠체어 이용 가능 화장실이 있는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`hasWheelchairAccessibleSeating`	유형: `boolean optional` 장소에 휠체어 이용 가능 좌석이 있는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.

AddressComponent 클래스

google.maps.places.AddressComponent 클래스

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

속성
`longText`	유형: `string optional` 주소 구성요소의 전체 텍스트입니다.
`shortText`	유형: `string optional` 지정된 주소 구성요소의 축약된 짧은 텍스트입니다.
`types`	유형: `Array<string>` 이 주소 구성요소의 유형을 나타내는 문자열 배열입니다. 유효한 유형 목록은 여기에서 확인할 수 있습니다.

기여 분석 클래스

google.maps.places.Attribution 클래스

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

속성
`provider`	유형: `string optional` 이 장소 결과에 대해 표시할 저작자 표시 텍스트입니다.
`providerURI`	유형: `string optional`

AuthorAttribution 클래스

google.maps.places.AuthorAttribution 클래스

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

속성
`displayName`	유형: `string` 이 결과의 작성자 이름입니다.
`photoURI`	유형: `string optional` 이 검색 결과의 저자 사진 URI입니다. 이 기능을 사용할 수 없는 경우도 있습니다.
`uri`	유형: `string optional` 이 검색 결과의 작성자 프로필 URI입니다.

ConnectorAggregation 클래스

google.maps.places.ConnectorAggregation 클래스

동일한 유형 및 동일한 충전 속도의 커넥터에 대해 집계된 전기자동차 충전 정보입니다.

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

속성
`availabilityLastUpdateTime`	유형: `Date optional` 이 집계의 커넥터 사용 가능 여부 정보가 마지막으로 업데이트된 시간입니다.
`availableCount`	유형: `number optional` 현재 이 집계에서 사용할 수 있는 커넥터 수입니다.
`count`	유형: `number` 이 집계의 커넥터 수입니다.
`maxChargeRateKw`	유형: `number` 집계의 각 커넥터의 정적 최대 충전 속도(kW)입니다.
`outOfServiceCount`	유형: `number optional` 현재 서비스가 중단된 이 집계의 커넥터 수입니다.
`type`	유형: `EVConnectorType optional` 이 집계의 커넥터 유형입니다.

EVChargeOptions 클래스

google.maps.places.EVChargeOptions 클래스

장소에 호스팅된 전기자동차 충전소에 대한 정보입니다.

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

속성
`connectorAggregations`	유형: `Array<ConnectorAggregation>` 동일한 유형 및 동일한 충전 속도의 커넥터가 포함된 EV 충전 커넥터 집계 목록입니다.
`connectorCount`	유형: `number` 이 충전소의 커넥터 수입니다. 일부 포트에는 커넥터가 여러 개 있지만 한 번에 한 대의 차량만 충전할 수 있으므로 커넥터 수가 동시에 충전할 수 있는 총 차량 수보다 많을 수 있습니다.

EVConnectorType 상수

google.maps.places.EVConnectorType 상수

전기자동차 충전 커넥터 유형

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

상수
`CCS_COMBO_1`	결합형 충전 시스템 (AC 및 DC) SAE Type-1 J-1772 커넥터를 기반으로 합니다.
`CCS_COMBO_2`	결합형 충전 시스템 (AC 및 DC) Type-2 Mennekes 커넥터를 기반으로 합니다.
`CHADEMO`	CHAdeMO 유형 커넥터
`J1772`	J1772 유형 1 커넥터
`OTHER`	기타 커넥터 유형
`TESLA`	일반 TESLA 커넥터입니다. 북미에서는 NACS이지만 다른 지역에서는 NACS가 아닐 수 있습니다 (예: CCS 콤보 2 (CCS2) 또는 GB/T). 이 값은 실제 커넥터 유형을 나타내는 것보다 Tesla 소유 충전소에서 Tesla 브랜드 차량을 충전할 수 있는 기능을 나타냅니다.
`TYPE_2`	IEC 62196 유형 2 커넥터 MENNEKES라고도 합니다.
`UNSPECIFIED_GB_T`	GB/T 유형은 중국의 GB/T 표준에 해당합니다. 이 유형은 모든 GB_T 유형을 다룹니다.
`UNSPECIFIED_WALL_OUTLET`	지정되지 않은 전원 콘센트

EVSearchOptions 인터페이스

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

장소 검색 요청에 지정할 수 있는 전기자동차 관련 옵션입니다.

속성
`connectorTypes optional`	유형: `Array<EVConnectorType> optional` 선호하는 EV 커넥터 유형 목록입니다. 나열된 커넥터 유형을 지원하지 않는 장소는 필터링됩니다.
`minimumChargingRateKw optional`	유형: `number optional` 필요한 최소 충전 속도(킬로와트)입니다. 충전 요금이 지정된 요금보다 낮은 장소는 필터링됩니다.

FetchFieldsRequest 인터페이스

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

장소 필드를 가져오는 옵션입니다.

속성
`fields`	유형: `Array<string>` 가져올 필드 목록입니다.

FuelOptions 클래스

google.maps.places.FuelOptions 클래스

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

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

속성
`fuelPrices`	유형: `Array<FuelPrice>` 이 충전소에 있는 각 유형의 휘발유 가격 목록으로, 휘발유 유형당 항목 1개가 표시됩니다.

FuelPrice 클래스

google.maps.places.FuelPrice 클래스

특정 유형의 휘발유 가격 정보입니다.

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

속성
`price`	유형: `Money optional` 연료 가격입니다.
`type`	유형: `FuelType optional` 연료 유형입니다.
`updateTime`	유형: `Date optional` 주유소 가격이 마지막으로 업데이트된 시간입니다.

FuelType 상수

google.maps.places.FuelType 상수

연료 유형입니다.

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

상수
`BIO_DIESEL`	바이오디젤
`DIESEL`	디젤 연료
`E80`	E 80.
`E85`	E 85.
`LPG`	LPG
`METHANE`	메탄
`MIDGRADE`	중급
`PREMIUM`	Premium
`REGULAR_UNLEADED`	일반 휘발유
`SP100`	SP 100
`SP91`	SP 91.
`SP91_E10`	SP 91 E10
`SP92`	SP 92
`SP95`	SP 95.
`SP95_E10`	SP95 E10
`SP98`	SP 98
`SP99`	SP 99.
`TRUCK_DIESEL`	트럭 디젤

Money 클래스

google.maps.places.Money 클래스

통화 유형과 함께 금액을 나타냅니다.

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

속성
`currencyCode`	유형: `string` ISO 4217에 정의된 3자리 통화 코드입니다.
`nanos`	유형: `number` 금액의 나노 (10^-9) 단위 숫자입니다.
`units`	유형: `number` 금액의 전체 단위입니다. 예를 들어 `Money.currencyCode`가 'USD'인 경우 단위 1개는 1달러(USD)입니다.

메서드
`toString`	`toString()` 매개변수: 없음 반환 값: `string` 금액을 통화 기호와 함께 사람이 읽을 수 있는 표현으로 반환합니다.

OpeningHours 클래스

google.maps.places.OpeningHours 클래스

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

속성
`periods`	유형: `Array<OpeningHoursPeriod>` 일요일부터 일주일 동안의 영업 기간을 시간순으로 나타냅니다. 장소가 문을 닫은 날은 포함되지 않습니다.
`weekdayDescriptions`	유형: `Array<string>` 각 요일의 형식이 지정된 영업시간을 나타내는 일곱 개 문자열의 배열입니다. Place Service는 현재 언어에 맞게 영업시간의 형식을 지정하고 현지화합니다. 이 배열에서 요소의 순서는 언어에 따라 다릅니다. 일부 언어에서는 월요일에 한 주를 시작하고 다른 언어에서는 일요일에 시작합니다.

속성

periods

유형: Array<OpeningHoursPeriod>

일요일부터 일주일 동안의 영업 기간을 시간순으로 나타냅니다. 장소가 문을 닫은 날은 포함되지 않습니다.

weekdayDescriptions

유형: Array<string>

각 요일의 형식이 지정된 영업시간을 나타내는 일곱 개 문자열의 배열입니다. Place Service는 현재 언어에 맞게 영업시간의 형식을 지정하고 현지화합니다. 이 배열에서 요소의 순서는 언어에 따라 다릅니다. 일부 언어에서는 월요일에 한 주를 시작하고 다른 언어에서는 일요일에 시작합니다.

OpeningHoursPeriod 클래스

google.maps.places.OpeningHoursPeriod 클래스

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

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

OpeningHoursPoint 클래스

google.maps.places.OpeningHoursPoint 클래스

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

속성
`day`	유형: `number` 일요일부터 시작하는 [0, 6] 범위의 숫자로 된 요일입니다. 예를 들어, 2는 화요일을 의미합니다.
`hour`	유형: `number` OpeningHoursPoint.time의 시간을 숫자로 나타냅니다(범위: [0, 23]). 이는 장소의 시간대로 보고됩니다.
`minute`	유형: `number` OpeningHoursPoint.time의 분을 숫자로 표현한 것으로, [0, 59] 범위에 속합니다. 이는 장소의 시간대로 보고됩니다.

ParkingOptions 클래스

google.maps.places.ParkingOptions 클래스

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

속성
`hasFreeGarageParking`	유형: `boolean optional` 장소에 무료 주차장이 있는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`hasFreeParkingLot`	유형: `boolean optional` 장소에 무료 주차장이 있는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`hasFreeStreetParking`	유형: `boolean optional` 장소에 무료 노상 주차장이 있는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`hasPaidGarageParking`	유형: `boolean optional` 장소에 유료 주차장이 있는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`hasPaidParkingLot`	유형: `boolean optional` 장소에 유료 주차장이 있는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`hasPaidStreetParking`	유형: `boolean optional` 장소에 유료 노상 주차장이 있는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`hasValetParking`	유형: `boolean optional` 발레파킹 서비스를 제공하는지 여부 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.

PaymentOptions 클래스

google.maps.places.PaymentOptions 클래스

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

속성
`acceptsCashOnly`	유형: `boolean optional` 현금으로만 결제가 가능한 장소인지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`acceptsCreditCards`	유형: `boolean optional` 장소에서 신용카드를 통한 결제를 허용하는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`acceptsDebitCards`	유형: `boolean optional` 장소에서 체크카드를 통한 결제를 허용하는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.
`acceptsNFC`	유형: `boolean optional` NFC를 통한 결제를 허용하는지 여부입니다. 값을 알고 있으면 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다.

Photo 클래스

google.maps.places.Photo 클래스

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

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

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

PlusCode 클래스

google.maps.places.PlusCode 클래스

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

속성
`compoundCode`	유형: `string optional` 1/8000도 x 1/8000도 면적의 플러스 코드로, 앞의 네 글자 (지역 코드)는 생략되고 지역 설명으로 대체됩니다. 예: '9G8F+5W Zurich, Switzerland'
`globalCode`	유형: `string optional` 1/8000도x1/8000도 면적의 Plus Code입니다. 예: '8FVC9G8F+5W'

PriceLevel 상수

google.maps.places.PriceLevel 상수

장소 객체의 가격 수준 enum입니다.

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

상수
`EXPENSIVE`
`FREE`
`INEXPENSIVE`
`MODERATE`
`VERY_EXPENSIVE`

수업 검토

google.maps.places.Review 클래스

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

속성
`authorAttribution`	유형: `AuthorAttribution optional` 검토자입니다.
`publishTime`	유형: `Date optional`
`rating`	유형: `number optional` 이 리뷰의 평점으로, 1.0~5.0 사이의 숫자입니다 (양 끝값 포함).
`relativePublishTimeDescription`	유형: `string optional` 언어 및 국가에 적합한 형식으로 현재 시간과 관련된 리뷰 시간을 나타내는 형식 지정된 최근 시간 문자열입니다. 예를 들어 '한 달 전'이라고 입력합니다.
`text`	유형: `string optional` 리뷰 텍스트입니다.
`textLanguageCode`	유형: `string optional` 이 리뷰가 작성된 언어를 나타내는 IETF 언어 코드입니다. 이 코드에는 국가나 지역을 나타내는 보조 태그 없이 기본 언어 태그만 포함됩니다. 예를 들어 모든 영어 리뷰는 'en-AU'나 'en-UK'가 아닌 `'en'`로 태그가 지정됩니다.

SearchByTextRequest 인터페이스

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

Place.searchByText의 인터페이스를 요청합니다.

속성
`fields`	유형: `Array<string>` 응답에 포함되고 요금이 청구되는 필드입니다. `['*']`가 전달되면 사용 가능한 모든 필드가 반환되고 청구됩니다 (프로덕션 배포의 경우 권장되지 않음). `Place` 클래스의 모든 속성을 필드로 요청할 수 있습니다.
`evSearchOptions optional`	유형: `EVSearchOptions optional` 장소 검색 요청에 지정할 수 있는 전기자동차 관련 옵션입니다.
`includedType optional`	유형: `string optional` 요청된 장소 유형입니다. 지원되는 유형의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types를 참고하세요. 포함된 유형은 하나만 지원됩니다. `SearchByTextRequest.useStrictTypeFiltering`를 참고하세요.
`isOpenNow optional`	유형: `boolean optional` 기본값: `false` 현재 영업 중인 장소로 검색을 제한하는 데 사용됩니다.
`language optional`	유형: `string optional` 장소 세부정보는 기본 언어(있는 경우)로 표시됩니다. 기본적으로 브라우저의 언어 환경설정으로 설정됩니다. 현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport
`locationBias optional`	유형: `LatLng\|LatLngLiteral\|LatLngBounds\|LatLngBoundsLiteral\|CircleLiteral\|Circle optional` 검색할 지역입니다. 이 위치는 편향 역할을 하므로 지정된 위치 주변의 결과가 반환될 수 있습니다. locationRestriction과 함께 설정할 수 없습니다.
`locationRestriction optional`	유형: `LatLngBounds\|LatLngBoundsLiteral optional` 검색할 지역입니다. 이 위치는 제한으로 작용하므로 지정된 위치 외부의 결과는 반환되지 않습니다. locationBias와 함께 설정할 수 없습니다.
`maxResultCount optional`	유형: `number optional` 반환할 결과의 최대 수입니다. 1~20 사이여야 합니다(양 끝값 포함).
`minRating optional`	유형: `number optional` 평균 사용자 평점이 이 한도보다 낮은 결과를 필터링합니다. 유효한 값은 0.5 주기당 0~5 사이의 부동 소수점 수여야 합니다 (0, 0.5, 1.0, ... , 5.0 포함). 입력 평점은 가장 가까운 0.5(상한선)로 올림됩니다. 예를 들어 평점이 0.6이면 평점이 1.0 미만인 모든 결과가 삭제됩니다.
`priceLevels optional`	유형: `Array<PriceLevel> optional` 특정 가격 수준으로 표시된 장소로 검색을 제한하는 데 사용됩니다. 가격 수준을 원하는 대로 조합하여 선택할 수 있습니다. 기본값은 모든 가격 수준입니다.
`query optional`	지원 중단됨: 대신 textQuery를 사용하세요. 유형: `string optional`
`rankBy optional`	지원 중단됨: 대신 rankPreference를 사용하세요. 참고: v=beta 채널에서만 사용할 수 있습니다. 유형: `SearchByTextRankPreference optional`
`rankPreference optional`	유형: `SearchByTextRankPreference optional` 기본값: `SearchByTextRankPreference.RELEVANCE` 응답에서 결과의 순위가 결정되는 방식입니다.
`region optional`	유형: `string optional` 요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다(해당하는 경우). 이 매개변수는 관련 법규에 따라 결과에 영향을 줄 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참고하세요. 현재 3자리 지역 코드는 지원되지 않습니다.
`textQuery optional`	유형: `string optional` 필수 항목입니다. 텍스트 검색을 위한 텍스트 검색어입니다.
`useStrictTypeFiltering optional`	유형: `boolean optional` 기본값: `false` `SearchByTextRequest.includedType`에 엄격한 유형 필터링을 설정하는 데 사용됩니다. true로 설정하면 동일한 유형의 결과만 반환됩니다.

SearchByTextRankPreference 상수

google.maps.places.SearchByTextRankPreference 상수

SearchByTextRequest의 RankPreference enum입니다.

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

상수
`DISTANCE`	거리를 기준으로 결과를 순위 지정합니다.
`RELEVANCE`	관련성을 기준으로 검색 결과를 순위 지정합니다.

SearchNearbyRequest 인터페이스

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

Place.searchNearby의 인터페이스를 요청합니다. 요청에 관한 자세한 내용은 Places API 참조를 참고하세요.

속성
`fields`	유형: `Array<string>` 응답에 포함되고 요금이 청구되는 필드입니다. `['*']`가 전달되면 사용 가능한 모든 필드가 반환되고 청구됩니다 (프로덕션 배포의 경우 권장되지 않음). `Place` 클래스의 모든 속성을 필드로 요청할 수 있습니다.
`locationRestriction`	유형: `Circle\|CircleLiteral` 중심과 반지름이 있는 원으로 지정된 검색 지역입니다. 지정된 위치 외부의 결과는 반환되지 않습니다.
`excludedPrimaryTypes optional`	유형: `Array<string> optional` 기본 장소 유형을 제외했습니다. 지원되는 유형의 전체 목록을 참고하세요. 장소에는 기본 유형이 하나만 있을 수 있습니다. 최대 50개의 유형을 지정할 수 있습니다. `included` 및 `excluded` 목록에 모두 동일한 유형을 지정하면 INVALID_ARGUMENT 오류가 반환됩니다.
`excludedTypes optional`	유형: `Array<string> optional` 제외된 장소 유형 지원되는 유형의 전체 목록을 참고하세요. 장소에는 여러 장소 유형이 있을 수 있습니다. 최대 50개의 유형을 지정할 수 있습니다. `included` 및 `excluded` 목록에 모두 동일한 유형을 지정하면 INVALID_ARGUMENT 오류가 반환됩니다.
`includedPrimaryTypes optional`	유형: `Array<string> optional` 기본 장소 유형을 포함했습니다. 지원되는 유형의 전체 목록을 참고하세요. 장소에는 기본 유형이 하나만 있을 수 있습니다. 최대 50개의 유형을 지정할 수 있습니다. `included` 및 `excluded` 목록에 모두 동일한 유형을 지정하면 INVALID_ARGUMENT 오류가 반환됩니다.
`includedTypes optional`	유형: `Array<string> optional` 포함된 장소 유형입니다. 지원되는 유형의 전체 목록을 참고하세요. 장소에는 여러 장소 유형이 있을 수 있습니다. 최대 50개의 유형을 지정할 수 있습니다. `included` 및 `excluded` 목록에 모두 동일한 유형을 지정하면 INVALID_ARGUMENT 오류가 반환됩니다.
`language optional`	유형: `string optional` 장소 세부정보는 기본 언어(있는 경우)로 표시됩니다. 기본적으로 브라우저의 언어 환경설정으로 설정됩니다. 현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport
`maxResultCount optional`	유형: `number optional` 반환할 결과의 최대 수입니다. 1~20 사이여야 합니다(양 끝값 포함).
`rankPreference optional`	유형: `SearchNearbyRankPreference optional` 기본값: `SearchNearbyRankPreference.DISTANCE` 응답에서 결과의 순위가 결정되는 방식입니다.
`region optional`	유형: `string optional` 요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다(해당하는 경우). 이 매개변수는 관련 법규에 따라 결과에 영향을 줄 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참고하세요. 현재 3자리 지역 코드는 지원되지 않습니다.

SearchNearbyRankPreference 상수

google.maps.places.SearchNearbyRankPreference 상수

SearchNearbyRequest의 RankPreference enum입니다.

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

상수
`DISTANCE`	거리를 기준으로 결과를 순위 지정합니다.
`POPULARITY`	인기도별로 검색 결과를 순위 지정합니다.