공지사항: 새로운 기본 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트, 현대화된 핀, 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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])` 매개변수: `container`: `HTMLElement` `opts`: `StreetViewPanoramaOptions optional` 전달된 `StreetViewPanoramaOptions`로 파노라마를 만듭니다.

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

메서드
`focus`	`focus()` 매개변수: 없음 반환 값: 없음 이 `StreetViewPanorama`에 포커스를 설정합니다. `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\|null` 스트리트 뷰 파노라마의 현재 `LatLng` 위치를 반환합니다.
`getPov`	`getPov()` 매개변수: 없음 반환 값: `StreetViewPov` 스트리트뷰 파노라마의 현재 시점을 반환합니다.
`getStatus`	`getStatus()` 매개변수: 없음 반환 값: `StreetViewStatus` `setPosition()` 또는 `setPano()` 요청 완료 시 파노라마의 상태를 반환합니다.
`getVisible`	`getVisible()` 매개변수: 없음 반환 값: `boolean` 파노라마가 표시되면 `true`를 반환합니다. 지정된 위치에서 스트리트뷰 이미지의 사용 가능 여부를 지정하지는 않습니다.
`getZoom`	`getZoom()` 매개변수: 없음 반환 값: `number` 파노라마의 확대/축소 수준을 반환합니다. 완전히 축소된 상태는 시야가 180도인 수준 0입니다. 확대하면 확대/축소 수준이 높아집니다.
`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` 반환 값: 없음 파노라마의 확대/축소 수준을 설정합니다. 완전히 축소된 상태는 시야가 180도인 수준 0입니다. 확대하면 확대/축소 수준이 높아집니다.
상속: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

이벤트
`closeclick`	`function(event)` 인수: `event`: `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)을 사용합니다. 이 플래그와 함께 이미지를 올바르게 게재하는 것은 개발자의 과제이며, 그렇지 않으면 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을 반환해야 합니다.

메서드

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 클래스

google.maps.StreetViewCoverageLayer 클래스

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