Rendering

StreetViewPanorama 클래스

class google.maps.StreetViewPanorama extends MVCObject
library "streetView"

지정된 LatLng 또는 파노라마 ID의 파노라마를 표시합니다. StreetViewPanorama 객체는 별도의 <div> 내에서 독립형으로 사용하거나 Map에 바인딩할 수 있는 스트리트 뷰 '뷰어'를 제공합니다.

const {StreetViewPanorama} = await google.maps.importLibrary("streetView");

생성자
StreetViewPanorama	StreetViewPanorama(container[, opts]) 매개변수: container: HTMLElement opts: StreetViewPanoramaOptions optional 전달된 StreetViewPanoramaOptions를 사용하여 파노라마를 만듭니다.

속성
controls	유형: Array<MVCArray<HTMLElement>> 파노라마에 연결할 추가 컨트롤입니다. 파노라마에 컨트롤을 추가하려면 컨트롤의 <div>를 렌더링할 ControlPosition에 해당하는 MVCArray에 추가합니다.

메서드
focus	focus() 매개변수: 없음 반환 값: 없음 이 StreetViewPanorama에 포커스를 설정합니다. 이 메서드를 visible_changed 이벤트와 함께 사용하여 StreetViewPanorama에 포커스를 설정하기 전에 표시되는지 확인하는 것이 좋습니다. 표시되지 않는 StreetViewPanorama에는 포커스를 둘 수 없습니다.
getLinks	getLinks() 매개변수: 없음 반환 값: Array<StreetViewLink optional>|null 스트리트뷰 파노라마에 대한 탐색 링크 집합을 반환합니다.
getLocation	getLocation() 매개변수: 없음 반환 값: StreetViewLocation 현재 파노라마의 StreetViewLocation을 반환합니다.
getMotionTracking	getMotionTracking() 매개변수: 없음 반환 값: boolean 모션 추적기의 상태를 반환합니다. 사용자가 기기를 물리적으로 움직이고 브라우저에서 이를 지원하는 경우 true이면 스트리트 뷰 파노라마가 물리적 움직임을 추적합니다.
getPano	getPano() 매개변수: 없음 반환 값: string 스트리트뷰 파노라마의 현재 파노라마 ID를 반환합니다. 이 ID는 브라우저의 현재 세션 내에서만 안정적입니다.
getPhotographerPov	getPhotographerPov() 매개변수: 없음 반환 값: StreetViewPov 이 파노라마를 촬영할 때 사진작가의 방향과 피치를 반환합니다. 도로의 스트리트 뷰 파노라마의 경우 차량이 이동한 방향도 표시됩니다. 이 데이터는 pano_changed 이벤트 후에 사용할 수 있습니다.
getPosition	getPosition() 매개변수: 없음 반환 값: LatLng|null 스트리트 뷰 파노라마의 현재 LatLng 위치를 반환합니다.
getPov	getPov() 매개변수: 없음 반환 값: StreetViewPov 스트리트뷰 파노라마의 현재 시점을 반환합니다.
getStatus	getStatus() 매개변수: 없음 반환 값: StreetViewStatus setPosition() 또는 setPano() 요청이 완료되면 파노라마의 상태를 반환합니다.
getVisible	getVisible() 매개변수: 없음 반환 값: boolean 파노라마가 표시되면 true를 반환합니다. 지정된 위치에서 스트리트뷰 이미지의 사용 가능 여부를 지정하지는 않습니다.
getZoom	getZoom() 매개변수: 없음 반환 값: number 파노라마의 확대/축소 수준을 반환합니다. 완전히 축소된 상태는 레벨 0이며 시야는 180도입니다. 확대하면 확대/축소 수준이 높아집니다.
registerPanoProvider	registerPanoProvider(provider[, opt_options]) 매개변수: provider: function(string): (StreetViewPanoramaData optional) opt_options: PanoProviderOptions optional 반환 값: 없음 맞춤형 파노라마를 로드하도록 pano 변경 시 호출되는 맞춤형 파노라마 공급자를 설정합니다.
setLinks	setLinks(links) 매개변수: links: Array<StreetViewLink> 반환 값: 없음 스트리트 뷰 파노라마의 탐색 링크 집합을 설정합니다.
setMotionTracking	setMotionTracking(motionTracking) 매개변수: motionTracking: boolean 반환 값: 없음 모션 추적기의 상태를 설정합니다. 사용자가 기기를 물리적으로 움직이고 브라우저에서 이를 지원하는 경우 true이면 스트리트 뷰 파노라마가 물리적 움직임을 추적합니다.
setOptions	setOptions(options) 매개변수: options: StreetViewPanoramaOptions optional 반환 값: 없음 키-값 쌍의 컬렉션을 설정합니다.
setPano	setPano(pano) 매개변수: pano: string 반환 값: 없음 스트리트뷰 파노라마에 대한 현재 파노라마 ID를 설정합니다.
setPosition	setPosition(latLng) 매개변수: latLng: LatLng|LatLngLiteral optional 반환 값: 없음 스트리트 뷰 파노라마의 현재 LatLng 위치를 설정합니다.
setPov	setPov(pov) 매개변수: pov: StreetViewPov 반환 값: 없음 스트리트뷰 파노라마에 대한 시점을 설정합니다.
setVisible	setVisible(flag) 매개변수: flag: boolean 반환 값: 없음 파노라마를 표시하려면 true로 설정합니다. false로 설정하면 파노라마가 지도에 삽입되어 있든 자체 <div>에 삽입되어 있든 숨겨집니다.
setZoom	setZoom(zoom) 매개변수: zoom: number 반환 값: 없음 파노라마의 확대/축소 수준을 설정합니다. 완전히 축소된 상태는 레벨 0이며 시야는 180도입니다. 확대하면 확대/축소 수준이 높아집니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

이벤트
closeclick	function(event) 인수: event: Event optional 이벤트가 트리거되었습니다. 이 이벤트는 닫기 버튼을 클릭하면 시작됩니다.
pano_changed	function() 인수: 없음 이 이벤트는 파노라마의 pano ID가 변경되면 시작됩니다. 사용자가 파노라마를 탐색하거나 위치를 수동으로 설정하면 pano가 변경될 수 있습니다. 모든 위치 변경이 pano_changed를 트리거하는 것은 아닙니다.
position_changed	function() 인수: 없음 이 이벤트는 파노라마의 위치가 변경되면 시작됩니다. 사용자가 파노라마를 탐색하거나 위치를 수동으로 설정하면 위치가 변경됩니다.
pov_changed	function() 인수: 없음 이 이벤트는 파노라마의 시점이 변경되면 시작됩니다. 피치, 확대/축소 또는 방향(heading)이 변경되면 시점도 변경됩니다.
resize	function() 인수: 없음 개발자는 div의 크기가 변경될 때 파노라마에서 이 이벤트를 트리거해야 합니다( google.maps.event.trigger(panorama, 'resize')).
status_changed	function() 인수: 없음 이 이벤트는 setPosition() 또는 setPano()를 통해 ID 또는 위치로 파노라마를 조회할 때마다 실행됩니다.
visible_changed	function() 인수: 없음 이 이벤트는 파노라마의 가시성이 변경되면 시작됩니다. 페그맨을 지도 위로 드래그하거나 닫기 버튼을 클릭하거나 setVisible()를 호출하면 공개 상태가 변경됩니다.
zoom_changed	function() 인수: 없음 이 이벤트는 파노라마의 확대/축소 수준이 변경될 때 실행됩니다.

StreetViewPanoramaOptions 인터페이스

인터페이스 google.maps.StreetViewPanoramaOptions

StreetViewPanorama 객체의 속성을 정의하는 옵션입니다.

속성
addressControl 선택사항	유형: boolean optional 주소 컨트롤의 활성화/비활성화 상태입니다.
addressControlOptions 선택사항	유형: StreetViewAddressControlOptions optional 주소 컨트롤의 표시 옵션입니다.
clickToGo 선택사항	유형: boolean optional 기본값: true 클릭하여 이동의 사용 설정/사용 중지 상태입니다. 맞춤 파노라마에는 적용되지 않습니다.
controlSize 선택사항	유형: number optional 파노라마에 표시되는 컨트롤의 크기(픽셀)입니다. 이 값은 파노라마를 만들 때 직접 제공해야 하며, 나중에 이 값을 업데이트하면 컨트롤이 정의되지 않은 상태가 될 수 있습니다. 지도 API 자체에서 만든 컨트롤만 제어합니다. 개발자가 만든 맞춤 컨트롤의 크기를 조정하지 않습니다.
disableDefaultUI 선택사항	유형: boolean optional 모든 기본 UI를 사용 설정/중지합니다. 개별적으로 재정의할 수 있습니다.
disableDoubleClickZoom 선택사항	유형: boolean optional 기본값: true 더블클릭 시 확대/축소를 활성화/비활성화합니다.
enableCloseButton 선택사항	유형: boolean optional 기본값: false true인 경우 닫기 버튼이 표시됩니다.
fullscreenControl 선택사항	유형: boolean optional 전체 화면 컨트롤의 사용 설정/사용 중지 상태입니다.
fullscreenControlOptions 선택사항	유형: FullscreenControlOptions optional 전체 화면 컨트롤의 표시 옵션입니다.
imageDateControl 선택사항	유형: boolean optional 이미지 촬영 날짜 컨트롤의 사용 설정/사용 중지 상태입니다. 기본적으로 사용 중지됩니다.
linksControl 선택사항	유형: boolean optional 링크 컨트롤의 활성화/비활성화 상태입니다.
motionTracking 선택사항	유형: boolean optional 모션 추적의 사용 설정 여부입니다. 모션 추적 컨트롤이 있고 사용자가 권한을 부여했거나 권한이 필요하지 않은 경우 기본적으로 사용 설정되므로 POV (시점)가 기기의 방향을 따릅니다. 이는 주로 휴대기기에 적용됩니다. motionTrackingControl가 사용 설정된 상태에서 motionTracking가 false로 설정되면 모션 추적 컨트롤이 표시되지만 추적은 사용 중지됩니다. 사용자는 모션 추적 컨트롤을 탭하여 이 옵션을 전환할 수 있습니다. 권한이 필요하지만 아직 요청되지 않은 상태에서 motionTracking가 true로 설정되면 모션 추적 컨트롤이 표시되지만 추적은 사용 중지됩니다. 사용자는 모션 추적 컨트롤을 탭하여 권한을 요청할 수 있습니다. 사용자가 권한을 거부한 상태에서 motionTracking가 true로 설정되면 모션 추적 컨트롤이 사용 중지된 상태로 표시되고 추적이 사용 중지됩니다.
motionTrackingControl 선택사항	유형: boolean optional 모션 추적 컨트롤의 사용 설정/사용 중지 상태입니다. 기기에 모션 데이터가 있는 경우 기본적으로 사용 설정되므로 컨트롤이 지도에 표시됩니다. 이는 주로 휴대기기에 적용됩니다.
motionTrackingControlOptions 선택사항	유형: MotionTrackingControlOptions optional 모션 추적 컨트롤의 표시 옵션입니다.
panControl 선택사항	유형: boolean optional 화면 이동 컨트롤의 활성화/비활성화 상태입니다.
panControlOptions 선택사항	유형: PanControlOptions optional 화면 이동 컨트롤의 표시 옵션입니다.
pano 선택사항	유형: string optional 맞춤형 파노라마를 지정할 때 설정해야 할 파노라마 ID입니다.
position 선택사항	유형: LatLng|LatLngLiteral optional 스트리트 뷰 파노라마의 LatLng 위치입니다.
pov 선택사항	유형: StreetViewPov optional 파노라마의 카메라 방향으로, 회전 및 피치로 지정됩니다.
scrollwheel 선택사항	유형: boolean optional 기본값: true false이면 스트리트 뷰에서 스크롤 휠 확대/축소가 사용 중지됩니다.
showRoadLabels 선택사항	유형: boolean optional 기본값: true 파노라마에 표시되는 도로 이름입니다. 이 값을 지정하지 않거나 true로 설정하면 파노라마에 도로 이름이 표시됩니다. false로 설정하면 거리 이름이 표시되지 않습니다.
visible 선택사항	유형: boolean optional true인 경우 스트리트 뷰 파노라마가 로드 시 표시됩니다.
zoom 선택사항	유형: number optional 파노라마의 확대/축소 수준으로, 숫자로 지정됩니다. 확대/축소 값이 0이면 시야가 180도입니다.
zoomControl 선택사항	유형: boolean optional 확대/축소 컨트롤의 활성화/비활성화 상태입니다.
zoomControlOptions 선택사항	유형: ZoomControlOptions optional 확대/축소 컨트롤의 표시 옵션입니다.

StreetViewAddressControlOptions 인터페이스

인터페이스 google.maps.StreetViewAddressControlOptions

스트리트뷰 주소 컨트롤의 렌더링에 대한 옵션입니다.

속성
position 선택사항	유형: ControlPosition optional 위치 ID입니다. 이 ID는 지도에 컨트롤의 위치를 지정하는 데 사용됩니다. 기본 위치는 TOP_LEFT입니다.

PanoProviderOptions 인터페이스

인터페이스 google.maps.PanoProviderOptions

커스텀 파노라마 제공업체의 옵션입니다.

속성
cors 선택사항	유형: boolean optional 설정하면 렌더러는 제공된 이미지에 cors 헤더가 적절하게 설정된 경우에만 작동하는 기술 (예: webgl)을 사용합니다. 이 플래그와 함께 이미지를 올바르게 제공하는 것은 개발자의 작업이며, 그렇지 않으면 SecurityErrors가 발생할 수 있습니다.

StreetViewTileData 인터페이스

인터페이스 google.maps.StreetViewTileData

스트리트뷰 파노라마에 사용된 타일 집합의 속성입니다.

속성
centerHeading	유형: number 파노라마 타일 중심에서의 방향입니다(도 단위).
tileSize	유형: Size 타일이 렌더링될 크기입니다(픽셀 단위).
worldSize	유형: Size 전체 파노라마 '세계'의 크기입니다(픽셀 단위).

메서드
getTileUrl	getTileUrl(pano, tileZoom, tileX, tileY) 매개변수: pano: string tileZoom: number tileX: number tileY: number 반환 값: string 지정한 타일에 대한 타일 이미지 URL을 가져옵니다. 맞춤 카드를 제공하기 위해 구현해야 하는 맞춤 메서드입니다. API는 이 메서드를 호출하여 다음 매개변수를 제공합니다. pano는 스트리트 뷰 타일의 파노라마 ID입니다. tileZoom은 타일의 확대/축소 수준입니다. tileX은 타일의 x 좌표입니다. tileY은 타일의 y 좌표입니다. 커스텀 메서드는 타일 이미지의 URL을 반환해야 합니다.

StreetViewPov 인터페이스

인터페이스 google.maps.StreetViewPov

스트리트뷰 파노라마의 위치에서 카메라의 방향을 정의하는 시점 객체입니다. 시점은 회전 및 피치로 정의됩니다.

속성
heading	유형: number true 북쪽을 기준으로 한 카메라 방향(도)입니다. 정북은 0°, 동은 90°, 남은 180°, 서는 270°입니다.
pitch	유형: number 스트리트 뷰 차량을 기준으로 한 카메라 피치입니다(도 단위). 90°(수직으로 위쪽)에서 -90°(수직으로 아래쪽)까지의 범위입니다.

StreetViewCoverageLayer 클래스

class google.maps.StreetViewCoverageLayer extends MVCObject
library "streetView"

스트리트 뷰가 제공되는 위치를 보여주는 레이어입니다.

const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView");

생성자
StreetViewCoverageLayer	StreetViewCoverageLayer() 매개변수: 없음 StreetViewCoverageLayer의 새 인스턴스를 만듭니다.

메서드
getMap	getMap() 매개변수: 없음 반환 값: Map|null 이 레이어가 표시되는 지도를 반환합니다.
setMap	setMap(map) 매개변수: map: Map optional 반환 값: undefined 지정된 지도에서 레이어를 렌더링합니다. 지도가 null로 설정되면 레이어가 삭제됩니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll