Maps

지도 클래스

google.maps.Map 클래스

이 클래스는 MVCObject

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

메서드
fitBounds	fitBounds(bounds[, padding]) 매개변수:  bounds:  LatLngBounds|LatLngBoundsLiteral 표시할 경계입니다. padding:  number|Padding optional 픽셀 단위의 패딩입니다. 경계는 패딩이 삭제된 후에도 남아있는 지도 부분에 맞춰집니다. 숫자 값은 네 면 모두에 동일한 패딩을 생성합니다. 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이면 지도에서 아이콘을 클릭할 수 있습니다.
getDatasetFeatureLayer	getDatasetFeatureLayer(datasetId) 매개변수:  datasetId:  string 반환 값:  FeatureLayer 지정된 datasetId의 FeatureLayer를 반환합니다. 데이터 세트 ID는 Google Cloud 콘솔에서 구성해야 합니다. 데이터 세트 ID가 지도의 지도 스타일과 연결되어 있지 않거나 데이터 기반 스타일 지정을 사용할 수 없는 경우 (지도 ID, 벡터 타일이 없고, 데이터 기반 스타일 지정 지형지물 레이어 또는 지도 스타일에 구성된 데이터 세트가 없음) 오류가 로깅되며 그 결과로 발생하는 FeatureLayer.isAvailable는 false가 됩니다.
getDiv	getDiv() 매개변수: 없음 반환 값:  HTMLElement 지도의 mapDiv.
getFeatureLayer	getFeatureLayer(featureType) 매개변수:  featureType:  FeatureType 반환 값:  FeatureLayer 특정 FeatureType의 FeatureLayer를 반환합니다. Google Cloud 콘솔에서 FeatureLayer를 사용 설정해야 합니다. 지정된 FeatureType의 FeatureLayer가 이 지도에 없거나 데이터 기반 스타일 지정을 사용할 수 없는 경우 (지도 ID, 벡터 타일, 지도 스타일에 사용 설정된 FeatureLayer가 없음) 오류가 로깅되며 그 결과 FeatureLayer.isAvailable는 false가 됩니다.
getHeading	getHeading() 매개변수: 없음 반환 값:  number|undefined 지도의 나침반 방향을 반환합니다. 방향 값은 기본 방위 북쪽에서 시계 방향으로 도 단위로 측정됩니다. 지도가 아직 초기화되지 않은 경우 결과는 undefined입니다.
getHeadingInteractionEnabled	getHeadingInteractionEnabled() 매개변수: 없음 반환 값:  boolean|null 제목 상호작용의 사용 설정 여부를 반환합니다. 이 옵션은 지도가 벡터 지도인 경우에만 적용됩니다. 코드에서 설정되지 않은 경우 지도 ID의 클라우드 구성이 사용됩니다 (사용 가능한 경우).
getMapCapabilities	getMapCapabilities() 매개변수: 없음 반환 값:  MapCapabilities 제공된 지도 ID를 기반으로 지도에서 사용할 수 있는 현재 기능을 호출자에게 알립니다.
getMapTypeId	getMapTypeId() 매개변수: 없음 반환 값:  MapTypeId|string|undefined
getProjection	getProjection() 매개변수: 없음 반환 값:  Projection|undefined 현재 Projection를 반환합니다. 지도가 아직 초기화되지 않은 경우 결과는 undefined입니다. projection_changed 이벤트를 수신 대기하고 값이 undefined가 아닌지 확인합니다.
getRenderingType	getRenderingType() 매개변수: 없음 반환 값:  RenderingType 지도의 현재 renderType을 반환합니다.
getStreetView	getStreetView() 매개변수: 없음 반환 값:  StreetViewPanorama 지도에 바인딩된 파노라마입니다. 지도에 바인딩된 기본 StreetViewPanorama를 반환합니다. 이 파노라마는 지도에 삽입된 기본 파노라마이거나 setStreetView()를 사용하여 설정된 파노라마일 수 있습니다. 지도의 streetViewControl에 대한 변경사항은 바인딩된 파노라마의 표시에 반영됩니다.
getTilt	getTilt() 매개변수: 없음 반환 값:  number|undefined 표시 영역 면에서 지도 면까지 지도의 현재 입사각을 도 단위로 반환합니다. 래스터 지도의 경우 직접 위에서 촬영한 이미지의 경우 0, 45° 이미지의 경우 45가 표시됩니다. 이 메서드는 setTilt에서 설정한 값을 반환하지 않습니다. 자세한 내용은 setTilt 페이지를 참고하세요.
getTiltInteractionEnabled	getTiltInteractionEnabled() 매개변수: 없음 반환 값:  boolean|null 기울이기 상호작용의 사용 여부를 반환합니다. 이 옵션은 지도가 벡터 지도인 경우에만 적용됩니다. 코드에서 설정되지 않은 경우 지도 ID의 클라우드 구성이 사용됩니다 (사용 가능한 경우).
getZoom	getZoom() 매개변수: 없음 반환 값:  number|undefined 지도의 확대/축소를 반환합니다. 확대/축소가 설정되지 않은 경우 결과는 undefined입니다.
moveCamera	moveCamera(cameraOptions) 매개변수:  cameraOptions:  CameraOptions 반환 값: 없음 애니메이션 없이 지도의 카메라를 대상 카메라 옵션으로 즉시 설정합니다.
panBy	panBy(x, y) 매개변수:  x:  number 지도를 x 방향으로 이동할 픽셀 수입니다. y:  number 지도를 y 방향으로 이동할 픽셀 수입니다. 반환 값: 없음 지도의 중심을 지정한 거리만큼 변경합니다(픽셀 단위). 거리가 지도의 너비와 높이보다 작은 경우 전환이 부드럽게 애니메이션됩니다. 지도 좌표계는 x 값의 경우 서쪽에서 동쪽으로, y 값의 경우 북쪽에서 남쪽으로 증가합니다.
panTo	panTo(latLng) 매개변수:  latLng:  LatLng|LatLngLiteral 지도의 새로운 중앙 위도/경도입니다. 반환 값: 없음 지도의 중심을 지정된 LatLng로 변경합니다. 변경값이 지도의 너비와 높이보다 작은 경우 전환이 부드럽게 애니메이션됩니다.
panToBounds	panToBounds(latLngBounds[, padding]) 매개변수:  latLngBounds:  LatLngBounds|LatLngBoundsLiteral 지도를 이동할 경계입니다. padding:  number|Padding optional 픽셀 단위의 패딩입니다. 숫자 값은 네 면 모두에 동일한 패딩을 생성합니다. 기본값은 0입니다. 반환 값: 없음 지정된 LatLngBounds를 포함하는 데 필요한 최소 양만큼 지도를 이동합니다. {currentMapSizeInPx} - {padding} 내부에서 최대한 많은 경계를 표시하도록 지도가 화면 이동된다는 점을 제외하고 지도에서 경계의 위치를 보장하지 않습니다. 래스터 지도와 벡터 지도에서 모두 지도의 확대/축소, 기울기 및 방향은 변경되지 않습니다.
setCenter	setCenter(latlng) 매개변수:  latlng:  LatLng|LatLngLiteral 반환 값: 없음
setClickableIcons	setClickableIcons(value) 매개변수:  value:  boolean 반환 값: 없음 지도 아이콘을 클릭할 수 있는지 여부를 제어합니다. 지도 아이콘은 관심 장소(POI라고도 함)를 나타냅니다. 지도 아이콘의 클릭 가능성을 사용 중지하려면 false 값을 이 메서드에 전달합니다.
setHeading	setHeading(heading) 매개변수:  heading:  number 반환 값: 없음 기본 방향 북쪽에서 도 단위로 측정된 지도의 나침반 방향을 설정합니다. 래스터 지도의 경우 이 방법은 항공 이미지에만 적용됩니다.
setHeadingInteractionEnabled	setHeadingInteractionEnabled(headingInteractionEnabled) 매개변수:  headingInteractionEnabled:  boolean 반환 값: 없음 제목 상호작용의 사용 설정 여부를 설정합니다. 이 옵션은 지도가 벡터 지도인 경우에만 적용됩니다. 코드에서 설정되지 않은 경우 지도 ID의 클라우드 구성이 사용됩니다 (사용 가능한 경우).
setMapTypeId	setMapTypeId(mapTypeId) 매개변수:  mapTypeId:  MapTypeId|string 반환 값: 없음
setOptions	setOptions(options) 매개변수:  options:  MapOptions optional 반환 값: 없음
setRenderingType	setRenderingType(renderingType) 매개변수:  renderingType:  RenderingType 반환 값: 없음 지도의 현재 RenderingType을 설정합니다.
setStreetView	setStreetView(panorama) 매개변수:  panorama:  StreetViewPanorama optional 지도에 결합할 파노라마입니다. 반환 값: 없음 StreetViewPanorama를 지도에 바인딩합니다. 이 파노라마는 지도가 지도 밖의 외부 파노라마에 바인딩되도록 기본 StreetViewPanorama를 재정의합니다. 파노라마를 null로 설정하면 삽입된 기본 파노라마가 다시 지도에 바인딩됩니다.
setTilt	setTilt(tilt) 매개변수:  tilt:  number 반환 값: 없음 벡터 지도에서 지도의 입사각을 설정합니다. 허용되는 값은 지도의 확대/축소 수준에 따라 제한됩니다. 래스터 지도의 경우 지도의 입사각에 대한 자동 전환 동작을 제어합니다. 허용되는 값은 0 및 45뿐입니다. setTilt(0): 확대/축소 수준 및 표시 영역에 관계없이 지도에서 항상 0° 오버헤드 뷰를 사용합니다. setTilt(45): 현재 확대/축소 수준과 표시 영역에서 45° 이미지를 사용할 수 있을 때마다 기울기 각도가 자동으로 45로 전환되고 45° 이미지를 사용할 수 없을 때마다 0으로 다시 전환합니다 (기본 동작). 45° 이미지는 satellite 및 hybrid 지도 유형, 일부 위치 및 일부 확대/축소 수준에서만 사용할 수 있습니다. 참고: getTilt는 setTilt에서 설정한 값이 아닌 현재 기울기 각도를 반환합니다. getTilt와 setTilt는 서로 다른 것을 참조하므로 tilt 속성을 bind()하지 마세요. 그렇게 하면 예측하지 못한 결과가 발생할 수 있습니다.
setTiltInteractionEnabled	setTiltInteractionEnabled(tiltInteractionEnabled) 매개변수:  tiltInteractionEnabled:  boolean 반환 값: 없음 기울이기 상호작용의 사용 여부를 설정합니다. 이 옵션은 지도가 벡터 지도인 경우에만 적용됩니다. 코드에서 설정되지 않은 경우 지도 ID의 클라우드 구성이 사용됩니다 (사용 가능한 경우).
setZoom	setZoom(zoom) 매개변수:  zoom:  number 확대/축소 값이 클수록 해상도가 높습니다. 반환 값: 없음 지도의 확대/축소를 설정합니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

MapOptions 인터페이스

google.maps.MapOptions 인터페이스

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

속성
backgroundColor optional	유형:  string optional 지도 div의 배경에 사용되는 색상입니다. 이 색상은 사용자가 이동할 때 타일이 아직 로드되지 않은 경우 표시됩니다. 이 옵션은 지도가 초기화될 때만 설정할 수 있습니다.
center optional	유형:  LatLng|LatLngLiteral optional 초기 지도 중심입니다.
clickableIcons optional	유형:  boolean optional 기본값: true false인 경우 지도 아이콘을 클릭할 수 없습니다. 지도 아이콘은 관심 장소(POI라고도 함)를 나타냅니다.
colorScheme optional	유형:  ColorScheme|string optional 기본값: ColorScheme.LIGHT 초기 지도 색 구성표입니다. 이 옵션은 지도가 초기화될 때만 설정할 수 있습니다.
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 기본 방위 북쪽에서 시계 방향으로 도 단위로 측정된 항공 사진의 방향입니다. 방향은 이미지를 표시할 수 있는 가장 가까운 사용 가능한 각도에 맞춰집니다.
headingInteractionEnabled optional	유형:  boolean optional 기본값: false 지도에서 사용자가 카메라 방향 (회전)을 제어할 수 있어야 하는지 여부입니다. 이 옵션은 지도가 벡터 지도인 경우에만 적용됩니다. 코드에서 설정되지 않은 경우 지도 ID의 클라우드 구성이 사용됩니다 (사용 가능한 경우).
isFractionalZoomEnabled optional	유형:  boolean optional 기본값: 벡터 지도의 경우 true, 래스터 지도의 경우 false 지도가 부분 확대/축소 수준을 허용해야 하는지 여부입니다. 기본값이 설정된 시점을 확인하려면 isfractionalzoomenabled_changed를 수신합니다.
keyboardShortcuts optional	유형:  boolean optional false인 경우 지도가 키보드로 제어되지 않습니다. 단축키는 기본적으로 사용 설정되어 있습니다.
mapId optional	유형:  string optional 지도의 지도 ID입니다. 지도를 인스턴스화한 후에는 이 매개변수를 설정하거나 변경할 수 없습니다. Map.DEMO_MAP_ID를 사용하면 지도 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 화면 이동 컨트롤의 활성화/비활성화 상태입니다.
panControlOptions optional	유형:  PanControlOptions optional 화면 이동 컨트롤의 표시 옵션입니다.
renderingType optional	유형:  RenderingType optional 기본값: RenderingType.RASTER 지도가 래스터 지도인지 벡터 지도인지 여부입니다. 지도를 인스턴스화한 후에는 이 매개변수를 설정하거나 변경할 수 없습니다. 설정하지 않으면 지도 ID의 클라우드 구성에 따라 렌더링 유형이 결정됩니다 (사용 가능한 경우). 일부 기기 및 브라우저에서는 벡터 지도를 사용하지 못할 수도 있으며, 필요에 따라 지도는 래스터 지도로 대체됩니다.
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/hybrid 및 terrain 모드의 경우 이러한 스타일은 라벨과 도형에만 적용됩니다. 지도 ID를 사용하거나 벡터 지도를 사용하는 경우에는 이 기능을 사용할 수 없습니다 (대신 클라우드 기반 지도 스타일 지정 사용).
tilt optional	유형:  number optional 벡터 지도에서 지도의 입사각을 설정합니다. 허용되는 값은 지도의 확대/축소 수준에 따라 제한됩니다. 래스터 지도의 경우 지도의 입사각에 대한 자동 전환 동작을 제어합니다. 허용되는 값은 0 및 45뿐입니다. 0 값을 사용하면 확대/축소 수준 및 표시 영역에 관계없이 지도에서 항상 0° 오버헤드 뷰를 사용합니다. 45 값을 지정하면 기울기 각도가 현재 확대/축소 수준과 표시 영역에서 45° 이미지를 사용할 수 있을 때마다 자동으로 45로 전환되고 45° 이미지를 사용할 수 없을 때마다 0으로 다시 전환됩니다 (이것이 기본 동작입니다). 45° 이미지는 satellite 및 hybrid 지도 유형, 일부 위치 및 일부 확대/축소 수준에서만 사용할 수 있습니다. 참고: getTilt는 이 옵션으로 지정된 값이 아닌 현재 기울기 각도를 반환합니다. getTilt와 이 옵션은 서로 다른 것을 참조하므로 tilt 속성을 bind()하지 마세요. 그렇게 하면 예측하지 못한 결과가 발생할 수 있습니다.
tiltInteractionEnabled optional	유형:  boolean optional 기본값: false 지도에서 사용자가 카메라 기울기를 제어할 수 있어야 하는지 여부입니다. 이 옵션은 지도가 벡터 지도인 경우에만 적용됩니다. 코드에서 설정되지 않은 경우 지도 ID의 클라우드 구성이 사용됩니다 (사용 가능한 경우).
zoom optional	유형:  number optional 초기 지도 확대/축소 수준입니다. 유효한 확대/축소 값은 0부터 지원되는 최대 확대/축소 수준까지의 숫자입니다. 확대/축소 값이 클수록 해상도가 높습니다.
zoomControl optional	유형:  boolean optional 확대/축소 컨트롤의 활성화/비활성화 상태입니다.
zoomControlOptions optional	유형:  ZoomControlOptions optional 확대/축소 컨트롤의 표시 옵션입니다.

MapElement 클래스

google.maps.MapElement 클래스

MapElement는 지도를 렌더링하기 위한 HTMLElement 서브클래스입니다. maps 라이브러리를 로드한 후 HTML로 지도를 만들 수 있습니다. 예:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

맞춤 요소:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

이 클래스는 HTMLElement

이 클래스는 MapElementOptions

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

메서드
addEventListener	addEventListener(type, listener[, options]) 매개변수:  type:  string 수신 대기할 이벤트 유형을 나타내는 문자열이며 대소문자를 구분합니다. listener:  EventListener|EventListenerObject 알림을 수신하는 객체입니다. 핸들을 이벤트 메서드가 있는 함수 또는 객체여야 합니다. options:  boolean|AddEventListenerOptions optional 옵션을 참고하세요. 맞춤 이벤트는 capture 및 passive만 지원합니다. 반환 값:  void 지정된 이벤트가 대상에 전달될 때마다 호출할 함수를 설정합니다. addEventListener를 참고하세요.
removeEventListener	removeEventListener(type, listener[, options]) 매개변수:  type:  string 이벤트 리스너를 삭제할 이벤트 유형을 지정하는 문자열입니다. listener:  EventListener|EventListenerObject 이벤트 타겟에서 삭제할 이벤트 핸들러의 이벤트 리스너입니다. options:  boolean|EventListenerOptions optional 옵션 참조 반환 값:  void 이전에 addEventListener로 등록된 이벤트 리스너를 타겟에서 제거합니다. removeEventListener를 참조하세요.

MapElementOptions 인터페이스

google.maps.MapElementOptions 인터페이스

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

ZoomChangeEvent 클래스

google.maps.ZoomChangeEvent 클래스

이 이벤트는 확대/축소 변경 모니터링에서 생성됩니다.

이 클래스는 Event

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

MapTypeStyle 인터페이스

google.maps.MapTypeStyle 인터페이스

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

MapMouseEvent 인터페이스

google.maps.MapMouseEvent 인터페이스

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

IconMouseEvent 인터페이스

google.maps.IconMouseEvent 인터페이스

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

이 인터페이스는 MapMouseEvent

ColorScheme 상수

google.maps.ColorScheme 상수

지도 색 구성표의 식별자입니다. 값으로 지정하거나 상수 이름을 사용하여 지정합니다. 예를 들면 'FOLLOW_SYSTEM' 또는 google.maps.ColorScheme.FOLLOW_SYSTEM이 있습니다.

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

MapTypeId 상수

google.maps.MapTypeId 상수

공통 MapTypes에 대한 식별자입니다. 값으로 지정하거나 상수 이름을 사용하여 지정합니다. 예를 들면 'satellite' 또는 google.maps.MapTypeId.SATELLITE이 있습니다.

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

MapTypeRegistry 클래스

google.maps.MapTypeRegistry 클래스

MapType ID로 키가 지정된 MapType 인스턴스의 레지스트리입니다.

이 클래스는 MVCObject

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

MapRestriction 인터페이스

google.maps.MapRestriction 인터페이스

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

TrafficLayer 클래스

google.maps.TrafficLayer 클래스

교통정보 레이어입니다.

이 클래스는 MVCObject

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

TrafficLayerOptions 인터페이스

google.maps.TrafficLayerOptions 인터페이스

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

TransitLayer 클래스

google.maps.TransitLayer 클래스

대중교통 레이어

이 클래스는 MVCObject

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

BicyclingLayer 클래스

google.maps.BicyclingLayer 클래스

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

이 클래스는 MVCObject

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

CameraOptions 인터페이스

google.maps.CameraOptions 인터페이스

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

VisibleRegion 인터페이스

google.maps.VisibleRegion 인터페이스

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

RenderingType 상수

google.maps.RenderingType 상수

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

MapCapabilities 인터페이스

google.maps.MapCapabilities 인터페이스

현재 지도에서 사용할 수 있는 기능의 스냅샷을 포함하는 객체입니다. 이는 반드시 관련 모듈이 로드되거나 초기화되었다는 뜻이 아니라 현재 지도에 이러한 API를 사용할 수 있는 권한이 있다는 의미입니다. 가능한 기능 목록은 속성을 참조하세요.