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