Place

Place 클래스

google.maps.places.Place 클래스

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

Place
Place(options)
매개변수: 
searchByText
searchByText(request)
매개변수: 
반환 값:  Promise<{places:Array<Place>}>
텍스트 쿼리 기반 장소 검색
searchNearby
searchNearby(request)
매개변수: 
반환 값:  Promise<{places:Array<Place>}>
주변 장소를 검색합니다.
accessibilityOptions
유형:  AccessibilityOptions optional
이 장소의 접근성 옵션입니다. 서버에서 접근성 옵션 데이터가 호출되지 않은 경우 undefined입니다.
addressComponents
유형:  Array<AddressComponent> optional
이 장소의 위치에 대한 주소 구성요소 컬렉션입니다. 알려진 주소 데이터가 없는 경우 빈 객체 undefined: 주소 데이터가 서버에서 호출되지 않은 경우
adrFormatAddress
유형:  string optional
장소의 주소를 adr microformat으로 표현한 것입니다.
allowsDogs
유형:  boolean optional
attributions
유형:  Array<Attribution> optional
이 장소 결과에 대해 표시될 저작자 표시 텍스트입니다.
businessStatus
유형:  BusinessStatus optional
위치의 운영 상태입니다. 알려진 상태가 없는 경우 null undefined: 상태 데이터가 서버에서 로드되지 않은 경우.
displayName
유형:  string optional
위치의 표시 이름입니다. 이름이 없으면 null undefined: 이름 데이터가 서버에서 로드되지 않은 경우.
editorialSummary
유형:  string optional
이 장소에 대한 편집 요약입니다. 편집 요약이 없는 경우 null입니다. 이 필드가 아직 요청되지 않은 경우 undefined입니다.
editorialSummaryLanguageCode
유형:  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'를 반환합니다.
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
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_minutes660입니다. UTC보다 뒤처진 시간대의 경우 오프셋이 음수입니다. 예를 들어 utc_offset_minutes는 카보베르데의 경우 -60입니다.
viewport
유형:  LatLngBounds optional
이 장소를 지도에 표시할 때 선호되는 표시 영역입니다.
websiteURI
유형:  string optional
이 장소의 신뢰할 수 있는 웹사이트입니다(예: 업체 홈페이지).
openingHours
유형:  OpeningHours optional
fetchFields
fetchFields(options)
매개변수: 
반환 값:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
매개변수: 
  • dateDate optional
반환 값:  Promise<Date optional>
다음 OpeningHoursTime을 나타내는 날짜를 계산합니다. 데이터가 결과를 계산하기에 충분하지 않거나 이 장소가 운영되지 않는 경우 정의되지 않음을 반환합니다.
BetaisOpen
isOpen([date])
매개변수: 
  • dateDate 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
사용자 지역의 지역 코드입니다. 이는 반환되는 사진 및 다른 항목에 영향을 줄 수 있습니다. 지역 코드에는 2자리 ccTLD ('최상위 도메인') 값이 허용됩니다. 대부분의 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>
이 주소 구성요소의 유형을 나타내는 문자열의 배열입니다. 유효한 유형 목록은 여기에서 확인할 수 있습니다.

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>
가져올 필드의 목록입니다.

OpeningHours 클래스를 사용합니다.

google.maps.places.OpeningHours 클래스

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

periods
일요일부터 각 요일을 나열한 시작 기간이며 시간순으로 표시됩니다. 장소가 영업하지 않는 날은 포함되지 않습니다.
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
[0, 23] 범위의 숫자로 표시된 OpeningHoursPoint.time의 시간입니다. 이는 장소의 시간대로 보고됩니다.
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
이 사진에 표시할 저작자 표시 텍스트입니다.
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/8000 도의 1/8000 도 영역의 1/8000 도의 플러스 코드. 여기서 첫 네 문자 (지역 번호)가 삭제되고 지역 설명으로 대체됩니다. 예: '9G8F+5W Zurich, Switzerland'
globalCode
유형:  string optional
1/8000 x 1/8000 도 영역의 1/8000 도 단위로 표시된 플러스 코드입니다. 예: '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>
응답에 포함할 필드로, 요금이 청구됩니다. ['*']가 전달되면 사용 가능한 모든 필드가 반환되고 요금이 청구됩니다 (프로덕션 배포에는 권장되지 않음). 필드 목록은 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
검색할 지역입니다. 이 위치는 지정된 위치를 둘러싼 결과가 반환될 수 있다는 의미로 바이어스 역할을 합니다. locationRestriction과 함께 설정할 수 없습니다.
locationRestriction 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
특정 가격 수준으로 표시된 장소로 검색을 제한하는 데 사용됩니다. 가격 수준의 조합을 선택할 수 있습니다. 기본값은 모든 가격 수준입니다.
query optional
유형:  string optional
BetarankBy optional
유형:  SearchByTextRankPreference optional
rankPreference optional
유형:  SearchByTextRankPreference optional
기본값: SearchByTextRankPreference.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로 설정하면 같은 유형의 결과만 반환됩니다.

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>
응답에 포함할 필드로, 요금이 청구됩니다. ['*']가 전달되면 사용 가능한 모든 필드가 반환되고 요금이 청구됩니다 (프로덕션 배포에는 권장되지 않음). 필드 목록은 PlaceResult를 참고하세요. 중첩 필드는 점 경로로 지정할 수 있습니다 (예: "geometry.location").
locationRestriction
중심과 반지름이 있는 원으로 지정되는 검색할 지역입니다. 지정된 위치를 벗어난 결과는 반환되지 않습니다.
excludedPrimaryTypes 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 인기도별로 검색 결과의 순위를 매깁니다.