PlacesService 클래스
google.maps.places.PlacesService
클래스
장소 검색 및 장소 세부정보 검색과 관련된 메서드를 포함합니다.
const {PlacesService} = await google.maps.importLibrary("places")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
---|---|
PlacesService |
PlacesService(attrContainer) 매개변수:
지정된 컨테이너에 저작자 표시를 렌더링하는 PlacesService 의 새 인스턴스를 만듭니다. |
메서드 | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) 매개변수:
반환 값: 없음
전화번호를 기반으로 장소 목록을 가져옵니다. 대부분의 경우 결과 목록에 항목이 하나만 있어야 하지만 요청이 모호한 경우에는 두 개 이상의 결과가 반환될 수 있습니다. 콜백에 전달되는 PlaceResult 은 전체 PlaceResult 의 하위 집합입니다. 앱은 PlacesService.getDetails 를 호출하고 원하는 장소의 PlaceResult.place_id 를 전달하여 각 장소에 대한 더 자세한 PlaceResult 를 가져올 수 있습니다. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) 매개변수:
반환 값: 없음
검색 문자열을 기반으로 장소 목록을 가져옵니다. 대부분의 경우 결과 목록에는 항목이 하나만 있어야 하지만, 요청이 모호하면 두 개 이상의 결과가 반환될 수 있습니다. 콜백에 전달되는 PlaceResult 은 전체 PlaceResult 의 하위 집합입니다. 앱은 PlacesService.getDetails 를 호출하고 원하는 장소의 PlaceResult.place_id 를 전달하여 각 장소에 대한 더 자세한 PlaceResult 를 가져올 수 있습니다. |
getDetails |
getDetails(request, callback) 매개변수:
반환 값: 없음
지정된 placeId 로 식별된 장소에 대한 세부정보를 가져옵니다. |
nearbySearch |
nearbySearch(request, callback) 매개변수:
반환 값: 없음
키워드 또는 유형을 기반으로 특정 위치 근처의 장소 목록을 가져옵니다. 위치는 항상 LatLngBounds 또는 location 및 radius 매개변수를 전달하여 지정해야 합니다. 콜백에 전달되는 PlaceResult 는 전체 PlaceResult 의 하위 집합입니다. 앱은 원하는 장소의 PlaceResult.place_id 를 전달하는 장소 세부정보 요청을 전송하여 각 장소의 더 자세한 PlaceResult 를 가져올 수 있습니다. PlaceSearchPagination 객체는 추가 결과 페이지를 가져오는 데 사용할 수 있습니다 (결과의 마지막 페이지이거나 결과 페이지가 하나만 있는 경우 null). |
textSearch |
textSearch(request, callback) 매개변수:
반환 값: 없음
검색 문자열 (예: '뉴욕 피자' 또는 '오타와 근처 신발 가게')을 기반으로 장소 목록을 검색합니다. 위치 매개변수는 선택사항입니다. 위치가 지정되면 결과가 해당 지역 내 장소로 제한되지 않고 주변 결과에만 편중됩니다. 임의의 문자열을 사용하여 장소를 검색하려는 경우와 검색 결과를 특정 위치로 제한하고 싶지 않은 경우에 textSearch 를 사용하세요. PlaceSearchPagination 객체는 추가 결과 페이지를 가져오는 데 사용할 수 있습니다 (결과의 마지막 페이지이거나 결과 페이지가 하나만 있는 경우 null). |
PlaceDetailsRequest 인터페이스
google.maps.places.PlaceDetailsRequest
인터페이스
PlacesService
로 전송할 장소 세부정보 쿼리입니다.
속성 | |
---|---|
placeId |
유형:
string 세부정보를 요청하는 장소의 장소 ID입니다. |
fields optional |
유형:
Array<string> optional 세부정보 응답에 포함되고 요금이 청구되는 필드입니다. 지정된 필드가 없거나 ['ALL'] 가 전달되면 사용 가능한 모든 필드가 반환되고 비용이 청구됩니다 (프로덕션 배포에는 권장되지 않음). 필드 목록은 PlaceResult 를 참고하세요. 중첩된 필드는 점 경로 (예: "geometry.location" )로 지정할 수 있습니다. |
language optional |
유형:
string optional 세부정보를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요. |
region optional |
유형:
string optional 사용자의 지역 코드입니다. 이는 반환될 수 있는 사진 등에 영향을 줄 수 있습니다. 지역 코드는 ccTLD('최상위 도메인') 두 문자 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk'( .co.uk )인 반면 ISO 3166-1 코드는 'gb'입니다(기술적으로 'Great Britain과 Northern Ireland 연방국' 엔터티). |
sessionToken optional |
유형:
AutocompleteSessionToken optional 세부정보 요청을 자동 완성 세션과 번들로 묶는 데 사용되는 고유 참조입니다. |
FindPlaceFromPhoneNumberRequest 인터페이스
google.maps.places.FindPlaceFromPhoneNumberRequest
인터페이스
PlacesService.findPlaceFromPhoneNumber
로 전송할 텍스트 검색에서 장소 찾기 요청입니다.
속성 | |
---|---|
fields |
유형:
Array<string> 응답에 포함되고 요금이 청구되는 필드입니다. ['ALL'] 가 전달되면 사용 가능한 모든 필드가 반환되고 청구됩니다(프로덕션 배포의 경우 권장되지 않음). 필드 목록은 PlaceResult 를 참고하세요. 중첩된 필드는 점 경로 (예: "geometry.location" )로 지정할 수 있습니다. |
phoneNumber |
유형:
string 조회할 장소의 전화번호입니다. 형식은 E.164여야 합니다. |
language optional |
유형:
string optional 이름과 주소를 반환해야 하는 언어의 언어 식별자(가능한 경우). 지원 언어 목록을 참조하세요. |
locationBias optional |
유형:
LocationBias optional 장소를 검색할 때 사용되는 편향입니다. 결과는 지정된 LocationBias 에 편중되지만 이 LocationBias 로 제한되지는 않습니다. |
FindPlaceFromQueryRequest 인터페이스
google.maps.places.FindPlaceFromQueryRequest
인터페이스
PlacesService.findPlaceFromQuery
에 전송할 텍스트 검색 요청의 장소 찾기
속성 | |
---|---|
fields |
유형:
Array<string> 응답에 포함되고 요금이 청구되는 필드입니다. ['ALL'] 가 전달되면 사용 가능한 모든 필드가 반환되고 청구됩니다(프로덕션 배포의 경우 권장되지 않음). 필드 목록은 PlaceResult 를 참고하세요. 중첩된 필드는 점 경로 (예: "geometry.location" )로 지정할 수 있습니다. |
query |
유형:
string 요청의 쿼리입니다. 예를 들어 장소의 이름이나 주소를 나타낼 수 있습니다. |
language optional |
유형:
string optional 이름과 주소를 반환해야 하는 언어의 언어 식별자(가능한 경우). 지원 언어 목록을 참조하세요. |
locationBias optional |
유형:
LocationBias optional 장소를 검색할 때 사용되는 편향입니다. 결과는 지정된 LocationBias 에 편중되지만 이 LocationBias 로 제한되지는 않습니다. |
PlaceSearchRequest 인터페이스
google.maps.places.PlaceSearchRequest
인터페이스
PlacesService
에 전송할 장소 검색어입니다.
속성 | |
---|---|
bounds optional |
유형:
LatLngBounds|LatLngBoundsLiteral optional 장소를 검색할 경계입니다. bounds 가 설정되면 location 과 radius 가 모두 무시됩니다. |
keyword optional |
유형:
string optional 이름, 유형, 주소뿐만 아니라 고객 리뷰 및 기타 서드 파티 콘텐츠를 포함하되 이에 국한되지 않는 모든 사용 가능한 필드와 대조할 검색어입니다. |
language optional |
유형:
string optional 이름과 주소를 반환해야 하는 언어의 언어 식별자(가능한 경우). 지원 언어 목록을 참조하세요. |
location optional |
유형:
LatLng|LatLngLiteral optional 장소를 검색할 위치의 주변 위치입니다. |
maxPriceLevel optional |
유형:
number optional 지정된 가격 수준 이하의 장소로만 결과를 제한합니다. 올바른 값의 범위는 0(가장 저렴)~4(가장 비쌈)입니다. 지정된 경우 minPrice 이상이어야 합니다. |
minPriceLevel optional |
유형:
number optional 지정된 가격 수준 이상의 장소로 결과를 제한합니다. 올바른 값의 범위는 0(가장 저렴)~4(가장 비쌈)입니다. 지정된 경우 maxPrice 이하여야 합니다. |
|
유형:
string optional keyword 와 같습니다. 이 필드의 값은 keyword 필드의 값과 결합되어 동일한 검색 문자열의 일부로 전달됩니다. |
openNow optional |
유형:
boolean optional 현재 영업 중인 장소로만 결과를 제한합니다. |
radius optional |
유형:
number optional 장소를 검색할 지정된 위치로부터의 거리(미터)입니다. 허용되는 최대 값은 50,000입니다. |
rankBy optional |
유형:
RankBy optional 기본값:
RankBy.PROMINENCE 결과를 반환할 때 사용할 순위 지정 방법을 지정합니다. rankBy 가 DISTANCE 로 설정된 경우 location 를 지정해야 하지만 radius 또는 bounds 는 지정할 수 없습니다. |
type optional |
유형:
string optional 지정된 유형의 장소를 검색합니다. 유형은 요청의 타겟 위치의 현지 언어로 번역되어 쿼리 문자열로 사용됩니다. 쿼리도 제공되면 현지화된 유형 문자열에 연결됩니다. 다른 유형의 결과는 응답에서 삭제됩니다. 이 필드를 사용하여 언어 및 지역과 무관한 범주형 검색을 수행할 수 있습니다. 유효한 유형은 여기에 나와 있습니다. |
TextSearchRequest 인터페이스
google.maps.places.TextSearchRequest
인터페이스
PlacesService
로 전송할 텍스트 검색 요청입니다.
속성 | |
---|---|
bounds optional |
유형:
LatLngBounds|LatLngBoundsLiteral optional 장소를 검색할 때 결과에 편향성을 부여하는 데 사용되는 경계 (선택사항) bounds 가 설정되면 location 과 radius 가 모두 무시됩니다. 결과는 이 경계 내의 결과로 제한되지 않지만, 이 경계 내에 있는 결과의 순위가 더 높습니다. |
language optional |
유형:
string optional 이름과 주소를 반환해야 하는 언어의 언어 식별자(가능한 경우). 지원 언어 목록을 참조하세요. |
location optional |
유형:
LatLng|LatLngLiteral optional 장소를 검색할 때 결과를 편중하는 데 사용되는 영역의 중심입니다. |
query optional |
유형:
string optional 요청의 검색어입니다. 예를 들어 장소 이름 ('에펠탑'), 카테고리 뒤에 위치 이름 ('뉴욕의 피자')이 오는 경우 또는 장소 이름 뒤에 위치 구분자가 오는 경우 ('시드니의 스타벅스') |
radius optional |
유형:
number optional 장소를 검색할 때 결과를 편향시키는 데 사용되는 영역의 반경(미터)입니다. |
region optional |
유형:
string optional 결과를 편향할 지역 코드입니다. 지역 코드는 ccTLD('최상위 도메인') 두 문자 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk'( .co.uk )인 반면 ISO 3166-1 코드는 'gb'입니다(기술적으로 'Great Britain과 Northern Ireland 연방국' 엔터티). |
type optional |
유형:
string optional 지정된 유형의 장소를 검색합니다. 유형은 요청의 타겟 위치의 현지 언어로 번역되어 쿼리 문자열로 사용됩니다. 쿼리도 제공되면 현지화된 유형 문자열에 연결됩니다. 다른 유형의 결과는 응답에서 제외됩니다. 이 필드를 사용하여 언어 및 지역과 관계없는 카테고리 검색을 실행합니다. 유효한 유형은 여기에 나와 있습니다. |
RankBy 상수
google.maps.places.RankBy
상수
PlaceSearchRequest의 순위 옵션입니다.
const {RankBy} = await google.maps.importLibrary("places")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
---|---|
DISTANCE |
위치와의 거리를 기준으로 장소 검색 결과의 순위를 지정합니다. |
PROMINENCE |
검색결과 순위는 가시도에 따라 결정됩니다. |
LocationBias typedef
google.maps.places.LocationBias
typedef
LocationBias는 장소를 검색할 때 사용할 수 있는 유연한 경계 또는 힌트를 나타냅니다. 지정된 지역 밖에서 결과가 나올 수 있습니다. 현재 사용자의 IP 주소를 바이어스로 사용하려면 문자열 "IP_BIAS"
을 지정할 수 있습니다. 참고: Circle
를 사용하는 경우 중심과 반지름을 정의해야 합니다.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
google.maps.places.LocationRestriction
typedef
LocationRestriction은 장소를 검색할 때 사용할 엄격한 경계를 나타냅니다.
PlacesServiceStatus 상수
google.maps.places.PlacesServiceStatus
상수
검색이 완료될 때 PlacesService
에서 반환하는 상태입니다. 값으로 지정하거나 상수의 이름을 사용하여 지정합니다. 예를 들어 'OK'
또는 google.maps.places.PlacesServiceStatus.OK
입니다.
const {PlacesServiceStatus} = await google.maps.importLibrary("places")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
---|---|
INVALID_REQUEST |
이 요청이 잘못되었습니다. |
NOT_FOUND |
참조된 장소를 찾을 수 없습니다. |
OK |
응답에 유효한 결과가 포함되어 있습니다. |
OVER_QUERY_LIMIT |
애플리케이션이 요청 할당량을 초과했습니다. |
REQUEST_DENIED |
애플리케이션에서 PlacesService 를 사용할 수 없습니다. |
UNKNOWN_ERROR |
서버 오류로 인해 PlacesService 요청을 처리할 수 없습니다. 다시 시도하면 요청이 성공할 수도 있습니다. |
ZERO_RESULTS |
이 요청에서 결과를 찾지 못했습니다. |
PlaceSearchPagination 인터페이스
google.maps.places.PlaceSearchPagination
인터페이스
장소 결과의 추가 페이지를 가져오는 데 사용되는 객체입니다.
속성 | |
---|---|
hasNextPage |
유형:
boolean 추가 결과가 있는지 여부를 나타냅니다. 추가 결과 페이지가 있는 경우 true 입니다. |
메서드 | |
---|---|
nextPage |
nextPage() 매개변수: 없음
반환 값:
void 결과의 다음 페이지를 가져옵니다. 첫 번째 검색 요청에 제공된 것과 동일한 콜백 함수를 사용합니다. |
PlaceResult 인터페이스
google.maps.places.PlaceResult
인터페이스
장소에 대한 정보를 정의합니다.
속성 | |
---|---|
address_components optional |
유형:
Array<GeocoderAddressComponent> optional 이 장소의 위치에 대한 주소 구성요소 컬렉션입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
adr_address optional |
유형:
string optional adr 마이크로포맷으로 표시된 장소의 주소입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
aspects optional |
유형:
Array<PlaceAspectRating> optional Google 및 Zagat 사용자 리뷰를 기반으로 이 장소의 평점이 매겨진 측면입니다. 평점은 0~30점으로 매겨집니다. |
business_status optional |
유형:
BusinessStatus optional 장소가 비즈니스인 경우 장소의 영업 상태를 나타내는 플래그입니다 (장소가 운영 중인지 또는 일시적으로 또는 영구적으로 폐업했는지 여부를 나타냅니다). 사용 가능한 데이터가 없으면 검색 또는 세부정보 응답에 플래그가 표시되지 않습니다. |
formatted_address optional |
유형:
string optional 장소의 전체 주소입니다. |
formatted_phone_number optional |
유형:
string optional 지역의 전화번호 규칙에 따라 형식이 지정된 장소의 전화번호입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
geometry optional |
유형:
PlaceGeometry optional 장소의 도형 관련 정보. |
html_attributions optional |
유형:
Array<string> optional 이 장소 결과에 대해 표시할 저작자 표시 텍스트입니다. 사용 가능한 html_attributions 는 요청된 fields 에 관계없이 항상 반환되며 표시되어야 합니다. |
icon optional |
유형:
string optional 이 장소의 카테고리를 나타내는 데 사용할 수 있는 이미지 리소스에 대한 URL입니다. |
icon_background_color optional |
유형:
string optional 장소 아이콘과 함께 사용할 배경 색상입니다. PlaceResult.icon_mask_base_uri 을 참고하세요. |
icon_mask_base_uri optional |
유형:
string optional 아이콘 마스크의 URL로, 일부가 잘립니다. 파일 확장자 (예: .svg 또는 .png )를 끝에 추가하여 다양한 아이콘 유형에 액세스합니다. |
international_phone_number optional |
유형:
string optional 장소의 전화번호(국가 코드 포함 형식)입니다. 국제 형식에는 국가 코드가 포함되며 플러스(+) 기호가 접두사로 붙습니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
name optional |
유형:
string optional 장소의 이름입니다. 참고: 사용자가 장소를 입력한 경우 이는 사용자가 입력한 원시 텍스트입니다. 악의적인 사용자가 이 데이터를 코드 삽입 공격의 벡터로 사용하려고 할 수 있으므로 이 데이터를 사용할 때는 주의하세요 ( http://en.wikipedia.org/wiki/Code_injection 참고). |
opening_hours optional |
유형:
PlaceOpeningHours optional 장소의 개업 또는 폐업 시간을 정의합니다. |
|
유형:
boolean optional 장소가 영구적으로 폐쇄되었는지 또는 임시적으로 폐쇄되었는지 여부를 나타내는 플래그입니다. 장소가 운영 중이거나 데이터를 사용할 수 없는 경우 이 플래그는 응답에서 제외됩니다. |
photos optional |
유형:
Array<PlacePhoto> optional 이 장소의 사진 컬렉션에는 최대 10개의 PlacePhoto 객체가 포함됩니다. |
place_id optional |
유형:
string optional 장소의 고유 식별자입니다. |
plus_code optional |
유형:
PlacePlusCode optional 장소의 오픈 위치 코드 또는 '플러스 코드'를 정의합니다. |
price_level optional |
유형:
number optional 장소의 가격 수준(0~4등급). 가격 수준은 다음과 같이 해석됩니다.
|
rating optional |
유형:
number optional 이 장소에 대한 사용자 리뷰를 기반으로 한 평점(1.0~5.0)입니다. |
reviews optional |
유형:
Array<PlaceReview> optional 이 장소에 대한 리뷰 목록입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
types optional |
유형:
Array<string> optional |
url optional |
유형:
string optional 이 장소에 대한 공식 Google 페이지의 URL입니다. 장소에 대한 최상의 정보가 포함된 Google 소유 페이지입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
user_ratings_total optional |
유형:
number optional 이 장소의 PlaceResult.rating 에 기여한 사용자 평점 수입니다. |
|
유형:
number optional 장소의 현재 시간대와 UTC의 차이(분)입니다. 예를 들어 일광 절약 시간이 적용되는 오스트레일리아 시드니는 UTC보다 11시간 빠르므로 utc_offset 은 660 이 됩니다. UTC보다 뒤처진 시간대의 경우 오프셋은 음수입니다. 예를 들어 카보베르데의 경우 utc_offset 은 -60 입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
utc_offset_minutes optional |
유형:
number optional 장소의 현재 시간대와 UTC의 차이(분)입니다. 예를 들어 서머타임이 적용되는 호주 시드니는 UTC보다 11시간 빠르므로 utc_offset_minutes 는 660 입니다. UTC보다 뒤처진 시간대의 경우 오프셋은 음수입니다. 예를 들어 카보베르데의 경우 utc_offset_minutes 은 -60 입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
vicinity optional |
유형:
string optional 거리 이름, 번지, 지역은 포함하지만 시/도, 우편번호, 국가는 포함되지 않은 장소의 단순화된 주소입니다. 예를 들어 Google 오스트레일리아 시드니 사무실의 근처 값은 "48 Pirrama Road, Pyrmont" 입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
website optional |
유형:
string optional 비즈니스 홈페이지와 같이 이 장소의 신뢰할 수 있는 웹사이트입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
PlaceAspectRating 인터페이스
google.maps.places.PlaceAspectRating
인터페이스
사용자가 리뷰한 장소의 특성에 관한 정보를 정의합니다.
속성 | |
---|---|
rating |
유형:
number 이 측정항목의 평점입니다. 개별 리뷰의 경우 0~3 사이의 정수입니다. 장소의 집계된 평점의 경우 0~30 사이의 정수입니다. |
type |
유형:
string 관점 유형입니다. 예를 들면 "food" , "decor" , "service" , "overall" 입니다. |
BusinessStatus 상수
google.maps.places.BusinessStatus
상수
장소의 영업 상태(비즈니스인 경우)는 PlaceResult에 반환됩니다(장소가 영업 중인지 또는 일시적 또는 영구적으로 폐쇄되었는지 나타냄). 값 또는 상수의 이름 (예: 'OPERATIONAL'
또는 google.maps.places.BusinessStatus.OPERATIONAL
)으로 지정합니다.
const {BusinessStatus} = await google.maps.importLibrary("places")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
---|---|
CLOSED_PERMANENTLY |
비즈니스가 폐업했습니다. |
CLOSED_TEMPORARILY |
비즈니스가 임시 휴업 중입니다. |
OPERATIONAL |
비즈니스가 정상적으로 운영되고 있습니다. |
PlaceGeometry 인터페이스
google.maps.places.PlaceGeometry
인터페이스
장소의 도형에 관한 정보를 정의합니다.
속성 | |
---|---|
location optional |
유형:
LatLng optional 장소의 위치입니다. |
viewport optional |
유형:
LatLngBounds optional 이 장소를 지도에 표시할 때 선호되는 뷰포트입니다. 장소의 기본 뷰포트가 알려지지 않은 경우 이 속성은 null 입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
PlaceOpeningHours 인터페이스
google.maps.places.PlaceOpeningHours
인터페이스
장소의 영업시간에 관한 정보를 정의합니다.
속성 | |
---|---|
|
유형:
boolean optional 장소가 현재 영업 중인지 여부입니다. |
periods optional |
유형:
Array<PlaceOpeningHoursPeriod> optional 일요일부터 시작하여 요일별 영업 시간을 시간순으로 나타냅니다. 장소가 문을 닫은 날은 포함되지 않습니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
weekday_text optional |
유형:
Array<string> optional 각 요일의 형식이 지정된 영업시간을 나타내는 일곱 개 문자열의 배열입니다. 장소 서비스는 현재 언어에 맞게 영업시간의 형식을 지정하고 현지화합니다. 이 배열에서 요소의 순서는 언어에 따라 다릅니다. 일부 언어는 월요일에 한 주를 시작하고 다른 언어는 일요일에 시작합니다. PlacesService.getDetails 에서만 사용할 수 있습니다. 다른 호출은 빈 배열을 반환할 수 있습니다. |
메서드 | |
---|---|
isOpen |
isOpen([date]) 매개변수:
반환 값:
boolean|undefined 날짜가 지났는지 여부에 따라 장소가 현재 영업 중인지 또는 지정된 날짜에 영업 중인지 확인합니다. 이 장소에 PlaceResult.utc_offset_minutes 또는 PlaceOpeningHours.periods 가 없으면 undefined 가 반환됩니다 (PlaceOpeningHours.periods 는 PlacesService.getDetails 를 통해서만 사용할 수 있음). 이 메서드는 휴일 영업시간과 같은 예외적인 시간을 고려하지 않습니다. |
PlaceOpeningHoursPeriod 인터페이스
google.maps.places.PlaceOpeningHoursPeriod
인터페이스
장소의 영업시간에 대한 구조화된 정보를 정의합니다. 참고: 장소가 항상 열려 있는 경우 응답에서 close
섹션이 누락됩니다. 클라이언트는 항상 열려 있음을 값이 0
인 day
, 값이 "0000"
인 time
, close
없음으로 표시된 open
기간으로 표시할 수 있습니다.
속성 | |
---|---|
open |
장소의 영업 시작 시간입니다. |
close optional |
유형:
PlaceOpeningHoursTime optional 장소의 폐쇄 시간입니다. |
PlaceOpeningHoursTime 인터페이스
google.maps.places.PlaceOpeningHoursTime
인터페이스
장소의 개업 또는 폐업 시간을 정의합니다.
속성 | |
---|---|
day |
유형:
number 일요일부터 시작하는 [ 0 , 6 ] 범위의 숫자로 된 요일입니다. 예를 들어 2 는 화요일을 의미합니다. |
hours |
유형:
number |
minutes |
유형:
number |
time |
유형:
string 24시간 'hhmm' 형식의 시간입니다. 값의 범위는 [ "0000" , "2359" ]입니다. 시간은 장소의 시간대로 보고됩니다. |
nextDate optional |
유형:
number optional 이 PlaceOpeningHoursTime의 다음 발생을 나타내는 타임스탬프 (에포크 이후의 밀리초 단위, new Date() 와 함께 사용하기 적합)입니다. 주 PlaceOpeningHoursTime.day , PlaceOpeningHoursTime.time , PlaceResult.utc_offset_minutes 에서 계산됩니다. PlaceResult.utc_offset_minutes 가 undefined 이면 nextDate 는 undefined 입니다. |
PlacePlusCode 인터페이스
google.maps.places.PlacePlusCode
인터페이스
장소의 오픈 위치 코드 또는 '플러스 코드'를 정의합니다. Plus Code는 상세 주소가 없는 (건물에 번호가 지정되지 않거나 거리 이름이 없는) 장소의 상세 주소 대신 사용할 수 있습니다.
속성 | |
---|---|
global_code |
유형:
string 1/8000도x1/8000도 영역의 플러스 코드입니다. 예를 들면 "8FVC9G8F+5W" 입니다. |
compound_code optional |
유형:
string optional 1/8000도 x 1/8000도 면적의 플러스 코드로, 앞의 네 글자 (지역 코드)가 삭제되고 지역 설명으로 대체됩니다. 예를 들면 "9G8F+5W Zurich, Switzerland" 입니다. 코드를 줄이기 위해 적절한 지역을 찾을 수 없는 경우 이 필드는 생략됩니다. |
PlacePhoto 인터페이스
google.maps.places.PlacePhoto
인터페이스
장소의 사진 요소를 나타냅니다.
속성 | |
---|---|
height |
유형:
number 사진의 높이입니다(단위: 픽셀). |
html_attributions |
유형:
Array<string> 이 사진에 표시할 저작자 표시 텍스트입니다. |
width |
유형:
number 사진의 너비입니다(단위: 픽셀). |
메서드 | |
---|---|
getUrl |
getUrl([opts]) 매개변수:
반환 값:
string 지정된 옵션에 해당하는 이미지 URL을 반환합니다. |
PhotoOptions 인터페이스
google.maps.places.PhotoOptions
인터페이스
사진 요청 옵션을 정의합니다.
속성 | |
---|---|
maxHeight optional |
유형:
number optional 반환된 이미지의 최대 높이(픽셀)입니다. |
maxWidth optional |
유형:
number optional 반환된 이미지의 최대 너비(단위: 픽셀)입니다. |
PlaceReview 인터페이스
google.maps.places.PlaceReview
인터페이스
장소에 대한 단일 리뷰를 나타냅니다.
속성 | |
---|---|
author_name |
유형:
string 리뷰 작성자의 이름입니다. |
language |
유형:
string 이 리뷰가 작성된 언어를 나타내는 IETF 언어 코드입니다. 이 코드에는 국가 또는 지역을 나타내는 보조 태그 없이 기본 언어 태그만 포함되어 있습니다. 예를 들어 모든 영어 리뷰는 'en-AU'나 'en-UK'가 아닌 'en' 로 태그가 지정됩니다. |
profile_photo_url |
유형:
string 뷰어의 프로필 이미지에 대한 URL입니다. |
relative_time_description |
유형:
string 언어 및 국가에 적합한 형식으로 현재 시간과 관련된 리뷰 시간을 나타내는 형식 지정된 최근 시간 문자열입니다. 예를 들면 "a month ago" 입니다. |
text |
유형:
string 리뷰 텍스트입니다. |
time |
유형:
number 리뷰 타임스탬프로, 에포크 이후 초 단위로 표시됩니다. |
|
유형:
Array<PlaceAspectRating> optional 리뷰에서 평가한 측면입니다. 평점입니다(0~3등급). |
author_url optional |
유형:
string optional 리뷰 작성자의 프로필 URL입니다. 리뷰 작성자의 프로필을 사용할 수 없는 경우 undefined 이 됩니다. |
rating optional |
유형:
number optional 이 리뷰의 평점으로, 1.0 이상 5.0 이하의 숫자입니다. |