Place 클래스
google.maps.places.Place
클래스
const {Place} = await google.maps.importLibrary("places")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
---|---|
Place |
Place(options) 매개변수:
|
정적 메서드 | |
---|---|
|
findPlaceFromPhoneNumber(request) 매개변수:
지정된 전화번호를 기반으로 장소를 검색합니다. 드물지만 여러 장소에서 전화번호를 공유할 수 있으므로 배열을 반환합니다. |
|
findPlaceFromQuery(request) 매개변수:
지정된 텍스트 쿼리를 기반으로 장소를 검색합니다. 쿼리가 약간 모호하고 둘 이상의 장소가 반환되는 경우 배열을 반환합니다. 이 메서드는 여러 개의 결과가 예상되는 검색에는 적합하지 않습니다. |
|
searchByText(request) 매개변수:
텍스트 쿼리 기반 장소 검색 |
속성 | |
---|---|
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'를 반환합니다. |
|
유형:
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 |
이 장소의 사진입니다. 컬렉션에는 최대 10개의 Photo 객체가 포함됩니다. |
plusCode |
유형:
PlusCode optional |
priceLevel |
유형:
PriceLevel optional 장소의 가격 수준입니다. 이 속성은 다음 값 중 하나를 반환할 수 있습니다.
|
rating |
유형:
number optional 이 장소에 대한 사용자 리뷰를 기반으로 한 1.0~5.0의 평점입니다. |
requestedLanguage |
유형:
string optional 이 장소에 대해 요청된 언어입니다. |
requestedRegion |
유형:
string optional 이 장소에 대해 요청된 지역입니다. |
reviews |
이 장소의 리뷰 목록입니다. |
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 |
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(options) 매개변수:
|
|
getNextOpeningTime([date]) 매개변수:
다음 OpeningHoursTime을 나타내는 날짜를 계산합니다. 데이터가 결과를 계산하기에 충분하지 않거나 이 장소가 운영되지 않는 경우 undefined를 반환합니다. |
|
isOpen([date]) 매개변수:
반환 값:
Promise<boolean optional> 지정된 날짜/시간에 장소가 영업 중인지 확인합니다. 영업시간이 등록되지 않은 경우와 같이 위치에 관해 알려진 데이터가 이를 계산하기에 충분하지 않으면 undefined 를 사용하여 해결합니다. |
toJSON |
toJSON() 매개변수: 없음
반환 값: 요청된 모든 장소 속성이 포함된 JSON 객체를
Object 합니다. |
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' (기술적으로 '영국 및 북아일랜드'의 엔티티)입니다. |
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개의 문자열 배열입니다. Places Service는 현재 언어에 맞게 영업시간의 형식을 지정하고 현지화합니다. 이 배열에서 요소의 순서는 언어에 따라 다릅니다. 일부 언어에서는 월요일에 한 주를 시작하고 다른 언어에서는 일요일에 시작합니다. |
OpeningHoursPeriod 클래스
google.maps.places.OpeningHoursPeriod
클래스
const {OpeningHoursPeriod} = await google.maps.importLibrary("places")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
속성 | |
---|---|
close |
유형:
OpeningHoursPoint optional 장소의 폐점 시간입니다. |
open |
장소의 개점 시간입니다. |
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]) 매개변수:
반환 값:
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/8,000, 도 영역의 1/8,000을 나타내는 플러스 코드. 여기서 첫 4자 (지역 번호)가 삭제되고 지역 설명으로 대체됩니다. 예: '9G8F+5W 스위스 취리히' |
globalCode |
유형:
string optional 면적의 1/8000x1/8000의 1/8,000도인 플러스 코드입니다. 예: '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 형식이 지정된 최근 시간의 문자열로, 현재 시간을 기준으로 한 리뷰 시간을 언어 및 국가에 적합한 형식으로 표현합니다. 예: '1개월 전'). |
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 |
SearchByTextRequest 인터페이스
google.maps.places.SearchByTextRequest
인터페이스
의 요청 인터페이스입니다.Place.searchByText
속성 | |
---|---|
fields |
유형:
Array<string> 응답에 포함될 필드이며, 청구됩니다. ['ALL'] 가 전달되면 사용 가능한 모든 필드가 반환되고 요금이 청구됩니다 (프로덕션 배포의 경우 권장되지 않음). 필드 목록은 PlaceResult 를 참고하세요. 중첩 필드는 점 경로를 사용하여 지정할 수 있습니다 (예: "geometry.location" ). |
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, 0.5, 1.0, ... , 5.0] 포함)에서 0과 5 사이의 부동 소수점이어야 합니다. 입력 평점은 가장 가까운 0.5(최대)로 반올림됩니다. 예를 들어 평점이 0.6이면 평점이 1.0 미만인 모든 결과는 제외됩니다. |
priceLevels optional |
유형:
Array<PriceLevel> optional 특정 가격 수준으로 표시된 장소로 검색을 제한하는 데 사용됩니다. 모든 가격 수준의 조합을 선택할 수 있습니다. 기본값은 모든 가격 수준입니다. |
|
유형:
string optional |
rankBy optional |
유형:
SearchByTextRankBy optional 기본값:
SearchByTextRankBy.DISTANCE 응답에서 결과의 순위가 지정되는 방식입니다. |
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로 설정하면 동일한 유형의 결과만 반환됩니다. |
SearchByTextRankBy 상수
google.maps.places.SearchByTextRankBy
상수
SearchByTextRequest의 RankBy 열거형입니다.
const {SearchByTextRankBy} = await google.maps.importLibrary("places")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
---|---|
DISTANCE |
거리를 기준으로 결과의 순위를 매깁니다. |
RELEVANCE |
관련성을 기준으로 결과의 순위를 매깁니다. |