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

Place (beta)

Place 클래스

google.maps.places.Place 클래스

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

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

정적 메서드
`findPlaceFromPhoneNumber`	참고: v=beta 채널에서만 사용할 수 있습니다. `findPlaceFromPhoneNumber(request)` 매개변수: `request`: `FindPlaceFromPhoneNumberRequest` 전화번호 및 요청된 필드가 포함된 요청 반환 값: `Promise<{places:Array<Place>}>` 지정된 전화번호를 기준으로 장소를 검색합니다. 드물지만 여러 장소가 하나의 전화번호를 공유할 수 있는 경우 배열을 반환합니다.
`findPlaceFromQuery`	참고: v=beta 채널에서만 사용할 수 있습니다. `findPlaceFromQuery(request)` 매개변수: `request`: `FindPlaceFromQueryRequest` 텍스트 쿼리 및 요청된 필드가 포함된 요청입니다. 반환 값: `Promise<{places:Array<Place>}>` 지정된 텍스트 쿼리를 기반으로 장소를 검색합니다. 쿼리가 약간 모호하고 두 개 이상의 장소가 반환되는 경우 배열을 반환합니다. 이 방법은 여러 결과가 예상되는 검색에는 적합하지 않습니다.

정적 메서드

findPlaceFromPhoneNumber

findPlaceFromPhoneNumber(request)

매개변수:

request: FindPlaceFromPhoneNumberRequest 전화번호 및 요청된 필드가 포함된 요청

반환 값: Promise<{places:Array<Place>}>

지정된 전화번호를 기준으로 장소를 검색합니다. 드물지만 여러 장소가 하나의 전화번호를 공유할 수 있는 경우 배열을 반환합니다.

findPlaceFromQuery

findPlaceFromQuery(request)

매개변수:

request: FindPlaceFromQueryRequest 텍스트 쿼리 및 요청된 필드가 포함된 요청입니다.

반환 값: Promise<{places:Array<Place>}>

지정된 텍스트 쿼리를 기반으로 장소를 검색합니다. 쿼리가 약간 모호하고 두 개 이상의 장소가 반환되는 경우 배열을 반환합니다. 이 방법은 여러 결과가 예상되는 검색에는 적합하지 않습니다.

속성
`addressComponents`	유형: `Array<AddressComponent> optional` 이 장소의 위치에 대한 주소 구성요소 모음입니다. 알려진 주소 데이터가 없는 경우 객체가 비어 있습니다. 서버에서 주소 데이터가 호출되지 않은 경우 `undefined`.
`adrFormatAddress`	유형: `string optional` 장소의 주소를 adr microformat으로 나타냅니다.
`attributions`	유형: `Array<Attribution> optional` 이 장소 결과에 표시될 저작자 표시 텍스트.
`businessStatus`	유형: `BusinessStatus optional` 위치의 영업 상태입니다. `null`: 알려진 상태가 없는 경우 서버에서 상태 데이터가 로드되지 않은 경우 `undefined`
`displayName`	유형: `string optional` 위치의 표시 이름입니다. 이름이 없으면 `null`입니다. 서버에서 이름 데이터가 로드되지 않은 경우 `undefined`
`formattedAddress`	유형: `string optional` 위치의 전체 주소입니다.
`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'를 반환합니다.
`hasTakeout`	유형: `boolean optional` 테이크아웃 가능 여부 값이 알려진 경우 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`hasWheelchairAccessibleEntrance`	유형: `boolean optional` 장소에 휠체어 이용 가능 입구가 있는지 여부입니다. 값이 알려진 경우 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`iconBackgroundColor`	유형: `string optional` 장소 카테고리의 기본 16진수 색상 코드입니다.
`id`	유형: `string` 고유한 장소 ID입니다.
`internationalPhoneNumber`	유형: `string optional` 국가 코드 포함 형식의 전화번호입니다. 국제 형식에는 국가 코드가 포함되며 플러스(+) 기호가 접두사로 붙습니다.
`isReservable`	유형: `boolean optional` 장소를 예약할 수 있는지 여부입니다. 값이 알려진 경우 'true' 또는 'false'를 반환합니다. 값을 알 수 없는 경우 'null'을 반환합니다. 이 필드가 아직 요청되지 않은 경우 'undefined'를 반환합니다.
`location`	유형: `LatLng optional` 장소의 위치입니다.
`nationalPhoneNumber`	유형: `string optional` 전화번호의 지역 규칙에 따라 형식이 지정된 지역 정보의 전화번호
`openingHours`	유형: `OpeningHours optional`
`photos`	유형: `Array<Photo> optional` 이 장소의 사진입니다. 컬렉션에는 최대 10개의 `Photo` 객체가 포함됩니다.
`plusCode`	유형: `PlusCode optional`
`priceLevel`	유형: `PriceLevel optional` 장소의 가격 수준입니다. 이 속성은 다음 값 중 하나를 반환할 수 있습니다. `Free` `Inexpensive` `Moderate` `Expensive` `Very Expensive`
`rating`	유형: `number optional` 이 장소의 사용자 리뷰를 기준으로 한 평점(1.0~5.0).
`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'를 반환합니다.
`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` 비즈니스 홈페이지와 같은 이 장소의 공식 웹사이트

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

PlaceOptions 인터페이스

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

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

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

AddressComponent 클래스

google.maps.places.AddressComponent 클래스

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

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

Attribution 클래스

google.maps.places.Attribution 클래스

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

속성
`provider`	유형: `string optional` 이 장소 결과에 표시될 저작자 표시 텍스트.
`providerURI`	유형: `string optional`

FetchFieldsRequest 인터페이스

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

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

속성
`fields`	유형: `Array<string>` 가져올 필드의 목록입니다.
`sessionToken optional`	유형: `AutocompleteSessionToken optional` 세부정보 요청을 자동 완성 세션과 함께 번들로 묶는 데 사용되는 고유 참조입니다.

OpeningHours 클래스

google.maps.places.OpeningHours 클래스

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

속성
`periods`	유형: `Array<OpeningHoursPeriod>` 한 주의 시작 요일을 일요일부터 시작하여 순서대로 나열하세요. 장소가 영업 중이 아닌 날은 포함되지 않습니다.
`weekdayDescriptions`	유형: `Array<string>` 각 요일의 지정된 영업시간을 나타내는 7개의 문자열 배열입니다. 장소 서비스는 현재 언어에 맞게 영업시간의 형식을 지정하고 현지화합니다. 이 배열에서 요소의 순서는 언어에 따라 다릅니다. 월요일에 한 주를 시작하는 언어도 있고 일요일에 시작하는 언어도 있습니다.

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] 범위입니다. 이 정보는 장소의 시간대로 보고됩니다.

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을 반환합니다.

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입니다.

PlusCode 클래스

google.maps.places.PlusCode 클래스

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

속성
`compoundCode`	유형: `string optional` 1도의 1/8000도와 1/8000도 중 처음 4자 (지역 번호)는 삭제하고 지역 설명으로 대체하는 플러스 코드입니다. (예: '9G8F+5W 취리히, 스위스')
`globalCode`	유형: `string optional` 학위 1/8000의 1/8000번째 학위인 2016년도에 해당하는 플러스 코드입니다. 예: '8FVC9G8F+5W'

Review 클래스

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'`로 태그가 지정됩니다.

PriceLevel 상수

google.maps.places.PriceLevel 상수

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

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

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

Place (beta)

Place 클래스

생성자

정적 메서드

속성

방법

PlaceOptions 인터페이스

속성

AddressComponent 클래스

속성

Attribution 클래스

속성

FetchFieldsRequest 인터페이스

속성

OpeningHours 클래스

속성

OpeningHoursPeriod 클래스

속성

OpeningHoursPoint 클래스

속성

Photo 클래스

속성

방법

AuthorAttribution 클래스

속성

PlusCode 클래스

속성

Review 클래스

속성

PriceLevel 상수

상수