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])
매개변수:
전달된 StreetViewPanoramaOptions를 사용하여 파노라마를 만듭니다.
controls
파노라마에 연결할 추가 컨트롤입니다. 파노라마에 컨트롤을 추가하려면 컨트롤의 <div>를 렌더링할 ControlPosition에 해당하는 MVCArray에 추가합니다.
focus
focus()
매개변수: 없음
반환 값: 없음
이 StreetViewPanorama에 포커스를 설정합니다. 이 메서드를 visible_changed 이벤트와 함께 사용하여 StreetViewPanorama에 포커스를 설정하기 전에 표시되는지 확인하는 것이 좋습니다. 표시되지 않는 StreetViewPanorama에는 포커스를 둘 수 없습니다.
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])
매개변수:
반환 값: 없음
맞춤형 파노라마를 로드하도록 pano 변경 시 호출되는 맞춤형 파노라마 공급자를 설정합니다.
setMotionTracking
setMotionTracking(motionTracking)
매개변수:
  • motionTracking: boolean
반환 값: 없음
모션 추적기의 상태를 설정합니다. 사용자가 기기를 물리적으로 움직이고 브라우저에서 이를 지원하는 경우 true이면 스트리트 뷰 파노라마가 물리적 움직임을 추적합니다.
setOptions
setOptions(options)
매개변수:
반환 값: 없음
키-값 쌍의 컬렉션을 설정합니다.
setPano
setPano(pano)
매개변수:
  • pano: string
반환 값: 없음
스트리트뷰 파노라마에 대한 현재 파노라마 ID를 설정합니다.
setPosition
setPosition(latLng)
매개변수:
반환 값: 없음
스트리트 뷰 파노라마의 현재 LatLng 위치를 설정합니다.
setPov
setPov(pov)
매개변수:
반환 값: 없음
스트리트뷰 파노라마에 대한 시점을 설정합니다.
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
선택사항
주소 컨트롤의 표시 옵션입니다.
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
선택사항
모션 추적 컨트롤의 표시 옵션입니다.
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