Maps

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Map 클래스

google.maps.Map 클래스

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

Map
Map(mapDiv[, opts])
매개변수:
  • mapDivHTMLElement 이 요소를 채우기 위해 지도가 렌더링됩니다.
  • opts: MapOptions optional 옵션
지정된 HTML 컨테이너 내부에 일반적으로 DIV 요소인 새 지도를 만듭니다.
controls
지도에 연결할 추가 컨트롤입니다. 지도에 컨트롤을 추가하려면 렌더링되어야 하는 ControlPosition에 해당하는 MVCArray에 컨트롤의 <div>를 추가합니다.
data
유형: Data
지도에 바인딩된 Data의 인스턴스 이 지도에 표시할 수 있도록 이 Data 객체에 지형지물을 추가합니다.
mapTypes
문자열 ID별 MapType 인스턴스의 레지스트리입니다.
overlayMapTypes
유형: MVCArray<MapType optional>
오버레이에 대한 추가 지도 유형입니다. 오버레이 지도 유형은 연결된 기본 지도 위에 overlayMapTypes 배열에 표시된 순서대로 표시됩니다 (색인 값이 더 높은 오버레이는 색인 값이 낮은 오버레이 앞에 표시됨).
fitBounds
fitBounds(bounds[, padding])
매개변수:
  • bounds: LatLngBounds|LatLngBoundsLiteral 표시할 경계입니다.
  • padding: number|Padding optional 패딩(단위: 픽셀)입니다. 경계는 지도에서 패딩이 제거된 후에도 남아 있는 부분에 맞습니다. 숫자 값은 모든 4면에서 동일한 패딩을 생성합니다. getBounds의 결과에서 fitBounds가 멱등성이 되도록 여기에 0을 제공합니다.
반환 값: 없음
지정한 경계를 포함하도록 뷰포트를 설정합니다.
참고: 지도가 display: none로 설정되면 fitBounds 함수는 0x0으로 지도의 크기를 읽으므로 아무것도 하지 않습니다. 지도가 숨겨진 상태에서 표시 영역을 변경하려면 지도를 visibility: hidden로 설정하여 지도 div의 실제 크기가 확보되도록 합니다. 벡터 지도의 경우 이 메서드는 지도의 기울기 및 방향을 기본값인 0으로 설정합니다.
getBounds
getBounds()
매개변수: 없음
반환 값: LatLngBounds|undefined 현재 표시 영역의 위도/경도 경계입니다.
현재 뷰포트의 lat/lng 경계를 반환합니다. 세계의 사본이 두 개 이상 표시되면 경계의 범위는 경도 -180도 이상 180도 이하로 설정됩니다. 지도가 아직 초기화되지 않았거나 가운데 및 확대/축소가 설정되지 않은 경우 결과는 undefined입니다. 기울기 또는 방향이 0이 아닌 벡터 지도에서 반환된 위도/경도 경계는 지도의 표시 영역의 표시 영역을 포함하는 가장 작은 경계 상자를 나타냅니다. 지도의 표시 영역의 정확한 표시 영역을 가져오는 방법은 MapCanvasProjection.getVisibleRegion를 참고하세요.
getCenter
getCenter()
매개변수: 없음
반환 값: LatLng|undefined
지도의 중앙에 표시되는 위치를 반환합니다. 이 LatLng 객체는 래핑되지 않습니다. 자세한 내용은 LatLng을 참고하세요. 중심 또는 경계가 설정되지 않은 경우 결과는 undefined입니다.
getClickableIcons
getClickableIcons()
매개변수: 없음
반환 값: boolean|undefined
지도 아이콘의 클릭 가능 여부를 반환합니다. 지도 아이콘은 관심 장소(POI)를 나타냅니다. 반환된 값이 true이면 지도에서 아이콘을 클릭할 수 있습니다.
getDiv
getDiv()
매개변수: 없음
반환 값: HTMLElement 지도의 mapDiv.
BetagetFeatureLayer
getFeatureLayer(featureType)
매개변수:
반환 값: FeatureLayer
특정 FeatureTypeFeatureLayer를 반환합니다. Google Cloud Console에서 FeatureLayer을 사용 설정해야 합니다. 지정된 FeatureTypeFeatureLayer가 이 지도에 없거나 데이터 기반 스타일 지정을 사용할 수 없는 경우 (지도 ID, 벡터 타일 또는 지도 스타일에서 FeatureLayer이 사용 설정되지 않음) 오류는 로깅되고 이에 따른 FeatureLayer.isAvailable는 false입니다.
getHeading
getHeading()
매개변수: 없음
반환 값: number|undefined
지도의 나침반 방향을 반환합니다. 방향 값은 기본 방위 북쪽에서 시계 방향으로 도 단위로 측정됩니다. 지도가 아직 초기화되지 않았다면 결과가 undefined입니다.
BetagetMapCapabilities
getMapCapabilities()
매개변수: 없음
반환 값: MapCapabilities
제공된 지도 ID를 기반으로 지도에 현재 사용할 수 있는 기능을 호출자에게 알립니다.
getMapTypeId
getMapTypeId()
매개변수: 없음
반환 값: MapTypeId|string|undefined
getProjection
getProjection()
매개변수: 없음
반환 값: Projection|undefined
현재 Projection를 반환합니다. 지도가 아직 초기화되지 않았다면 결과가 undefined입니다. projection_changed 이벤트를 수신 대기하고 값이 undefined이 아닌지 확인합니다.
getRenderingType
getRenderingType()
매개변수: 없음
반환 값: RenderingType
지도의 현재 RenderingType을 반환합니다.
getStreetView
getStreetView()
매개변수: 없음
반환 값: StreetViewPanorama 지도에 결합된 파노라마입니다.
지도에 바인딩된 기본 StreetViewPanorama를 반환합니다. 이 파노라마는 지도 내에 삽입된 기본 파노라마이거나 setStreetView()를 사용하여 설정된 파노라마일 수 있습니다. 지도의 streetViewControl에 대한 변경사항은 바인딩된 파노라마의 표시에 반영됩니다.
getTilt
getTilt()
매개변수: 없음
반환 값: number|undefined
지도의 현재 각도를 표시 영역과 지도 평면 사이의 각도로 반환합니다. 래스터 지도의 경우 오버헤드가 직접 촬영한 이미지의 경우 0, 45° 이미지의 경우 45이 됩니다. 이 메서드는 setTilt에서 설정한 값을 반환하지 않습니다. 자세한 내용은 setTilt을 참고하세요.
getZoom
getZoom()
매개변수: 없음
반환 값: number|undefined
지도의 확대/축소를 반환합니다. 확대/축소가 설정되지 않은 경우 결과는 undefined입니다.
moveCamera
moveCamera(cameraOptions)
매개변수:
반환 값: 없음
애니메이션 없이 지도의 카메라를 즉시 타겟 카메라 옵션으로 설정합니다.
panBy
panBy(x, y)
매개변수:
  • x: number x 방향으로 지도를 이동할 픽셀 수입니다.
  • y: number y 방향으로 지도를 이동할 픽셀 수입니다.
반환 값: 없음
지도의 중심을 지정한 거리만큼 변경합니다(픽셀 단위). 거리가 지도의 너비와 높이보다 작은 경우 전환이 부드럽게 애니메이션됩니다. 지도 좌표계는 x 값의 경우 서쪽에서 동쪽으로, y 값의 경우 북쪽에서 남쪽으로 증가합니다.
panTo
panTo(latLng)
매개변수:
반환 값: 없음
지도 중심을 지정된 LatLng로 변경합니다. 변경값이 지도의 너비와 높이보다 작은 경우 전환이 부드럽게 애니메이션됩니다.
panToBounds
panToBounds(latLngBounds[, padding])
매개변수:
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral 지도를 이동할 경계입니다.
  • padding: number|Padding optional 패딩(단위: 픽셀)입니다. 숫자 값은 모든 4면에서 동일한 패딩을 생성합니다. 기본값은 0입니다.
반환 값: 없음
주어진 LatLngBounds를 포함하는 데 필요한 최소 양만큼 지도를 이동합니다. 지도에서 경계가 있는 위치를 보장하지 않습니다. 단, {currentMapSizeInPx} - {padding} 내에서 최대한 많은 경계가 표시되도록 지도가 이동합니다. 래스터 및 벡터 지도의 경우 지도의 확대/축소, 기울기, 방향이 변경되지 않습니다.
setCenter
setCenter(latlng)
매개변수:
반환 값: 없음
setClickableIcons
setClickableIcons(value)
매개변수:
  • value: boolean
반환 값: 없음
지도 아이콘의 클릭 가능 여부를 지정합니다. 지도 아이콘은 관심 장소(POI)를 나타냅니다. 지도 아이콘의 클릭 가능 여부를 사용 중지하려면 이 메서드에 false 값을 전달합니다.
setHeading
setHeading(heading)
매개변수:
  • headingnumber
반환 값: 없음
기본 방향 북쪽에서부터 도 단위로 측정된 지도의 나침반 방향을 설정합니다. 래스터 지도의 경우 이 방법은 항공 사진에만 적용됩니다.
setMapTypeId
setMapTypeId(mapTypeId)
매개변수:
반환 값: 없음
setOptions
setOptions(options)
매개변수:
반환 값: 없음
setStreetView
setStreetView(panorama)
매개변수:
반환 값: 없음
StreetViewPanorama를 지도에 바인딩합니다. 이 파노라마는 기본 StreetViewPanorama를 재정의하여 지도가 지도 외부의 외부 파노라마에 바인딩되도록 합니다. 파노라마를 null로 설정하면 삽입된 기본 파노라마가 지도에 다시 바인딩됩니다.
setTilt
setTilt(tilt)
매개변수:
  • tiltnumber
반환 값: 없음
벡터 지도의 경우 입사각을 설정합니다. 허용되는 값은 지도의 확대/축소 수준에 따라 제한됩니다. 래스터 지도의 경우 지도의 입사각에 대한 자동 전환 동작을 조정합니다. 유일하게 허용되는 값은 045입니다. setTilt(0)를 사용하면 확대/축소 수준 및 표시 영역과 관계없이 지도에서 항상 0° 오버헤드 뷰가 사용됩니다. setTilt(45)는 현재 확대/축소 수준 및 표시 영역에서 45° 이미지를 사용할 수 있을 때마다 기울기 각도를 45°로 자동 전환하며, 45° 이미지를 사용할 수 없을 때마다 0으로 다시 전환합니다 (기본 동작). 45° 이미지는 일부 위치 및 일부 확대/축소 수준에서 satellitehybrid 지도 유형에만 사용할 수 있습니다. 참고: getTiltsetTilt로 설정된 값이 아니라 현재 기울기 각도를 반환합니다. getTiltsetTilt는 서로 다른 것을 참조하므로 tilt 속성을 bind()하지 마세요. 사용하면 예기치 않은 결과가 발생할 수 있습니다.
setZoom
setZoom(zoom)
매개변수:
  • zoom: number 확대/축소 값이 클수록 해상도가 높습니다.
반환 값: 없음
지도의 확대/축소를 설정합니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
DEMO_MAP_ID 지도 ID가 필요한 코드 샘플에 사용할 수 있는 지도 ID입니다. 이 지도 ID는 프로덕션 애플리케이션에서 사용하기 위한 것이 아니며 클라우드 구성과 같은 클라우드 구성이 필요한 기능에는 사용할 수 없습니다.
bounds_changed
function()
인수: 없음
이 이벤트는 표시 영역 경계가 변경되면 시작됩니다.
center_changed
function()
인수: 없음
이 이벤트는 지도 중심 속성이 변경되면 시작됩니다.
click
function(event)
인수:
이 이벤트는 사용자가 지도를 클릭하면 시작됩니다. 장소 아이콘에 클릭이 발생하지 않은 경우 클릭된 위치의 속성이 포함된 MapMouseEvent가 반환됩니다. 이 경우 장소 ID가 있는 IconMouseEvent가 반환됩니다. IconMouseEvent와 MapMouseEvent는 동일하지만 IconMouseEvent가 장소 ID 필드가 있다는 점이 다릅니다. 이 이벤트는 장소 ID가 중요하지 않은 경우 언제든지 MapMouseEvent로 처리될 수 있습니다. 마커 또는 정보 창을 클릭하면 클릭 이벤트가 실행되지 않습니다.
contextmenu
function(event)
인수:
이 이벤트는 지도 컨테이너에서 DOM 컨텍스트 메뉴 이벤트가 시작되면 시작됩니다.
dblclick
function(event)
인수:
이 이벤트는 사용자가 지도를 더블클릭하면 시작됩니다. 이 이벤트 직전에 click 이벤트도 시작됩니다.
drag
function()
인수: 없음
이 이벤트는 사용자가 지도를 드래그하는 동안 반복하여 시작됩니다.
dragend
function()
인수: 없음
이 이벤트는 사용자가 지도 드래그를 중지하면 시작됩니다.
dragstart
function()
인수: 없음
이 이벤트는 사용자가 지도 드래그를 시작하면 시작됩니다.
heading_changed
function()
인수: 없음
이 이벤트는 지도 방위 속성이 변경되면 시작됩니다.
idle
function()
인수: 없음
이 이벤트는 이동이나 확대/축소 후 지도가 유휴 상태가 되면 시작됩니다.
isfractionalzoomenabled_changed
function()
인수: 없음
이 이벤트는 isFractionalZoomEnabled 속성이 변경되면 시작됩니다.
Betamapcapabilities_changed
function()
인수: 없음
이 기능은 지도 기능이 변경되면 시작됩니다.
maptypeid_changed
function()
인수: 없음
이 이벤트는 mapTypeId 속성이 변경되면 시작됩니다.
mousemove
function(event)
인수:
이 이벤트는 사용자의 마우스가 지도 컨테이너로 이동하면 시작됩니다.
mouseout
function(event)
인수:
이 이벤트는 사용자의 마우스가 지도 컨테이너를 빠져나가면 시작됩니다.
mouseover
function(event)
인수:
이 이벤트는 사용자의 마우스가 지도 컨테이너로 들어가면 시작됩니다.
projection_changed
function()
인수: 없음
이 이벤트는 투영이 변경되면 시작됩니다.
renderingtype_changed
function()
인수: 없음
이 이벤트는 renderType이 변경되면 시작됩니다.
tilesloaded
function()
인수: 없음
이 이벤트는 표시된 타일 로드가 완료되면 시작됩니다.
tilt_changed
function()
인수: 없음
이 이벤트는 지도 기울기 속성이 변경되면 시작됩니다.
zoom_changed
function()
인수: 없음
이 이벤트는 지도 확대/축소 속성이 변경되면 시작됩니다.
rightclick
function(event)
인수:
이 이벤트는 사용자가 지도를 마우스 오른쪽 버튼으로 클릭하면 시작됩니다.

MapOptions 인터페이스

google.maps.MapOptions 인터페이스

지도에 설정할 수 있는 속성을 정의하는 데 사용되는 MapOptions 객체입니다.

backgroundColor optional
유형: string optional
지도 div의 배경에 사용되는 색상입니다. 사용자가 이동할 때 타일이 아직 로드되지 않은 경우 이 색상이 표시됩니다. 이 옵션은 지도가 초기화될 때만 설정할 수 있습니다.
center optional
유형: LatLng|LatLngLiteral optional
초기 지도 중심입니다.
clickableIcons optional
유형: boolean optional
기본값: true
false인 경우 지도 아이콘을 클릭할 수 없습니다. 지도 아이콘은 관심 장소(POI)를 나타냅니다.
controlSize optional
유형: number optional
지도에 표시되는 컨트롤의 픽셀 단위 크기입니다. 지도를 만들 때 이 값을 직접 제공해야 합니다. 이 값을 나중에 업데이트하면 컨트롤이 undefined 상태로 전환될 수 있습니다. 지도 API 자체에서 제어하는 컨트롤만 제어합니다. 개발자가 만든 맞춤 컨트롤은 확장되지 않습니다.
disableDefaultUI optional
유형: boolean optional
모든 기본 UI 버튼을 사용/사용 중지합니다. 개별적으로 재정의할 수 있습니다. MapOptions.keyboardShortcuts 옵션에 의해 별도로 제어되는 키보드 컨트롤은 사용 중지되지 않습니다. MapOptions.gestureHandling 옵션에 의해 별도로 제어되는 동작 컨트롤은 사용 중지되지 않습니다.
disableDoubleClickZoom optional
유형: boolean optional
더블클릭 시 확대/축소 및 중앙 배치를 활성화/비활성화합니다. 기본적으로 사용 설정됩니다.

참고: 이 속성은 권장하지 않습니다. 더블클릭 시 확대/축소를 사용 중지하려면 gestureHandling 속성을 사용하고 "none"로 설정합니다.

draggable optional
유형: boolean optional
false인 경우 지도가 드래그되지 않도록 합니다. 드래그는 기본적으로 사용 설정되어 있습니다.
draggableCursor optional
유형: string optional
드래그 가능한 지도 위로 마우스를 가져갈 때 표시할 커서의 이름 또는 URL입니다. 이 속성은 css cursor 속성을 사용하여 아이콘을 변경합니다. css 속성과 마찬가지로 URL이 아닌 대체 커서를 하나 이상 지정해야 합니다. 예를 들면 draggableCursor: 'url(http://www.example.com/icon.png), auto;'입니다.
draggingCursor optional
유형: string optional
지도를 드래그할 때 표시할 커서의 이름 또는 URL입니다. 이 속성은 css cursor 속성을 사용하여 아이콘을 변경합니다. css 속성과 마찬가지로 URL이 아닌 대체 커서를 하나 이상 지정해야 합니다. 예를 들면 draggingCursor: 'url(http://www.example.com/icon.png), auto;'입니다.
fullscreenControl optional
유형: boolean optional
전체 화면 컨트롤의 사용 설정/사용 중지 상태입니다.
fullscreenControlOptions optional
유형: FullscreenControlOptions optional
전체 화면 컨트롤의 표시 옵션입니다.
gestureHandling optional
유형: string optional
이 설정은 API가 지도에서 동작을 처리하는 방법을 제어합니다. 허용되는 값:
  • "cooperative": 스크롤 이벤트와 한 손가락으로 터치하면 페이지가 스크롤되며 지도를 확대/축소하거나 화면 이동을 할 수 없습니다. 지도의 두 손가락 터치 동작으로 화면을 이동하거나 확대/축소합니다. Ctrl 키 또는 ⌘ 키를 누른 상태에서 스크롤하면 지도가 확대/축소됩니다.
    이 모드에서는 지도가 페이지와 호환됩니다.
  • "greedy": 모든 터치 동작 및 스크롤 이벤트가 지도를 이동하거나 확대/축소합니다.
  • "none": 지도를 사용자 동작으로 이동하거나 확대/축소할 수 없습니다.
  • "auto": (기본값) 페이지 스크롤 가능 여부와 iframe 내 동작 여부에 따라 동작 처리가 협동 또는 탐정입니다.
heading optional
유형: number optional
기본 방위 북쪽에서 시계 방향으로 도 단위로 측정된 항공 사진의 방향입니다. 방향은 이미지를 표시할 수 있는 가장 가까운 사용 가능한 각도에 맞춰집니다.
isFractionalZoomEnabled optional
유형: boolean optional
기본값: 벡터 지도의 경우 true, 래스터 지도의 경우 false
지도에서 부분 확대/축소 수준을 허용해야 하는지를 나타냅니다. isfractionalzoomenabled_changed를 수신하여 언제 기본값이 설정되었는지 알아보세요.
keyboardShortcuts optional
유형: boolean optional
false인 경우 키보드로 지도를 제어하는 것을 방지합니다. 단축키는 기본적으로 사용 설정되어 있습니다.
mapId optional
유형: string optional
지도의 지도 ID입니다. 지도를 인스턴스화한 후에는 이 매개변수를 설정하거나 변경할 수 없습니다.
mapTypeControl optional
유형: boolean optional
지도 유형 컨트롤의 초기 사용/사용 중지 상태입니다.
mapTypeControlOptions optional
유형: MapTypeControlOptions optional
지도 유형 컨트롤의 초기 표시 옵션입니다.
mapTypeId optional
유형: MapTypeId|string optional
초기 지도 mapTypeId입니다. 기본값은 ROADMAP입니다.
maxZoom optional
유형: number optional
지도에 표시될 최대 줌레벨입니다. 생략하거나 null로 설정하면, 현재 지도 유형의 최대 확대/축소가 대신 사용됩니다. 유효한 확대/축소 값은 0부터 지원되는 최대 확대/축소 수준까지의 숫자입니다.
minZoom optional
유형: number optional
지도에 표시될 최소 줌레벨입니다. 생략하거나 null로 설정하면, 현재 지도 유형의 최소 확대/축소가 대신 사용됩니다. 유효한 확대/축소 값은 0부터 지원되는 최대 확대/축소 수준까지의 숫자입니다.
noClear optional
유형: boolean optional
true인 경우 지도 div의 콘텐츠를 지우지 마세요.
panControl optional
유형: boolean optional
화면 이동 컨트롤의 활성화/비활성화 상태입니다.

참고: Google Maps JavaScript API v3.22에 도입된 새로운 컨트롤 세트에서는 화면 이동 컨트롤을 사용할 수 없습니다. v3.22 및 v3.23을 사용하는 동안 새 컨트롤 대신 이전 컨트롤 세트를 사용하도록 선택할 수 있으므로 화면 이동 컨트롤이 이전 컨트롤 세트의 일부로 사용 가능합니다. v3.22 지도 컨트롤의 새로운 기능을 참고하세요.

panControlOptions optional
유형: PanControlOptions optional
화면 이동 컨트롤의 표시 옵션입니다.

참고: Google Maps JavaScript API v3.22에 도입된 새로운 컨트롤 세트에서는 화면 이동 컨트롤을 사용할 수 없습니다. v3.22 및 v3.23을 사용하는 동안 새 컨트롤 대신 이전 컨트롤 세트를 사용하도록 선택할 수 있으므로 화면 이동 컨트롤이 이전 컨트롤 세트의 일부로 사용 가능합니다. v3.22 지도 컨트롤의 새로운 기능을 참고하세요.

restriction optional
유형: MapRestriction optional
사용자가 액세스할 수 있는 지도 영역을 제한하는 경계를 정의합니다. 이 옵션을 설정하면 카메라 뷰가 경계 내에 있는 동안만 사용자가 화면을 이동하거나 확대/축소할 수 있습니다.
rotateControl optional
유형: boolean optional
회전 컨트롤의 활성화/비활성화 상태입니다.
rotateControlOptions optional
유형: RotateControlOptions optional
회전 컨트롤의 표시 옵션입니다.
scaleControl optional
유형: boolean optional
축척 컨트롤의 초기 활성화/비활성화 상태입니다.
scaleControlOptions optional
유형: ScaleControlOptions optional
축척 컨트롤의 초기 표시 옵션입니다.
scrollwheel optional
유형: boolean optional
false인 경우 마우스 스크롤 휠을 사용하여 지도 확대/축소를 사용 중지합니다. 스크롤휠은 기본적으로 사용하도록 설정됩니다.

참고: 이 속성은 권장하지 않습니다. 스크롤휠을 사용하여 확대/축소를 사용 중지하려면 gestureHandling 속성을 사용하고 "cooperative" 또는 "none"로 설정하세요.

streetView optional
유형: StreetViewPanorama optional
스트리트 뷰 페그맨이 지도에 드롭되면 표시할 StreetViewPanorama. 파노라마를 지정하지 않으면 페그맨이 드롭될 때 기본 StreetViewPanorama가 지도의 div에 표시됩니다.
streetViewControl optional
유형: boolean optional
스트리트 뷰 pegman 컨트롤의 초기 활성화/비활성화 상태입니다. 이 컨트롤은 기본 UI의 일부이며 스트리트 뷰 도로 오버레이가 표시되어서는 안 되는 지도 유형을 표시할 때 false로 설정해야 합니다 (예: 어스가 아닌 지도 유형).
streetViewControlOptions optional
유형: StreetViewControlOptions optional
스트리트 뷰 pegman 컨트롤의 초기 표시 옵션입니다.
styles optional
유형: Array<MapTypeStyle> optional
각 기본 지도 유형에 적용할 스타일 satellite/hybridterrain 모드의 경우 이러한 스타일은 라벨 및 도형에만 적용됩니다.
tilt optional
유형: number optional
벡터 지도의 경우 입사각을 설정합니다. 허용되는 값은 지도의 확대/축소 수준에 따라 제한됩니다. 래스터 지도의 경우 지도의 입사각에 대한 자동 전환 동작을 조정합니다. 유일하게 허용되는 값은 045입니다. 0 값을 사용하면 확대/축소 수준 및 표시 영역과 관계없이 지도에서 항상 0° 오버헤드 뷰가 사용됩니다. 45 값을 사용하면 현재 확대/축소 수준과 표시 영역에서 45° 이미지를 사용할 수 있을 때마다 기울기 각도가 45°로 자동 전환되고 45° 이미지를 사용할 수 없을 때마다 다시 0으로 전환됩니다 (기본 동작). 45° 이미지는 일부 위치 및 일부 확대/축소 수준에서 satellitehybrid 지도 유형에만 사용할 수 있습니다. 참고: getTilt는 이 옵션으로 지정된 값이 아니라 현재 기울기 각도를 반환합니다. getTilt와 이 옵션은 서로 다른 것을 참조하므로 tilt 속성을 bind()하지 마세요. 사용하면 예기치 않은 결과가 발생할 수 있습니다.
zoom optional
유형: number optional
초기 지도 확대/축소 수준입니다. 유효한 확대/축소 값은 0부터 지원되는 최대 확대/축소 수준까지의 숫자입니다. 확대/축소 값이 클수록 해상도가 높습니다.
zoomControl optional
유형: boolean optional
확대/축소 컨트롤의 활성화/비활성화 상태입니다.
zoomControlOptions optional
유형: ZoomControlOptions optional
확대/축소 컨트롤의 표시 옵션입니다.

gtagStyle 인터페이스

google.maps.MapTypeStyle 인터페이스

MapTypeStyle는 지도의 스타일을 지정하는 방식을 정의하는 선택기 및 스타일러의 모음입니다. 선택기는 영향을 받는 지도 지형지물 또는 요소를 지정하며 스타일러는 이러한 지형지물과 요소를 수정하는 방법을 지정합니다. 자세한 내용은 스타일 참조를 참고하세요.

stylers
유형: Array<Object>
선택한 지도 지형지물 및 요소에 적용할 스타일 규칙입니다. 규칙은 이 배열에 지정한 순서대로 적용됩니다. 사용법 및 허용 값에 관한 가이드라인은 스타일 참조를 참고하세요.
elementType optional
유형: string optional
스타일러를 적용해야 하는 요소입니다. 요소는 지도에서 지형지물의 시각적인 측면입니다. 예: 라벨, 아이콘, 도형에 적용된 획 또는 채우기 등 선택사항입니다. elementType을 지정하지 않으면 값이 'all'로 간주됩니다. 사용법 및 허용되는 값에 관한 자세한 내용은 스타일 참조를 참고하세요.
featureType optional
유형: string optional
스타일러를 적용해야 하는 특성 또는 특성 그룹입니다. 선택사항입니다. featureType을 지정하지 않으면 값이 'all'로 간주됩니다. 사용법 및 허용되는 값에 관한 자세한 내용은 스타일 참조를 참고하세요.

MapMouseEvent 인터페이스

google.maps.MapMouseEvent 인터페이스

이 객체는 지도 및 오버레이의 다양한 마우스 이벤트에서 반환되며 아래에 표시된 모든 필드를 포함합니다.

domEvent
해당하는 네이티브 DOM 이벤트입니다. 개발자는 정의되고 일관된 target, currentTarget, relatedTarget, path 속성을 사용해서는 안 됩니다. 또한 개발자는 지도 API 내부 구현의 DOM 구조에 의존해서는 안 됩니다. 내부 이벤트 매핑으로 인해 domEvent MapMouseEvent과는 다른 의미 체계를 사용할 수 있습니다 (예: MapMouseEvent "click"은 domEvent 유형의 KeyboardEvent일 수 있음).
latLng
유형: LatLng
이벤트가 발생했을 때 커서 아래에 있는 위도/경도입니다.
stop
stop()
매개변수: 없음
반환 값: 없음
이 이벤트가 더 이상 전파되지 않도록 합니다.

IconMouseEvent 인터페이스

google.maps.IconMouseEvent 인터페이스

이 객체는 사용자가 지도에서 아이콘을 클릭하면 이벤트에서 전송됩니다. 이 장소의 장소 ID는 placeId 멤버에 저장됩니다. 기본 정보 창이 표시되지 않도록 하려면 이 이벤트의 stop() 메서드를 호출하여 이벤트가 전파되지 않도록 합니다. Places API 개발자 가이드에서 장소 ID에 대해 자세히 알아보세요.

이 인터페이스는 MapMouseEvent를 확장합니다.

placeId optional
유형: string optional
클릭된 장소의 장소 ID입니다. 이 장소 ID는 클릭된 지형지물에 대한 자세한 정보를 쿼리하는 데 사용할 수 있습니다.

Places API 개발자 가이드에서 장소 ID에 대해 자세히 알아보세요.

상속됨: domEvent, latLng
상속됨: stop

gtagId 상수

google.maps.MapTypeId 상수

일반 gtag의 식별자입니다. 값 또는 상수 이름을 사용하여 지정하세요. 예를 들면 'satellite' 또는 google.maps.MapTypeId.SATELLITE이 있습니다.

HYBRID 이 지도 유형은 위성 이미지에 있는 주요 거리의 투명 레이어를 표시합니다.
ROADMAP 이 지도 유형은 일반 거리 지도를 표시합니다.
SATELLITE 이 지도 유형은 위성 이미지를 표시합니다.
TERRAIN 이 지도 유형은 지형 및 초목과 같이 물리적인 지형지물이 있는 지도를 표시합니다.

DockerfileRegistry 클래스

google.maps.MapTypeRegistry 클래스

gtag 인스턴스의 키이며 gtag ID로 키가 지정됩니다.

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

MapTypeRegistry
MapTypeRegistry()
매개변수: 없음
MapTypeRegistry는 지도에서 사용할 수 있는 맞춤 지도 유형의 컬렉션을 보유합니다. 예를 들어 API는 컨트롤 내에 사용 가능한 지도 유형 목록을 제공할 때 이 레지스트리를 참조합니다.
set
set(id, mapType)
매개변수:
  • idstring 레지스트리에 추가할 gtag의 식별자입니다.
  • mapTypeMapType|* gtag 객체로 레지스트리에 추가합니다.
반환 값: 없음
전달된 문자열 식별자를 전달된 MapType과 연결하기 위해 레지스트리를 설정합니다.
상속됨: addListener, bindTo, get, notify, setValues, unbind, unbindAll

MapRestriction 인터페이스

google.maps.MapRestriction 인터페이스

지도에 적용할 수 있는 제한사항입니다. 지도의 표시 영역은 이 제한을 초과하지 않습니다.

latLngBounds
설정되면 사용자가 지정된 경계 내에서만 화면 이동 및 확대/축소할 수 있습니다. 경계는 경도와 위도를 모두 제한하거나 위도만 제한할 수 있습니다. 위도 전용 경계의 경우 각각 -180과 180의 서쪽 및 경도를 사용합니다(예: latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}).
strictBounds optional
유형: boolean optional
strictBounds 플래그를 true로 설정하여 경계를 더 제한할 수 있습니다. 이렇게 하면 사용자가 축소할 수 있는 범위가 줄어들어 제한된 경계 외부의 모든 항목이 숨겨집니다. 기본값은 false이며, 사용자는 제한된 영역 전체가 표시될 때까지 축소할 수 있습니다. 제한된 영역 외부의 영역이 포함될 수도 있습니다.

TrafficLayer 클래스

google.maps.TrafficLayer 클래스

교통정보 레이어입니다.

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

TrafficLayer
TrafficLayer([opts])
매개변수:
현재 도로 교통정보를 표시하는 레이어입니다.
getMap
getMap()
매개변수: 없음
반환 값: Map
이 레이어가 표시되는 지도를 반환합니다.
setMap
setMap(map)
매개변수:
반환 값: 없음
지정된 지도에서 레이어를 렌더링합니다. 지도를 null로 설정하면 레이어가 삭제됩니다.
setOptions
setOptions(options)
매개변수:
반환 값: 없음
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

TrafficLayerOptions 인터페이스

google.maps.TrafficLayerOptions 인터페이스

TrafficLayer에 설정할 수 있는 속성을 정의하는 데 사용되는 TrafficLayerOptions 객체입니다.

autoRefresh optional
유형: boolean optional
기본값: true
교통정보 레이어가 자동으로 업데이트된 정보로 새로고침되는지를 나타냅니다.
map optional
유형: Map optional
교통정보 레이어를 표시할 지도입니다.

TransitLayer 클래스

google.maps.TransitLayer 클래스

대중교통 레이어

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

TransitLayer
TransitLayer()
매개변수: 없음
대중교통 노선을 표시하는 레이어입니다.
getMap
getMap()
매개변수: 없음
반환 값: Map
이 레이어가 표시되는 지도를 반환합니다.
setMap
setMap(map)
매개변수:
반환 값: 없음
지정된 지도에서 레이어를 렌더링합니다. 지도를 null로 설정하면 레이어가 삭제됩니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

BicyclingLayer 클래스

google.maps.BicyclingLayer 클래스

자전거 도로와 경로를 표시하는 레이어입니다.

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

BicyclingLayer
BicyclingLayer()
매개변수: 없음
자전거 도로와 경로를 표시하고 큰 도로의 순위를 낮추는 레이어입니다.
getMap
getMap()
매개변수: 없음
반환 값: Map
이 레이어가 표시되는 지도를 반환합니다.
setMap
setMap(map)
매개변수:
반환 값: 없음
지정된 지도에서 레이어를 렌더링합니다. 지도를 null로 설정하면 레이어가 삭제됩니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

CameraOptions 인터페이스

google.maps.CameraOptions 인터페이스

지도의 카메라 옵션을 설정하는 데 사용됩니다.

center optional
유형: LatLngLiteral|LatLng optional
heading optional
유형: number optional
tilt optional
유형: number optional
zoom optional
유형: number optional

VisibleRegion 인터페이스

google.maps.VisibleRegion 인터페이스

지도의 보이는 영역인 4면 다각형을 정의하는 4개의 지점을 포함합니다. 벡터 지도에서 기울기가 있는 경우 벡터 지도에서 이 다각형은 사다리꼴이 될 수 있습니다.

farLeft
유형: LatLng
farRight
유형: LatLng
latLngBounds
유형: LatLngBounds
표시되는 영역을 포함하는 가장 작은 경계 상자입니다.
nearLeft
유형: LatLng
nearRight
유형: LatLng

RenderingType 상수

google.maps.RenderingType 상수

RASTER 지도가 래스터 지도임을 나타냅니다.
UNINITIALIZED 지도 초기화가 완료되지 않아 지도가 벡터인지 래스터인지 아직 알 수 없음을 나타냅니다.
VECTOR 지도가 벡터 지도임을 나타냅니다.

MapCapabilities 인터페이스

google.maps.MapCapabilities 인터페이스

현재 지도에 사용할 수 있는 기능의 스냅샷을 포함하는 객체입니다. 가능한 기능 목록은 속성을 참조하세요.

BetaisDataDrivenStylingAvailable optional
유형: boolean optional