Places Service

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

PlacesService 클래스

google.maps.places.PlacesService 클래스

장소 검색 및 장소 세부정보 가져오기와 관련된 메서드가 포함됩니다.

&libraries=places URL 매개변수가 필요합니다. 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 또는 locationradius 매개변수를 전달하여 지정해야 합니다. 콜백에 전달되는 PlaceResult는 전체 PlaceResult의 하위 집합입니다. 앱은 원하는 장소의 PlaceResult.place_id를 전달하는 장소 세부정보 요청을 전송하여 각 장소의 더 자세한 PlaceResult을 가져올 수 있습니다. PlaceSearchPagination 객체를 사용하여 결과 페이지를 추가로 가져올 수 있습니다 (결과의 마지막 페이지이거나 결과 페이지가 하나만 있는 경우 null).
textSearch
textSearch(request, callback)
매개변수:
반환 값: 없음
쿼리 문자열을 기반으로 장소 목록을 검색합니다 (예: '뉴욕의 피자' 또는 '오타와 주변'의 신발 가게). 위치 매개변수는 선택사항입니다. 위치가 지정되면 지역 내 장소에 국한되지 않고 근처 결과에만 결과가 나타납니다. 임의의 문자열을 사용하여 장소를 검색하려는 경우 및 검색결과를 특정 위치로 제한하지 않으려는 경우 textSearch를 사용합니다. PlaceSearchPagination 객체를 사용하여 결과 페이지를 추가로 가져올 수 있습니다 (결과의 마지막 페이지이거나 결과 페이지가 하나만 있는 경우 null).

PlaceDetailsRequest 인터페이스

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

PlacesService로 전송할 Place Details 쿼리입니다.

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

placeId
유형: string
세부정보가 요청되는 장소의 장소 ID입니다.
fields optional
유형: Array<string> optional
세부정보 응답에 포함할 필드이며 비용이 청구됩니다. 필드를 지정하지 않거나 ['ALL']를 전달하면 사용 가능한 모든 필드가 반환되고 요금이 청구됩니다 (프로덕션 배포에는 권장되지 않음). 필드 목록은 PlaceResult을 참고하세요. 중첩 필드는 점 경로 (예: "geometry.location")로 지정할 수 있습니다.
language optional
유형: string optional
세부정보를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
region optional
유형: string optional
사용자 지역의 지역 코드입니다. 이로 인해 반환될 수 있는 사진 및 기타 항목이 영향을 받을 수 있습니다. 지역 코드는 ccTLD ("최상위 도메인") 2자리 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk'(.co.uk)이지만 ISO 3166-1 코드는 'gb'입니다(기술적으로 영국과 북아일랜드의 법인).
sessionToken optional
유형: AutocompleteSessionToken optional
세부정보 요청을 자동 완성 세션과 번들로 묶는 데 사용되는 고유 참조입니다.

FindPlaceFromPhoneNumberRequest 인터페이스

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

PlacesService.findPlaceFromPhoneNumber에 전송할 텍스트 검색 요청의 찾기 장소입니다.

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

fields
유형: Array<string>
응답에 포함할 필드이며, 비용이 청구됩니다. ['ALL']가 전달되면 사용 가능한 모든 필드가 반환되고 요금이 청구됩니다 (프로덕션 배포에는 권장되지 않음). 필드 목록은 PlaceResult을 참고하세요. 중첩 필드는 점 경로 (예: "geometry.location")로 지정할 수 있습니다.
phoneNumber
유형: string
조회할 장소의 전화번호입니다. 형식은 E.164여야 합니다.
language optional
유형: string optional
가능한 경우 이름과 주소를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
locationBias optional
유형: LocationBias optional
Place를 검색할 때 사용되는 편향입니다. 결과는 지정된 LocationBias로 한정되지만 이에 국한되지 않습니다.

FindPlaceFromQueryRequest 인터페이스

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

PlacesService.findPlaceFromQuery에 전송할 텍스트 검색 요청의 찾기 장소입니다.

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

fields
유형: Array<string>
응답에 포함할 필드이며, 비용이 청구됩니다. ['ALL']가 전달되면 사용 가능한 모든 필드가 반환되고 요금이 청구됩니다 (프로덕션 배포에는 권장되지 않음). 필드 목록은 PlaceResult을 참고하세요. 중첩 필드는 점 경로 (예: "geometry.location")로 지정할 수 있습니다.
query
유형: string
요청 쿼리입니다. 예를 들어 장소의 이름이나 주소를 볼 수 있습니다.
language optional
유형: string optional
가능한 경우 이름과 주소를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
locationBias optional
유형: LocationBias optional
Place를 검색할 때 사용되는 편향입니다. 결과는 지정된 LocationBias로 한정되지만 이에 국한되지 않습니다.

PlaceSearchRequest 인터페이스

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

PlacesService로 보낼 장소 검색어입니다.

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

bounds optional
장소를 검색할 경계입니다. bounds가 설정된 경우 locationradius이 모두 무시됩니다.
keyword optional
유형: string optional
이름, 유형, 주소, 고객 리뷰, 기타 제3자 콘텐츠를 포함하되 이에 국한되지 않는 모든 사용 가능한 모든 필드를 대조하는 용어입니다.
language optional
유형: string optional
가능한 경우 이름과 주소를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
location optional
유형: LatLng|LatLngLiteral optional
장소를 검색할 위치입니다.
maxPriceLevel optional
유형: number optional
지정된 가격 수준 이하의 장소로만 결과를 제한합니다. 유효 값은 0(가장 저렴함)부터 4(가장 비쌈)의 범위로 표시됩니다. 지정된 경우 minPrice 이상이어야 합니다.
minPriceLevel optional
유형: number optional
지정된 가격 수준 이상의 장소로만 결과를 제한합니다. 유효 값은 0(가장 저렴함)부터 4(가장 비쌈)의 범위로 표시됩니다. 지정된 경우 maxPrice 이하여야 합니다.
name optional
유형: string optional
keyword과 같습니다. 이 필드의 값은 keyword 필드의 값과 결합되며 동일한 검색 문자열의 일부로 전달됩니다.
openNow optional
유형: boolean optional
현재 영업 중인 장소로만 결과를 제한합니다.
radius optional
유형: number optional
장소 검색을 위해 지정된 위치에서의 거리입니다(미터 단위). 최대 허용 값은 50,000입니다.
rankBy optional
유형: RankBy optional
결과를 반환할 때 사용할 순위 지정 방법을 지정합니다. rankByDISTANCE로 설정된 경우 location을 지정해야 하지만 radius 또는 bounds은 지정할 수 없습니다.
type optional
유형: string optional
지정된 유형의 장소를 검색합니다. 유형은 요청의 대상 위치의 현지 언어로 변환되고 쿼리 문자열로 사용됩니다. 쿼리도 제공되면 현지화된 유형 문자열에 연결됩니다. 다른 유형의 결과는 응답에서 제외됩니다. 이 필드를 사용하여 언어와 지역과 상관없이 범주형 검색을 수행할 수 있습니다. 유효한 유형은 여기에서 확인할 수 있습니다.

TextSearchRequest 인터페이스

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

PlacesService로 전송할 텍스트 검색 요청입니다.

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

bounds optional
장소를 검색할 때 결과를 편향하는 데 사용되는 경계 (선택사항) bounds가 설정된 경우 locationradius이 모두 무시됩니다. 검색결과는 이 경계 내에 있는 결과로 제한되지 않지만 그 안의 결과는 순위가 더 높습니다.
language optional
유형: string optional
가능한 경우 이름과 주소를 반환해야 하는 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
location optional
유형: LatLng|LatLngLiteral optional
장소를 검색할 때 결과가 표시되는 데 사용되는 영역의 중심입니다.
query optional
유형: string optional
요청의 검색어입니다. 예를 들어 장소의 이름 (&E#39;Eiffel Tower'), 카테고리 다음에 위치 이름이 나올 수 있으며(예: 뉴욕의 피자) 또는 장소 이름으로 위치 구분(시드니에서 스타벅스)할 수 있습니다.
radius optional
유형: number optional
장소를 검색할 때 결과가 결과에 사용되는 지역의 반경(미터)입니다.
region optional
유형: string optional
결과가 편중될 지역 코드입니다. 지역 코드는 ccTLD ("최상위 도메인") 2자리 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk'(.co.uk)이지만 ISO 3166-1 코드는 'gb'입니다(기술적으로 영국과 북아일랜드의 법인).
type optional
유형: string optional
지정된 유형의 장소를 검색합니다. 유형은 요청의 대상 위치의 현지 언어로 변환되고 쿼리 문자열로 사용됩니다. 쿼리도 제공되면 현지화된 유형 문자열에 연결됩니다. 다른 유형의 결과는 응답에서 제외됩니다. 이 필드를 사용하여 언어와 지역과 상관없이 범주형 검색을 수행할 수 있습니다. 유효한 유형은 여기에서 확인할 수 있습니다.

RankBy 상수

google.maps.places.RankBy 상수

PlaceSearchRequest의 순위 옵션입니다.

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

DISTANCE 순위는 해당 위치로부터의 거리에 따른 결과입니다.
PROMINENCE 순위는 가시도에 따라 검색결과가 표시됩니다.

LocationBias typedef

google.maps.places.LocationBias 유형 정의

LocationBias는 장소를 검색할 때 사용하는 소프트 경계 또는 힌트를 나타냅니다. 지정된 영역 외부에서 가져온 결과일 수 있습니다. 현재 사용자의 IP 주소를 편향으로 사용하려면 "IP_BIAS" 문자열을 지정할 수 있습니다. 참고: Circle를 사용하는 경우 중심과 반경을 정의해야 합니다.

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

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction 유형 정의

LocationRestriction은 장소를 검색할 때 사용하는 엄격한 경계를 나타냅니다.

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

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus 상수

google.maps.places.PlacesServiceStatus 상수

검색 완료 시 PlacesService에서 반환한 상태입니다. 값 또는 상수 이름을 사용하여 지정하세요. 예를 들어 'OK' 또는 google.maps.places.PlacesServiceStatus.OK입니다.

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

INVALID_REQUEST 이 요청이 잘못되었습니다.
NOT_FOUND 참조한 장소를 찾을 수 없습니다.
OK 응답에 유효한 결과가 포함되어 있습니다.
OVER_QUERY_LIMIT 애플리케이션이 요청 할당량을 초과했습니다.
REQUEST_DENIED 애플리케이션에서 PlacesService를 사용할 수 없습니다.
UNKNOWN_ERROR 서버 오류로 인해 PlacesService 요청을 처리할 수 없습니다. 다시 시도하면 요청이 성공할 수도 있습니다.
ZERO_RESULTS 이 요청에서 결과를 찾지 못했습니다.

PlaceSearchPagination 인터페이스

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

장소 검색결과의 추가 페이지를 가져오는 데 사용되는 객체입니다.

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

hasNextPage
유형: boolean
추가 결과가 있는지 여부를 나타냅니다. true: 추가 결과 페이지가 있는 경우
nextPage
nextPage()
매개변수: 없음
반환 값: 없음
결과의 다음 페이지를 가져옵니다. 첫 번째 검색 요청에 제공된 것과 동일한 콜백 함수를 사용합니다.

PlaceResult 인터페이스

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

장소에 대한 정보를 정의합니다.

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

address_components 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
장소의 이름입니다. 참고: 사용자가 장소를 입력한 경우 이 텍스트는 사용자가 입력하는 원시 텍스트입니다. 악의적인 사용자가 코드 삽입 공격을 위한 벡터로 데이터를 사용할 수 있으므로 이 데이터를 사용할 때는 주의하시기 바랍니다 (http://en.wikipedia.org/wiki/Code_injection 참조).
opening_hours optional
유형: PlaceOpeningHours optional
장소의 영업 시작 또는 종료 시점을 정의합니다.
permanently_closed 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등급)입니다. 가격 등급은 다음과 같이 해석됩니다.
  • 0: 무료
  • 1: 저렴함
  • 2: 보통
  • 3: 비쌈
  • 4: 매우 비쌈
rating optional
유형: number optional
이 장소의 사용자 리뷰를 기준으로 한 1.0~5.0의 평점입니다.
reviews optional
유형: Array<PlaceReview> optional
이 장소의 리뷰 목록입니다. PlacesService.getDetails에서만 사용할 수 있습니다.
types optional
유형: Array<string> optional
이 장소의 유형 배열입니다 (예: ["political", "locality"] 또는 ["restaurant", "establishment"]).
url optional
유형: string optional
이 장소에 대한 공식 Google 페이지의 URL입니다. Google이 소유한 페이지로, 장소에 대해 가장 적합한 정보가 포함되어 있습니다. PlacesService.getDetails에서만 사용할 수 있습니다.
user_ratings_total optional
유형: number optional
이 장소의 PlaceResult.rating에 기여한 사용자 평가 수입니다.
utc_offset optional
유형: number optional
장소 현재 시간대의 UTC 오프셋(분 단위)입니다. 예를 들어 오스트레일리아 시드니는 일광 절약 시간이 UTC보다 11시간 빠르므로 utc_offset660입니다. UTC 이후 시간대의 경우 오프셋은 음수입니다. 예를 들어 utc_offset는 카보베르데에서 -60입니다. PlacesService.getDetails에서만 사용할 수 있습니다.
utc_offset_minutes optional
유형: number optional
장소 현재 시간대의 UTC 오프셋(분 단위)입니다. 예를 들어 오스트레일리아 시드니는 일광 절약 시간이 UTC보다 11시간 빠르므로 utc_offset_minutes660입니다. 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 인터페이스

사용자가 리뷰한 장소의 특정 측면에 대한 정보를 정의합니다.

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

rating
유형: number
이 측면의 평점입니다. 개별 리뷰의 경우 0~3의 정수입니다. 장소의 집계된 평점은 0~30의 정수입니다.
type
유형: string
가로세로 유형 예: "food", "decor", "service", "overall".

BusinessStatus 상수

google.maps.places.BusinessStatus 상수

장소의 운영 상태(비즈니스인 경우)는 PlaceResult에 반환됩니다(장소의 운영 여부를 나타내거나 임시 휴업 또는 폐업). 값 또는 상수 이름 (예: 'OPERATIONAL' 또는 google.maps.places.BusinessStatus.OPERATIONAL)으로 지정합니다.

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

CLOSED_PERMANENTLY 비즈니스가 폐업했습니다.
CLOSED_TEMPORARILY 비즈니스가 임시 휴업 중입니다.
OPERATIONAL 비즈니스가 정상적으로 운영되고 있습니다.

PlaceGeometry 인터페이스

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

장소의 도형에 대한 정보를 정의합니다.

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

location optional
유형: LatLng optional
장소의 위치입니다.
viewport optional
유형: LatLngBounds optional
지도에 이 장소를 표시할 때 선호되는 표시 영역입니다. 이 속성은 선호하는 장소 표시 영역을 알 수 없는 경우 null입니다. PlacesService.getDetails에서만 사용할 수 있습니다.

PlaceOpeningHours 인터페이스

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

장소의 영업시간에 대한 정보를 정의합니다.

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

open_now optional
유형: boolean optional
장소가 현재 영업 중인지 여부입니다.
periods optional
유형: Array<PlaceOpeningHoursPeriod> optional
일요일부터 시작하여 각 요일의 개점 기간을 시간순으로 표시합니다. 장소가 개점하지 않은 날은 포함되지 않습니다. PlacesService.getDetails에서만 사용할 수 있습니다.
weekday_text optional
유형: Array<string> optional
각 요일의 지정된 영업시간을 나타내는 7개의 문자열로 구성된 배열입니다. Places Service는 현재 언어에 맞게 영업시간의 형식을 지정하고 현지화합니다. 이 배열에서 요소의 순서는 언어에 따라 다릅니다. 일부 언어는 월요일에 한 주를 시작하고 다른 언어는 일요일에 시작합니다. PlacesService.getDetails에서만 사용할 수 있습니다. 다른 호출은 빈 배열을 반환할 수 있습니다.
isOpen
isOpen([date])
매개변수:
  • dateDate optional
반환 값: boolean|undefined
현재 영업 중인지 (날짜가 지나지 않은 경우) 또는 지정된 날짜에 영업되는지 확인합니다. 이 장소에 PlaceResult.utc_offset_minutes 또는 PlaceOpeningHours.periods가 없으면 undefined이 반환됩니다(PlaceOpeningHours.periodsPlacesService.getDetails를 통해서만 사용 가능). 이 메서드는 휴일 영업시간과 같은 예외적인 시간을 고려하지 않습니다.

PlaceOpeningHoursPeriod 인터페이스

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

장소의 영업시간에 관한 구조화된 정보를 정의합니다. 참고: 장소가 항상 열려 있는 경우 응답에서 close 섹션이 누락됩니다. 클라이언트는 open 값이 day이고 0time 값이 "0000"이고 close는 포함되어 있지 않은 상시 개방에 의존할 수 있습니다.

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

open
장소의 개점 시간입니다.
close optional
유형: PlaceOpeningHoursTime optional
장소의 폐점 시간입니다.

PlaceOpeningHoursTime 인터페이스

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

장소의 영업 시작 또는 종료 시기를 정의합니다.

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

day
유형: number
일요일부터 시작하여 [0, 6] 범위의 숫자로 표시된 요일입니다. 예를 들어 2는 화요일을 의미합니다.
hours
유형: number
PlaceOpeningHoursTime.time의 영업시간을 [0, 23] 범위에서 숫자로 표현합니다. 이는 장소의 시간대로 보고됩니다.
minutes
유형: number
PlaceOpeningHoursTime.time의 분으로, [0, 59] 범위 내 숫자입니다. 이 값은 장소의 시간대로 보고됩니다.
time
유형: string
시간(24시간 형식)입니다. 값의 범위는 ["0000", "2359"]입니다. 시간은 장소의 시간대로 보고됩니다.
nextDate optional
유형: number optional
이 PlaceOpeningHoursTime의 다음 발생을 나타내는 타임스탬프 (에포크 이후의 밀리초 단위). 주 PlaceOpeningHoursTime.day, PlaceOpeningHoursTime.time, PlaceResult.utc_offset_minutes로 계산됩니다. PlaceResult.utc_offset_minutesundefined이면 nextDateundefined가 됩니다.

PlacePlusCode 인터페이스

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

개방형 위치 코드 또는 '플러스 코드'를 정의합니다. Plus Code는 존재하지 않는 위치 (건물에 번호가 지정되지 않았거나 거리 이름이 없는 경우)를 대체할 수 있습니다.

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

global_code
유형: string
1도의 1/8000도와 1/8000도의 플러스 코드입니다. 예: "8FVC9G8F+5W"
compound_code optional
유형: string optional
1도의 1/8000도에 1/8000번째 도수로 표시되는 더하기 코드는 첫 4자 (지역 번호)를 삭제하고 지역 설명으로 대체합니다. 예: "9G8F+5W Zurich, Switzerland" 코드를 단축하는 데 적합한 지역을 찾을 수 없는 경우 이 필드는 생략됩니다.

PlacePhoto 인터페이스

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

장소의 사진 요소를 나타냅니다.

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

height
유형: number
사진의 높이입니다(픽셀 단위).
html_attributions
유형: Array<string>
이 사진의 저작자 표시 텍스트입니다.
width
유형: number
사진의 너비입니다(픽셀 단위).
getUrl
getUrl([opts])
매개변수:
반환 값: string
지정된 옵션에 해당하는 이미지 URL을 반환합니다.

PhotoOptions 인터페이스

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

사진 요청 옵션을 정의합니다.

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

maxHeight optional
유형: number optional
반환된 이미지의 최대 높이(픽셀)입니다.
maxWidth optional
유형: number optional
반환된 이미지의 최대 너비(픽셀)입니다.

PlaceReview 인터페이스

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

장소의 단일 리뷰를 나타냅니다.

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

author_name
유형: string
리뷰 작성자의 이름입니다.
language
유형: string
리뷰가 작성된 언어를 나타내는 IETF 언어 코드입니다. 이 코드에는 국가 또는 지역을 나타내는 보조 태그가 없는 기본 언어 태그만 포함됩니다. 예를 들어 모든 영어 리뷰에 '&-AU-#' 또는 'en-UK''가 아닌 'en'로 태그가 지정됩니다.
profile_photo_url
유형: string
복구자의 프로필 이미지 URL입니다.
relative_time_description
유형: string
언어 및 국가에 적합한 형식으로 현재 시간을 기준으로 한 검토 시간을 표현하는 형식이 지정된 최근 시간 문자열입니다. 예: "a month ago"
text
유형: string
리뷰 텍스트입니다.
time
유형: number
리뷰의 타임스탬프로, 에포크 이후 초 단위로 표시됩니다.
aspects optional
유형: Array<PlaceAspectRating> optional
리뷰 평점입니다. 0~3 사이의 척도입니다.
author_url optional
유형: string optional
리뷰 작성자 프로필의 URL입니다. 리뷰 작성자의 프로필을 사용할 수 없는 경우 undefined입니다.
rating optional
유형: number optional
이 리뷰의 평점으로, 1.0에서 5.0 사이의 값입니다.