Places Service

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

PlacesService 클래스

google.maps.places.PlacesService 클래스

장소 검색 및 장소 세부정보 검색 관련 메서드가 포함되어 있습니다.

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

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

PlaceDetailsRequest 인터페이스

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

PlacesService로 전송될 장소 세부정보 쿼리입니다.

&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('최상위 도메인') 두 문자 값을 허용합니다. 대부분의 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
장소를 검색할 때 사용되는 편향입니다. 결과는 지정된 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
장소를 검색할 때 사용되는 편향입니다. 결과는 지정된 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
요청의 검색어입니다. 예를 들어, 장소 이름('에펠탑'), 카테고리 뒤에 위치 이름('뉴욕의 피자') 또는 장소 이름 다음에 위치 구분자(예: '서울 스타벅스')를 추가합니다.
radius optional
유형: number optional
장소를 검색할 때 결과를 바이어스하는 데 사용되는 영역의 반경(미터 단위)입니다.
region optional
유형: string optional
결과가 편중될 지역 코드입니다. 지역 코드는 ccTLD('최상위 도메인') 두 문자 값을 허용합니다. 대부분의 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의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {RankBy} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. 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의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {PlacesServiceStatus} = await google.map.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 인터페이스

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

&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의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {BusinessStatus} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. 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개의 문자열로 구성된 배열입니다. 장소 서비스는 현재 언어에 맞게 영업시간의 형식을 지정하고 현지화합니다. 이 배열에서 요소의 순서는 언어에 따라 다릅니다. 일부 언어는 월요일에 한 주를 시작하고 다른 언어는 일요일에 시작합니다. 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 섹션이 응답에서 누락됩니다. 클라이언트는 day 값이 포함된 0time 값이 "0000"이고 close는 없는 open 기간으로 상시 열려 있어야 한다고 신뢰할 수 있습니다.

&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
[0, 23] 범위의 숫자로 된 PlaceOpeningHoursTime.time의 시간입니다. 이는 장소의 시간대로 보고됩니다.
minutes
유형: number
PlaceOpeningHoursTime.time의 분을 [0, 59] 범위 내의 숫자로 표시한 것입니다. 이는 장소의 시간대로 보고됩니다.
time
유형: string
하루를 24시간 'hhmm' 형식으로 표현한 것입니다. 값의 범위는 ["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 인터페이스

장소의 공개 위치 코드 또는 '플러스 코드'를 정의합니다. 플러스 코드는 존재하지 않는 장소 (건물에 번호가 지정되지 않았거나 거리 이름이 지정되지 않은 경우)의 상세 주소를 대체하는 데 사용할 수 있습니다.

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

global_code
유형: string
1도의 1/8000도 또는 1/8000도인 더하기 코드입니다. 예를 들면 "8FVC9G8F+5W"입니다.
compound_code optional
유형: string optional
첫 번째 4자 (지역 번호)를 삭제하고 지역 설명으로 대체하는 도의 1/8000도와 1/8000 사이의 플러스 코드입니다. 예를 들면 "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 언어 코드입니다. 이 코드에는 국가 또는 지역을 나타내는 보조 태그가 없는 기본 언어 태그만 포함됩니다. 예를 들어 모든 영어 리뷰에 'en-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 포함)