Places Service (deprecated)

PlacesService 클래스

google.maps.places.PlacesService 클래스
라이브러리 "places"

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

const {PlacesService} = await google.maps.importLibrary("places");
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
선택사항
유형: Array<string> optional
세부정보 응답에 포함할 필드입니다. 요금이 청구됩니다. 필드를 지정하지 않거나 ['ALL']을 전달하면 사용 가능한 모든 필드가 반환되고 요금이 청구됩니다 (프로덕션 배포의 경우 권장되지 않음). 필드 목록은 PlaceResult를 참조하세요. 중첩 필드는 점 경로로 지정할 수 있습니다 (예: "geometry.location").
language
선택사항
유형: string optional
세부정보를 반환할 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
region
선택사항
유형: string optional
사용자 지역의 지역 코드입니다. 이는 반환되는 사진과 기타 항목에 영향을 미칠 수 있습니다. 지역 코드는 ccTLD ('최상위 도메인') 2자리 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (.co.uk)이지만 ISO 3166-1 코드는 'gb'입니다(엄밀히 말하면 'The United Kingdom of Great Britain and Northern Ireland'의 항목).
sessionToken
선택사항
유형: AutocompleteSessionToken optional
세부정보 요청을 자동 완성 세션과 번들로 묶는 데 사용되는 고유 참조입니다.

FindPlaceFromPhoneNumberRequest 인터페이스

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

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

FindPlaceFromQueryRequest 인터페이스

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

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

PlaceSearchRequest 인터페이스

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

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

TextSearchRequest 인터페이스

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

PlacesService에 전송할 텍스트 검색 요청입니다.
bounds
선택사항
장소를 검색할 때 결과에 편향을 적용하는 데 사용되는 경계입니다 (선택사항). bounds가 설정된 경우 location 및 radius는 모두 무시됩니다. 결과는 이 경계 내에 있는 장소로 제한되지 않지만, 경계 내에 있는 장소의 순위가 더 높습니다.
language
선택사항
유형: string optional
가능한 경우 이름과 주소를 반환할 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
location
선택사항
유형: LatLng|LatLngLiteral optional
장소를 검색할 때 결과에 편향을 적용하는 데 사용되는 영역의 중심입니다.
query
선택사항
유형: string optional
요청의 검색어입니다. 예를 들어 장소 이름 ('에펠탑'), 카테고리 뒤에 위치 이름 ('뉴욕의 피자'), 장소 이름 뒤에 위치 명확성 ('시드니의 스타벅스')이 올 수 있습니다.
radius
선택사항
유형: number optional
장소를 검색할 때 결과에 편향을 적용하는 데 사용되는 영역의 반경(미터)입니다.
region
선택사항
유형: string optional
결과를 편향시킬 지역 코드입니다. 지역 코드는 ccTLD ('최상위 도메인') 2자리 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 특별한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (.co.uk)이지만 ISO 3166-1 코드는 'gb'입니다(엄밀히 말하면 'The United Kingdom of Great Britain and Northern Ireland'의 항목).
type
선택사항
유형: string optional
지정된 유형의 장소를 검색합니다. 유형은 요청의 타겟 위치의 현지 언어로 번역되어 쿼리 문자열로 사용됩니다. 쿼리도 제공되면 현지화된 유형 문자열에 연결됩니다. 다른 유형의 결과는 응답에서 삭제됩니다. 이 필드를 사용하여 언어 및 지역과 무관한 카테고리 검색을 수행합니다. 유효한 유형은 여기에 나와 있습니다.

RankBy 상수

상수 google.maps.places.RankBy
라이브러리 "places"

PlaceSearchRequest의 순위 옵션입니다.

const {RankBy} = await google.maps.importLibrary("places");
DISTANCE 위치로부터의 거리를 기준으로 장소 검색 결과의 순위를 지정합니다.
PROMINENCE 장소 검색결과를 인기도에 따라 순위를 매깁니다.

LocationBias typedef

typedef google.maps.places.LocationBias

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

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

LocationRestriction typedef

typedef google.maps.places.LocationRestriction

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

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus 상수

상수 google.maps.places.PlacesServiceStatus
라이브러리 "places"

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

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 PlacesServiceStatusString 유형으로 정의됩니다.

const {PlacesServiceStatus} = await google.maps.importLibrary("places");
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
선택사항
이 장소 위치의 주소 구성요소 모음입니다. PlacesService.getDetails에서만 사용 가능합니다.
adr_address
선택사항
유형: string optional
adr 마이크로포맷으로 표현된 장소의 주소입니다. PlacesService.getDetails에서만 사용 가능합니다.
aspects
선택사항
유형: Array<PlaceAspectRating> optional
Google 및 Zagat 사용자 리뷰를 기반으로 한 이 장소의 평가된 측면입니다. 평점은 0~30점 척도로 구성됩니다.
business_status
선택사항
유형: BusinessStatus optional
장소가 비즈니스인 경우 장소의 영업 상태를 나타내는 플래그입니다 (장소가 영업 중인지, 임시 휴업 또는 폐업 상태인지 나타냄). 사용 가능한 데이터가 없으면 검색 또는 세부정보 응답에 플래그가 표시되지 않습니다.
formatted_address
선택사항
유형: string optional
장소의 전체 주소입니다.
formatted_phone_number
선택사항
유형: string optional
지역의 전화번호 규칙에 따라 형식이 지정된 장소의 전화번호입니다. PlacesService.getDetails에서만 사용 가능합니다.
geometry
선택사항
유형: PlaceGeometry optional
장소의 도형 관련 정보입니다.
html_attributions
선택사항
유형: Array<string> optional
이 장소 결과에 대해 표시할 저작자 표시 텍스트입니다. 사용 가능한 html_attributions는 요청된 fields에 관계없이 항상 반환되며 표시되어야 합니다.
icon
선택사항
유형: string optional
이 장소의 카테고리를 나타내는 데 사용할 수 있는 이미지 리소스의 URL입니다.
icon_background_color
선택사항
유형: string optional
장소 아이콘에 사용할 배경 색상입니다. PlaceResult.icon_mask_base_uri을 참고하세요.
icon_mask_base_uri
선택사항
유형: string optional
아이콘 마스크의 잘린 URL입니다. 끝에 파일 확장자 (예: .svg 또는 .png)를 추가하여 다양한 아이콘 유형에 액세스합니다.
international_phone_number
선택사항
유형: string optional
장소의 전화번호(국가 코드 포함 형식)입니다. 국제 형식에는 국가 코드가 포함되며 플러스(+) 기호가 접두사로 붙습니다. PlacesService.getDetails에서만 사용 가능합니다.
name
선택사항
유형: string optional
장소 이름입니다. 참고: 사용자가 입력한 장소의 경우 사용자가 입력한 원시 텍스트입니다. 악의적인 사용자가 이 데이터를 코드 삽입 공격의 벡터로 사용하려고 시도할 수 있으므로 이 데이터를 사용할 때는 주의하시기 바랍니다( http://en.wikipedia.org/wiki/Code_injection 참고).
opening_hours
선택사항
유형: PlaceOpeningHours optional
장소가 열리거나 닫히는 시간을 정의합니다.
permanently_closed
선택사항
유형: boolean optional
장소가 영구적으로 또는 일시적으로 폐쇄되었는지 여부를 나타내는 플래그입니다. 장소가 운영 중이거나 데이터를 사용할 수 없는 경우 응답에 플래그가 없습니다.
photos
선택사항
유형: Array<PlacePhoto> optional
이 장소의 사진입니다. 컬렉션에는 최대 10개의 PlacePhoto 객체가 포함됩니다.
place_id
선택사항
유형: string optional
장소의 고유 식별자입니다.
plus_code
선택사항
유형: PlacePlusCode optional
장소의 Open Location Code 또는 'Plus Code'를 정의합니다.
price_level
선택사항
유형: number optional
장소의 가격 수준(0~4점)입니다. 가격 수준은 다음과 같이 해석됩니다.
  • 0: 무료
  • 1: 저렴함
  • 2: 보통
  • 3: 비쌈
  • 4: 최고가
rating
선택사항
유형: number optional
이 장소에 대한 사용자 리뷰를 기반으로 한 평점(1.0~5.0)입니다.
reviews
선택사항
유형: Array<PlaceReview> optional
이 장소의 리뷰 목록입니다. PlacesService.getDetails에서만 사용 가능합니다.
types
선택사항
유형: Array<string> optional
이 장소에 대한 유형의 배열입니다(예: ["political", "locality"] 또는 ["restaurant", "establishment"]).
url
선택사항
유형: string optional
이 장소에 대한 공식 Google 페이지의 URL입니다. 장소에 대한 최상의 정보가 포함된 Google 소유 페이지입니다. PlacesService.getDetails에서만 사용 가능합니다.
user_ratings_total
선택사항
유형: number optional
이 장소의 PlaceResult.rating에 기여한 사용자 평점 수입니다.
utc_offset
선택사항
유형: number optional
장소의 현재 시간대와 UTC의 오프셋(분)입니다. 예를 들어 일광 절약 시간제가 적용되는 오스트레일리아 시드니는 UTC보다 11시간 빠르므로 utc_offset은 660입니다. UTC보다 늦은 시간대의 경우 오프셋은 음수입니다. 예를 들어 카보베르데의 utc_offset는 -60입니다. PlacesService.getDetails에서만 사용 가능합니다.
utc_offset_minutes
선택사항
유형: number optional
장소의 현재 시간대와 UTC의 오프셋(분)입니다. 예를 들어 일광 절약 시간제가 적용되는 오스트레일리아 시드니는 UTC보다 11시간 빠르므로 utc_offset_minutes은 660입니다. UTC보다 늦은 시간대의 경우 오프셋은 음수입니다. 예를 들어 카보베르데의 utc_offset_minutes는 -60입니다. PlacesService.getDetails에서만 사용 가능합니다.
vicinity
선택사항
유형: string optional
도로명, 번지, 지역은 포함하되 주/도, 우편번호, 국가는 포함되지 않은 장소의 단순화된 주소입니다. 예를 들어 Google 오스트레일리아 시드니 사무실의 vicinity 값은 "48 Pirrama Road, Pyrmont"입니다. PlacesService.getDetails에서만 사용 가능합니다.
website
선택사항
유형: 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
라이브러리 "places"

장소의 비즈니스 상태입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 BusinessStatusString 유형으로 정의됩니다.

const {BusinessStatus} = await google.maps.importLibrary("places");
CLOSED_PERMANENTLY 업체가 영구 폐업했습니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
CLOSED_TEMPORARILY 시설이 임시 휴업 중입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
FUTURE_OPENING 업체가 향후 영업을 시작할 예정입니다. 자세한 내용은 웹 서비스 문서를 참고하세요.
OPERATIONAL 업체가 운영 중이지만 현재 영업 중이 아닐 수도 있습니다. 자세한 내용은 웹 서비스 문서를 참고하세요.

PlaceGeometry 인터페이스

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

장소의 도형에 관한 정보를 정의합니다.
location
선택사항
유형: LatLng optional
장소의 위치입니다.
viewport
선택사항
유형: LatLngBounds optional
이 장소를 지도에 표시할 때 기본 표시 영역입니다. 장소의 기본 표시 영역을 알 수 없는 경우 이 속성은 null입니다. PlacesService.getDetails에서만 사용 가능합니다.

PlaceOpeningHours 인터페이스

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

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

PlaceOpeningHoursPeriod 인터페이스

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

장소의 영업시간에 관한 구조화된 정보를 정의합니다. 참고: 장소가 항상 열려 있는 경우 응답에서 close 섹션이 누락됩니다. 클라이언트는 항상 열려 있음을 값이 0인 day를 포함한 open 기간, 값이 "0000"인 time 그리고 close 없음으로 표시할 수 있습니다.
open
장소의 영업 시작 시간입니다.
close
선택사항
유형: PlaceOpeningHoursTime optional
장소의 영업 종료 시간입니다.

PlaceOpeningHoursTime 인터페이스

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

장소가 열리거나 닫히는 시간을 정의합니다.
day
유형: number
일요일부터 시작하는 [0, 6] 범위의 숫자로 표시되는 요일입니다. 예를 들어 2는 화요일을 의미합니다.
hours
유형: number
PlaceOpeningHoursTime.time의 시간(숫자, [0, 23] 범위)입니다. 장소의 시간대로 보고됩니다.
minutes
유형: number
PlaceOpeningHoursTime.time의 분을 [0, 59] 범위의 숫자로 나타낸 값입니다. 이 값은 장소의 시간대로 보고됩니다.
time
유형: string
24시간 'hhmm' 형식의 시간입니다. 값은 ["0000", "2359"] 범위에 있습니다. 시간은 장소의 시간대로 보고됩니다.
nextDate
선택사항
유형: 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

장소의 Open Location Code 또는 'Plus Code'를 정의합니다. Plus Code는 상세 주소가 없는 (건물에 번호가 지정되지 않거나 거리 이름이 없는) 장소의 상세 주소 대신 사용할 수 있습니다.
global_code
유형: string
1/8000도x1/8000도 영역의 Plus Code입니다. 예를 들면 다음과 같습니다. "8FVC9G8F+5W"
compound_code
선택사항
유형: string optional
처음 4자 (지역 번호)가 삭제되고 지역 설명으로 대체되는 1/8000도 x 1/8000도 영역의 Plus Code입니다. 예를 들면 다음과 같습니다. "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
선택사항
유형: number optional
반환된 이미지의 최대 높이(픽셀)입니다.
maxWidth
선택사항
유형: 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
리뷰의 타임스탬프이며 에포크 이후 초 단위로 표시됩니다.
aspects
선택사항
유형: Array<PlaceAspectRating> optional
리뷰에서 평가한 측면입니다. 0~3점 척도의 평점입니다.
author_url
선택사항
유형: string optional
리뷰 작성자의 프로필 URL입니다. 리뷰 작성자의 프로필을 사용할 수 없는 경우 undefined입니다.
rating
선택사항
유형: number optional
이 리뷰의 평점이며 1.0 이상 5.0 이하의 숫자입니다.