Rendering

StreetViewPanorama 클래스

google.maps.StreetViewPanorama 클래스

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

이 클래스는 MVCObject를 확장합니다.

const {StreetViewPanorama} = await google.maps.importLibrary("streetView")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

StreetViewPanorama
StreetViewPanorama(container[, opts])
매개변수: 
전달된 StreetViewPanoramaOptions를 사용하여 파노라마를 만듭니다.
controls
파노라마에 연결할 추가 컨트롤입니다. 컨트롤을 파노라마에 추가하려면 렌더링되어야 하는 ControlPosition에 상응하는 MVCArray에 컨트롤의 <div>를 추가합니다.
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)
매개변수: 
  • motionTrackingboolean
반환 값: 없음
모션 추적기의 상태를 설정합니다. true 사용자가 물리적으로 기기를 이동하고 브라우저에서 지원하는 경우 스트리트 뷰 파노라마는 물리적 움직임을 추적합니다.
setOptions
setOptions(options)
매개변수: 
반환 값: 없음
키-값 쌍 컬렉션을 설정합니다.
setPano
setPano(pano)
매개변수: 
  • panostring
반환 값: 없음
스트리트뷰 파노라마에 대한 현재 파노라마 ID를 설정합니다.
setPosition
setPosition(latLng)
매개변수: 
반환 값: 없음
스트리트 뷰 파노라마의 현재 LatLng 위치를 설정합니다.
setPov
setPov(pov)
매개변수: 
반환 값: 없음
스트리트뷰 파노라마에 대한 시점을 설정합니다.
setVisible
setVisible(flag)
매개변수: 
  • flagboolean
반환 값: 없음
파노라마가 보이게 하려면 true로 설정합니다. false로 설정하면 파노라마가 지도에 삽입되거나 자체 <div>에 삽입되어 있는지 여부와 관계없이 숨겨집니다.
setZoom
setZoom(zoom)
매개변수: 
  • zoomnumber
반환 값: 없음
파노라마의 확대/축소 수준을 설정합니다. 완전히 축소하면 수준 0으로, 시야는 180도입니다. 확대하면 확대/축소 수준이 높아집니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function(event)
인수: 
  • eventEvent 이벤트가 트리거되었습니다.
이 이벤트는 닫기 버튼을 클릭하면 시작됩니다.
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 optional
유형:  boolean optional
주소 컨트롤의 활성화/비활성화 상태입니다.
addressControlOptions optional
주소 컨트롤의 표시 옵션입니다.
clickToGo optional
유형:  boolean optional
기본값: true
클릭하여 이동하는 사용/사용 중지 상태입니다. 맞춤 파노라마에는 적용되지 않습니다.
controlSize optional
유형:  number optional
파노라마에 표시되는 컨트롤의 픽셀 단위 크기입니다. 이 값은 파노라마를 만들 때 직접 제공되어야 합니다. 나중에 이 값을 업데이트하면 컨트롤이 정의되지 않은 상태로 전환될 수 있습니다. 지도 API 자체의 컨트롤만 제어합니다. 개발자가 만든 맞춤 컨트롤은 확장되지 않습니다.
disableDefaultUI optional
유형:  boolean optional
모든 기본 UI를 사용 설정/사용 중지합니다. 개별적으로 재정의할 수 있습니다.
disableDoubleClickZoom optional
유형:  boolean optional
기본값: true
더블클릭 시 확대/축소를 활성화/비활성화합니다.
enableCloseButton optional
유형:  boolean optional
기본값: false
true인 경우 닫기 버튼이 표시됩니다.
fullscreenControl optional
유형:  boolean optional
전체 화면 컨트롤의 사용 설정/사용 중지 상태입니다.
fullscreenControlOptions optional
유형:  FullscreenControlOptions optional
전체 화면 컨트롤의 표시 옵션입니다.
imageDateControl optional
유형:  boolean optional
이미지 획득 날짜 컨트롤의 사용 설정/사용 중지 상태입니다. 기본적으로 사용 중지되어 있습니다.
linksControl optional
유형:  boolean optional
링크 컨트롤의 활성화/비활성화 상태입니다.
motionTracking optional
유형:  boolean optional
모션 추적의 사용 설정 여부. 모션 추적 컨트롤이 있고 사용자가 권한을 부여한 경우에는 필요하지 않습니다. 따라서 POV (시점)가 기기의 방향을 따르도록 합니다. 이는 주로 휴대기기에 적용됩니다. motionTrackingControl가 사용 설정된 상태에서 motionTrackingfalse로 설정되면 모션 추적 컨트롤이 표시되지만 추적은 사용 중지되어 있습니다. 사용자는 모션 추적 컨트롤을 탭하여 이 옵션을 전환할 수 있습니다. 권한이 필요하지만 아직 요청되지 않은 상태에서 motionTrackingtrue로 설정된 경우 모션 추적 컨트롤이 표시되지만 추적은 사용 중지되어 있습니다. 사용자는 모션 추적 컨트롤을 탭하여 권한을 요청할 수 있습니다. 사용자가 권한을 거부하는 동안 motionTrackingtrue로 설정되면 추적이 사용 중지된 상태에서 모션 추적 컨트롤이 사용 중지됩니다.
motionTrackingControl optional
유형:  boolean optional
모션 추적 컨트롤의 활성화/비활성화 상태입니다. 기기에 모션 데이터가 있을 때 기본적으로 사용 설정되어 컨트롤이 지도에 표시됩니다. 이는 주로 휴대기기에 적용됩니다.
motionTrackingControlOptions optional
유형:  MotionTrackingControlOptions optional
모션 추적 컨트롤의 표시 옵션입니다.
panControl optional
유형:  boolean optional
화면 이동 컨트롤의 활성화/비활성화 상태입니다.
panControlOptions optional
유형:  PanControlOptions optional
화면 이동 컨트롤의 표시 옵션입니다.
pano optional
유형:  string optional
맞춤형 파노라마를 지정할 때 설정해야 할 파노라마 ID입니다.
position optional
유형:  LatLng|LatLngLiteral optional
스트리트 뷰 파노라마의 LatLng 위치입니다.
pov optional
유형:  StreetViewPov optional
방향 및 피치로 지정된 카메라 방향입니다. 파노라마입니다.
scrollwheel optional
유형:  boolean optional
기본값: true
false인 경우 스트리트 뷰에서 스크롤휠 확대/축소를 사용하지 않도록 설정합니다.
showRoadLabels optional
유형:  boolean optional
기본값: true
파노라마에 도로 이름이 표시되어 있습니다. 이 값이 지정되지 않거나 true로 설정되면, 거리 이름이 파노라마에 표시됩니다. false로 설정하면 거리 이름이 표시되지 않습니다.
visible optional
유형:  boolean optional
true인 경우 로드 시 스트리트 뷰 파노라마가 표시됩니다.
zoom optional
유형:  number optional
숫자로 지정된 파노라마의 확대/축소입니다. 확대/축소가 0이면 180도 시야가 제공됩니다.
zoomControl optional
유형:  boolean optional
확대/축소 컨트롤의 활성화/비활성화 상태입니다.
zoomControlOptions optional
유형:  ZoomControlOptions optional
확대/축소 컨트롤의 표시 옵션입니다.

StreetViewAddressControlOptions 인터페이스

google.maps.StreetViewAddressControlOptions 인터페이스

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

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

PanoProviderOptions 인터페이스

google.maps.PanoProviderOptions 인터페이스

맞춤 파노라마 사진 제공자를 위한 옵션입니다.

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

StreetViewTileData 인터페이스

google.maps.StreetViewTileData 인터페이스

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

centerHeading
유형:  number
파노라마 타일 중심에서의 방향입니다(도 단위).
tileSize
유형:  Size
타일이 렌더링될 크기입니다(픽셀 단위).
worldSize
유형:  Size
전체 파노라마 '세계'의 크기입니다(픽셀 단위).
getTileUrl
getTileUrl(pano, tileZoom, tileX, tileY)
매개변수: 
  • panostring
  • tileZoomnumber
  • tileXnumber
  • tileYnumber
반환 값:  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 클래스를 추가합니다.

google.maps.StreetViewCoverageLayer 클래스

스트리트 뷰를 사용할 수 있는 위치를 보여주는 레이어입니다.

이 클래스는 MVCObject를 확장합니다.

const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

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