Place (beta)

Place 클래스

google.maps.places.Place 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {Place} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

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

정적 메서드
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'를 반환합니다.
icon	유형: string optional 이 위치의 카테고리를 나타내는 데 사용할 수 있는 이미지 리소스의 URL입니다.
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	유형: number optional 장소의 가격 수준(0~4등급) 가격 수준은 다음과 같이 해석됩니다. 0: 무료 1: 저렴함 2: 보통 3: 비쌈 4: 매우 비쌈
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"]).
userRatingsCount	유형: 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	fetchFields(options) 매개변수: options:  FetchFieldsRequest 반환 값: Promise<{place:Place}>
getNextOpeningTime	getNextOpeningTime([date]) 매개변수: date:  Date optional 반환 값: Promise<Date optional> 다음 OpeningHoursTime을 나타내는 타임스탬프(에포크 이후의 경과 시간(밀리초)를 계산합니다. new Date(). 결과를 계산하기에 데이터가 충분하지 않거나 이 장소가 운영 불가능한 경우 undefined를 반환합니다.
isOpen	isOpen([date]) 매개변수: date:  Date optional 기본값은 현재입니다. 반환 값: Promise<boolean optional> 지정된 시간에 영업하는 장소인지 확인합니다. 해당 위치의 알려진 데이터가 이를 계산하기에 부족한 경우(예: 영업시간이 등록되지 않은 경우) undefined로 해결됩니다.

PlaceOptions 인터페이스

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

참고: v=beta 채널에서만 사용할 수 있습니다.

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

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

AddressComponent 클래스

google.maps.places.AddressComponent 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {AddressComponent} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

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

Attribution 클래스

google.maps.places.Attribution 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {Attribution} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

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

FetchFieldsRequest 인터페이스

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

참고: v=beta 채널에서만 사용할 수 있습니다.

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

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

OpeningHours 클래스

google.maps.places.OpeningHours 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {OpeningHours} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

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

OpeningHoursPeriod 클래스

google.maps.places.OpeningHoursPeriod 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {OpeningHoursPeriod} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

속성
close	유형: OpeningHoursPoint optional 장소의 영업 종료 시간입니다.
open	유형: OpeningHoursPoint 장소의 개점 시간입니다.

OpeningHoursPoint 클래스

google.maps.places.OpeningHoursPoint 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {OpeningHoursPoint} = await google.map.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 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {Photo} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

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

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

PhotoAttribution 클래스

google.maps.places.PhotoAttribution 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {PhotoAttribution} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

속성
author	유형: string 이 사진 결과에 표시될 저작자 표시 텍스트입니다.
authorURI	유형: string optional

PlusCode 클래스

google.maps.places.PlusCode 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {PlusCode} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

속성
compoundCode	유형: string optional 처음 4자 (지역 번호)를 삭제하고 지역 설명으로 대체하는 1도의 1/8000도에 1/8000도인 플러스 코드 예: '9G8F+5W Zurich, Switzerland'
globalCode	유형: string optional 1도의 1/8000도 및 1도 8000도의 플러스 코드입니다. 예: '8FVC9G8F+5W'

Review 클래스

google.maps.places.Review 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {Review} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

속성
author	유형: string optional 리뷰 작성자의 이름입니다.
authorPhotoURI	유형: string optional 수정자의 프로필 이미지 URL입니다.
authorURI	유형: string optional 리뷰 작성자의 프로필 URL입니다.
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' 태그가 지정됩니다.