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 사용자 지역의 지역 코드입니다. 이는 반환되는 사진 및 다른 항목에 영향을 줄 수 있습니다. 지역 코드에는 2자리 ccTLD ('최상위 도메인') 값이 허용됩니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' ( .co.uk )인 반면 ISO 3166-1 코드는 'gb' (기술적으로 '영국 및 북아일랜드'의 엔티티)입니다. |
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 에 편중되지만 이에 국한되지는 않습니다. |
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 에 편중되지만 이에 국한되지는 않습니다. |
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 결과를 편중할 지역 코드입니다. 지역 코드에는 2자리 ccTLD ('최상위 도메인') 값이 허용됩니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' ( .co.uk )인 반면 ISO 3166-1 코드는 'gb' (기술적으로 '영국 및 북아일랜드'의 엔티티)입니다. |
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() 매개변수: 없음
반환 값: 없음
결과의 다음 페이지를 가져옵니다. 첫 번째 검색 요청에 제공된 것과 동일한 콜백 함수를 사용합니다. |
PlaceResult 인터페이스
google.maps.places.PlaceResult
인터페이스
장소에 대한 정보를 정의합니다.
속성 | |
---|---|
address_components optional |
유형:
Array<GeocoderAddressComponent> optional 이 장소의 위치에 대한 주소 구성요소 컬렉션입니다. PlacesService.getDetails 에서만 사용할 수 있습니다. |
adr_address optional |
유형:
string optional 장소의 주소를 adr microformat으로 표현한 것입니다. 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 장소의 이름입니다. 참고: 사용자가 Places를 입력한 경우 이는 사용자가 입력한 원시 텍스트입니다. 악의적인 사용자가 이 데이터를 코드 삽입 공격의 경로로 사용할 수 있으므로 이 데이터를 사용할 때는 주의하시기 바랍니다 ( 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 장소에 대한 열린 위치 코드 또는 'plus 코드'를 정의합니다. |
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의 오스트레일리아 시드니 사무실의 vicinity 값은 "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 각 요일의 형식이 지정된 영업시간을 나타내는 7개의 문자열 배열입니다. Places Service는 현재 언어에 맞게 영업시간의 형식을 지정하고 현지화합니다. 이 배열에서 요소의 순서는 언어에 따라 다릅니다. 일부 언어는 월요일에 한 주를 시작하고 다른 언어는 일요일에 시작합니다. PlacesService.getDetails 에서만 사용할 수 있습니다. 다른 호출은 빈 배열을 반환할 수 있습니다. |
방법 | |
---|---|
isOpen |
isOpen([date]) 매개변수:
반환 값:
boolean|undefined 장소가 현재 영업 중인지 (날짜가 지나지 않은 경우) 또는 지정된 날짜에 영업 중인지 확인합니다. 이 장소에 PlaceResult.utc_offset_minutes 또는 PlaceOpeningHours.periods 가 없으면 undefined 가 반환됩니다 (PlaceOpeningHours.periods 는 PlacesService.getDetails 을 통해서만 사용할 수 있음). 이 메서드는 휴일 영업시간과 같은 예외적인 영업시간을 고려하지 않습니다. |
PlaceOpeningHoursPeriod 인터페이스
google.maps.places.PlaceOpeningHoursPeriod
인터페이스
장소의 영업시간에 대한 구조화된 정보를 정의합니다. 참고: 장소가 항상 열려 있는 경우 응답에서 close
섹션이 누락됩니다. 클라이언트는 항상 열려 있음을 day
을 포함하는 open
기간으로, 값이 0
이고 time
값이 "0000"
이고 close
는 없는 것으로 표시할 수 있습니다.
속성 | |
---|---|
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 코드'를 정의합니다. Plus Code는 상세 주소가 없는 (건물에 번호가 지정되지 않거나 거리 이름이 없는) 장소의 상세 주소 대신 사용할 수 있습니다.
속성 | |
---|---|
global_code |
유형:
string 1/8000 도의 1/8000 도 영역의 1/8000 도 단위로 표시된 플러스 코드 예를 들면 다음과 같습니다. "8FVC9G8F+5W" |
compound_code optional |
유형:
string optional 플러스 코드: 도 영역의 1/8,000x8,000의 1/8000 각도로 처음 4자 (지역 번호)가 삭제되고 지역 설명으로 대체됩니다. 예를 들면 다음과 같습니다. "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 이하의 숫자입니다. |