Thông báo: Kiểu bản đồ cơ sở mới sắp ra mắt trên Nền tảng Google Maps. Bản cập nhật này về kiểu bản đồ bao gồm bảng màu mặc định mới, ghim hiện đại và các điểm cải tiến về trải nghiệm và khả năng sử dụng bản đồ. Tất cả kiểu bản đồ sẽ được tự động cập nhật vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn sử dụng sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

Trang này được dịch bởi Cloud Translation API.

Maps

Lớp Map

Lớp google.maps.Map

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {Map} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Hàm dựng
`Map`	`Map(mapDiv[, opts])` Thông số: `mapDiv`: `HTMLElement` Bản đồ sẽ hiển thị để lấp đầy phần tử này. `opts`: `MapOptions optional` Tuỳ chọn Tạo một bản đồ mới bên trong vùng chứa HTML đã cho, thường là một phần tử `DIV`.

Hằng số
`DEMO_MAP_ID`	Mã bản đồ có thể được dùng cho các mẫu mã yêu cầu Mã bản đồ. Mã bản đồ này không dùng cho các ứng dụng chính thức và không dùng được cho các tính năng yêu cầu cấu hình đám mây (chẳng hạn như Kiểu trên đám mây).

Thuộc tính
`controls`	Loại: `Array<MVCArray<HTMLElement>>` Các chế độ điều khiển bổ sung để đính kèm vào bản đồ. Để thêm một thành phần điều khiển vào bản đồ, hãy thêm `<div>` của thành phần điều khiển vào `MVCArray` tương ứng với `ControlPosition` nơi thành phần điều khiển đó sẽ được hiển thị.
`data`	Loại: `Data` Một thực thể của `Data`, liên kết với bản đồ. Thêm các tính năng vào đối tượng `Data` này để hiển thị các tính năng đó một cách thuận tiện trên bản đồ này.
`mapTypes`	Loại: `MapTypeRegistry` Cấu phần đăng ký các thực thể `MapType` theo mã nhận dạng chuỗi.
`overlayMapTypes`	Loại: `MVCArray<MapType optional>` Các loại bản đồ khác để phủ lên. Các loại bản đồ lớp phủ sẽ hiển thị trên bản đồ cơ sở mà chúng được đính kèm, theo thứ tự xuất hiện trong mảng `overlayMapTypes` (các lớp phủ có giá trị chỉ mục cao hơn sẽ hiển thị trước các lớp phủ có giá trị chỉ mục thấp hơn).

Phương thức
`fitBounds`	`fitBounds(bounds[, padding])` Thông số: `bounds`: `LatLngBounds\|LatLngBoundsLiteral` Ranh giới cần hiển thị. `padding`: `number\|Padding optional` Khoảng đệm tính bằng pixel. Các giới hạn sẽ vừa với phần bản đồ còn lại sau khi khoảng đệm bị xoá. Giá trị số sẽ tạo ra cùng một khoảng đệm trên cả 4 cạnh. Cung cấp 0 tại đây để tạo một fitBounds idempotent trên kết quả của getBounds. Giá trị trả về: Không có Đặt khung nhìn để chứa các giới hạn đã cho. Lưu ý: Khi bản đồ được đặt thành `display: none`, hàm `fitBounds` sẽ đọc kích thước của bản đồ là 0x0 và do đó không thực hiện bất kỳ thao tác nào. Để thay đổi khung nhìn khi bản đồ bị ẩn, hãy đặt bản đồ thành `visibility: hidden`, nhờ đó đảm bảo div bản đồ có kích thước thực tế. Đối với bản đồ vectơ, phương thức này đặt độ nghiêng và hướng của bản đồ thành giá trị mặc định là 0. Việc gọi phương thức này có thể tạo ra ảnh động mượt mà khi bản đồ kéo và thu phóng để vừa với các giới hạn. Việc phương thức này có tạo ảnh động hay không phụ thuộc vào một phương pháp phỏng đoán nội bộ.
`getBounds`	`getBounds()` Thông số: Không có Giá trị trả về: `LatLngBounds\|undefined` Giới hạn lat/lng của khung nhìn hiện tại. Trả về giới hạn lat/lng của khung nhìn hiện tại. Nếu có nhiều bản sao của thế giới hiển thị, thì phạm vi kinh độ sẽ từ -180 đến 180 độ. Nếu bản đồ chưa được khởi chạy hoặc chưa được đặt tâm và thu phóng, thì kết quả sẽ là `undefined`. Đối với bản đồ vectơ có độ nghiêng hoặc hướng không bằng 0, các giới hạn lat/lng được trả về đại diện cho hộp giới hạn nhỏ nhất bao gồm vùng hiển thị của khung nhìn bản đồ. Hãy xem `MapCanvasProjection.getVisibleRegion` để biết vùng hiển thị chính xác của khung nhìn bản đồ.
`getCenter`	`getCenter()` Thông số: Không có Giá trị trả về: `LatLng\|undefined` Trả về vị trí hiển thị ở giữa bản đồ. Lưu ý rằng đối tượng `LatLng` này không được gói. Vui lòng tham khảo `LatLng` để biết thêm thông tin. Nếu bạn chưa đặt tâm hoặc ranh giới, thì kết quả sẽ là `undefined`.
`getClickableIcons`	`getClickableIcons()` Thông số: Không có Giá trị trả về: `boolean\|undefined` Trả về khả năng nhấp vào các biểu tượng trên bản đồ. Biểu tượng bản đồ đại diện cho một địa điểm yêu thích, còn gọi là POI. Nếu giá trị được trả về là `true`, thì bạn có thể nhấp vào các biểu tượng trên bản đồ.
`getDatasetFeatureLayer`	Thông báo: Chỉ có trong kênh v=beta. `getDatasetFeatureLayer(datasetId)` Thông số: `datasetId`: `string` Giá trị trả về: `FeatureLayer` Trả về `FeatureLayer` cho `datasetId` đã chỉ định. Bạn phải định cấu hình mã nhận dạng tập dữ liệu trong Google Cloud Console. Nếu mã nhận dạng tập dữ liệu không được liên kết với kiểu bản đồ của bản đồ hoặc nếu không có kiểu dựa trên dữ liệu (không có mã nhận dạng bản đồ, không có thẻ thông tin vectơ, không có lớp tính năng Kiểu dựa trên dữ liệu hoặc Tập dữ liệu được định cấu hình trong Kiểu bản đồ), thì lỗi này sẽ được ghi lại và `FeatureLayer.isAvailable` thu được sẽ là sai.
`getDiv`	`getDiv()` Thông số: Không có Giá trị trả về: `HTMLElement` mapDiv của bản đồ.
`getFeatureLayer`	`getFeatureLayer(featureType)` Thông số: `featureType`: `FeatureType` Giá trị trả về: `FeatureLayer` Trả về `FeatureLayer` của `FeatureType` cụ thể. Bạn phải bật `FeatureLayer` trong Google Cloud Console. Nếu `FeatureLayer` của `FeatureType` được chỉ định không tồn tại trên bản đồ này hoặc nếu không có kiểu dữ liệu (không có mã bản đồ, không có thẻ thông tin vectơ và không bật `FeatureLayer` trong kiểu bản đồ), thì lỗi này sẽ được ghi lại và `FeatureLayer.isAvailable` thu được sẽ là sai.
`getHeading`	`getHeading()` Thông số: Không có Giá trị trả về: `number\|undefined` Trả về hướng la bàn của bản đồ. Giá trị hướng được đo bằng độ (theo chiều kim đồng hồ) từ hướng chính Bắc. Nếu bản đồ chưa được khởi tạo thì kết quả sẽ là `undefined`.
`getHeadingInteractionEnabled`	`getHeadingInteractionEnabled()` Thông số: Không có Giá trị trả về: `boolean\|null` Trả về thông tin về việc liệu tính năng tương tác với tiêu đề có được bật hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
`getInternalUsageAttributionIds`	`getInternalUsageAttributionIds()` Thông số: Không có Giá trị trả về: `Iterable<string>\|null` Trả về danh sách mã phân bổ mức sử dụng, giúp Google hiểu được những thư viện và mẫu nào hữu ích cho nhà phát triển, chẳng hạn như việc sử dụng thư viện cụm điểm đánh dấu.
`getMapCapabilities`	`getMapCapabilities()` Thông số: Không có Giá trị trả về: `MapCapabilities` Thông báo cho phương thức gọi về các chức năng hiện có cho bản đồ dựa trên Mã bản đồ đã được cung cấp.
`getMapTypeId`	`getMapTypeId()` Thông số: Không có Giá trị trả về: `MapTypeId\|string\|undefined`
`getProjection`	`getProjection()` Thông số: Không có Giá trị trả về: `Projection\|undefined` Trả về `Projection` hiện tại. Nếu bản đồ chưa được khởi tạo thì kết quả sẽ là `undefined`. Theo dõi sự kiện `projection_changed` và kiểm tra giá trị của sự kiện đó để đảm bảo không phải là `undefined`.
`getRenderingType`	`getRenderingType()` Thông số: Không có Giá trị trả về: `RenderingType` Trả về RenderingType hiện tại của bản đồ.
`getStreetView`	`getStreetView()` Thông số: Không có Giá trị trả về: `StreetViewPanorama` Ảnh toàn cảnh liên kết với bản đồ. Trả về `StreetViewPanorama` mặc định liên kết với bản đồ. Đây có thể là ảnh toàn cảnh mặc định được nhúng trong bản đồ hoặc ảnh toàn cảnh được đặt bằng `setStreetView()`. Những thay đổi đối với `streetViewControl` của bản đồ sẽ được phản ánh trong chế độ hiển thị của ảnh toàn cảnh liên kết như vậy.
`getTilt`	`getTilt()` Thông số: Không có Giá trị trả về: `number\|undefined` Trả về góc tới hiện tại của bản đồ, tính bằng độ từ mặt phẳng khung nhìn đến mặt phẳng bản đồ. Đối với bản đồ đường quét, kết quả sẽ là `0` đối với hình ảnh được chụp trực tiếp từ trên cao hoặc `45` đối với hình ảnh 45°. Phương thức này không trả về giá trị do `setTilt` đặt. Hãy xem `setTilt` để biết thông tin chi tiết.
`getTiltInteractionEnabled`	`getTiltInteractionEnabled()` Thông số: Không có Giá trị trả về: `boolean\|null` Trả về thông tin về việc liệu tính năng tương tác nghiêng có được bật hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
`getZoom`	`getZoom()` Thông số: Không có Giá trị trả về: `number\|undefined` Trả về mức thu phóng của bản đồ. Nếu bạn chưa đặt mức thu phóng, kết quả sẽ là `undefined`.
`moveCamera`	`moveCamera(cameraOptions)` Thông số: `cameraOptions`: `CameraOptions` Giá trị trả về: Không có Đặt ngay máy ảnh của bản đồ thành các tuỳ chọn máy ảnh mục tiêu mà không có ảnh động.
`panBy`	`panBy(x, y)` Thông số: `x`: `number` Số pixel để di chuyển bản đồ theo hướng x. `y`: `number` Số pixel để di chuyển bản đồ theo hướng y. Giá trị trả về: Không có Thay đổi tâm của bản đồ theo khoảng cách đã cho tính bằng pixel. Nếu khoảng cách nhỏ hơn cả chiều rộng và chiều cao của bản đồ, thì quá trình chuyển đổi sẽ được tạo hiệu ứng ảnh động mượt mà. Xin lưu ý rằng hệ toạ độ bản đồ tăng từ tây sang đông (đối với các giá trị x) và từ bắc xuống nam (đối với các giá trị y).
`panTo`	`panTo(latLng)` Thông số: `latLng`: `LatLng\|LatLngLiteral` Vĩ độ/kinh độ trung tâm mới của bản đồ. Giá trị trả về: Không có Thay đổi tâm của bản đồ thành `LatLng` đã cho. Nếu thay đổi nhỏ hơn cả chiều rộng và chiều cao của bản đồ, thì quá trình chuyển đổi sẽ được tạo hiệu ứng ảnh động mượt mà.
`panToBounds`	`panToBounds(latLngBounds[, padding])` Thông số: `latLngBounds`: `LatLngBounds\|LatLngBoundsLiteral` Ranh giới để kéo bản đồ đến. `padding`: `number\|Padding optional` Khoảng đệm tính bằng pixel. Giá trị số sẽ tạo ra cùng một khoảng đệm trên cả 4 cạnh. Giá trị mặc định là "0". Giá trị trả về: Không có Kéo bản đồ theo lượng tối thiểu cần thiết để chứa `LatLngBounds` đã cho. Phương thức này không đảm bảo ranh giới sẽ nằm ở đâu trên bản đồ, ngoại trừ việc bản đồ sẽ được kéo để hiển thị nhiều ranh giới nhất có thể bên trong `{currentMapSizeInPx} - {padding}`. Đối với cả bản đồ đường quét và vectơ, chế độ thu phóng, độ nghiêng và hướng của bản đồ sẽ không thay đổi.
`setCenter`	`setCenter(latlng)` Thông số: `latlng`: `LatLng\|LatLngLiteral` Giá trị trả về: Không có
`setClickableIcons`	`setClickableIcons(value)` Thông số: `value`: `boolean` Giá trị trả về: Không có Kiểm soát việc có thể nhấp vào biểu tượng trên bản đồ hay không. Biểu tượng bản đồ đại diện cho một địa điểm yêu thích, còn gọi là POI. Để tắt khả năng nhấp vào biểu tượng bản đồ, hãy truyền giá trị `false` vào phương thức này.
`setHeading`	`setHeading(heading)` Thông số: `heading`: `number` Giá trị trả về: Không có Đặt hướng la bàn cho bản đồ được đo bằng độ từ hướng chính Bắc. Đối với bản đồ đường quét, phương thức này chỉ áp dụng cho ảnh chụp từ trên cao.
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` Thông số: `headingInteractionEnabled`: `boolean` Giá trị trả về: Không có Đặt liệu có bật tính năng tương tác với tiêu đề hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
`setMapTypeId`	`setMapTypeId(mapTypeId)` Thông số: `mapTypeId`: `MapTypeId\|string` Giá trị trả về: Không có
`setOptions`	`setOptions(options)` Thông số: `options`: `MapOptions optional` Giá trị trả về: Không có
`setRenderingType`	`setRenderingType(renderingType)` Thông số: `renderingType`: `RenderingType` Giá trị trả về: Không có Đặt RenderingType hiện tại của bản đồ.
`setStreetView`	`setStreetView(panorama)` Thông số: `panorama`: `StreetViewPanorama optional` Ảnh toàn cảnh để liên kết với bản đồ. Giá trị trả về: Không có Liên kết `StreetViewPanorama` với bản đồ. Ảnh toàn cảnh này ghi đè `StreetViewPanorama` mặc định, cho phép bản đồ liên kết với một ảnh toàn cảnh bên ngoài bản đồ. Việc đặt ảnh toàn cảnh thành `null` sẽ liên kết ảnh toàn cảnh được nhúng mặc định trở lại với bản đồ.
`setTilt`	`setTilt(tilt)` Thông số: `tilt`: `number` Giá trị trả về: Không có Đối với bản đồ vectơ, hãy đặt góc tới của bản đồ. Các giá trị được phép bị hạn chế tuỳ thuộc vào mức thu phóng của bản đồ. Đối với bản đồ đường quét, kiểm soát hành vi chuyển đổi tự động cho góc tới của bản đồ. Các giá trị duy nhất được phép là `0` và `45`. `setTilt(0)` khiến bản đồ luôn sử dụng chế độ xem trên cao 0° bất kể mức thu phóng và khung nhìn. `setTilt(45)` khiến góc nghiêng tự động chuyển sang 45 bất cứ khi nào có hình ảnh 45° cho cấp độ thu phóng và khung nhìn hiện tại, đồng thời chuyển về 0 bất cứ khi nào không có hình ảnh 45° (đây là hành vi mặc định). Hình ảnh 45° chỉ có ở các loại bản đồ `satellite` và `hybrid`, trong một số vị trí và ở một số mức thu phóng. Lưu ý: `getTilt` trả về góc nghiêng hiện tại, chứ không phải giá trị do `setTilt` đặt. Vì `getTilt` và `setTilt` đề cập đến các nội dung khác nhau, nên đừng `bind()` thuộc tính `tilt`; việc này có thể dẫn đến các hiệu ứng không thể đoán trước.
`setTiltInteractionEnabled`	`setTiltInteractionEnabled(tiltInteractionEnabled)` Thông số: `tiltInteractionEnabled`: `boolean` Giá trị trả về: Không có Đặt liệu có bật tính năng tương tác nghiêng hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
`setZoom`	`setZoom(zoom)` Thông số: `zoom`: `number` Giá trị thu phóng lớn hơn tương ứng với độ phân giải cao hơn. Giá trị trả về: Không có Đặt mức thu phóng của bản đồ.
Kế thừa: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Sự kiện
`bounds_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi các giới hạn khung nhìn thay đổi.
`center_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi thuộc tính tâm bản đồ thay đổi.
`click`	`function(event)` Đối số: `event`: `MapMouseEvent\|IconMouseEvent` Sự kiện này được kích hoạt khi người dùng nhấp vào bản đồ. Hệ thống sẽ trả về một MapMouseEvent có các thuộc tính cho vị trí được nhấp, trừ phi bạn nhấp vào một biểu tượng địa điểm. Trong trường hợp này, hệ thống sẽ trả về một IconMouseEvent có mã địa điểm. IconMouseEvent và MapMouseEvent giống hệt nhau, ngoại trừ IconMouseEvent có trường mã địa điểm. Bạn luôn có thể coi sự kiện này là MapMouseEvent khi mã địa điểm không quan trọng. Sự kiện nhấp sẽ không được kích hoạt nếu bạn nhấp vào một điểm đánh dấu hoặc cửa sổ thông tin.
`contextmenu`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt khi sự kiện trình đơn theo bối cảnh DOM được kích hoạt trên vùng chứa bản đồ.
`dblclick`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt khi người dùng nhấp đúp vào bản đồ. Xin lưu ý rằng sự kiện nhấp đôi khi sẽ kích hoạt một lần và đôi khi sẽ kích hoạt hai lần, ngay trước sự kiện này.
`drag`	`function()` Đối số: Không có Sự kiện này được kích hoạt liên tục trong khi người dùng kéo bản đồ.
`dragend`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi người dùng ngừng kéo bản đồ. Lưu ý: dragend KHÔNG được kích hoạt khi người dùng ngừng kéo bản đồ bằng bàn phím. Thay vào đó, vui lòng sử dụng sự kiện `Map.idle` để xác định thời điểm người dùng ngừng kéo hoặc kéo bản đồ.
`dragstart`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi người dùng bắt đầu kéo bản đồ.
`heading_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi thuộc tính tiêu đề bản đồ thay đổi.
`idle`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi bản đồ trở về trạng thái rảnh sau khi kéo hoặc thu phóng.
`isfractionalzoomenabled_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi thuộc tính isFractionalZoomEnabled thay đổi.
`mapcapabilities_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi các tính năng của bản đồ thay đổi.
`maptypeid_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi thuộc tính mapTypeId thay đổi.
`mousemove`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt mỗi khi chuột của người dùng di chuyển qua vùng chứa bản đồ.
`mouseout`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt khi chuột của người dùng rời khỏi vùng chứa bản đồ.
`mouseover`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt khi chuột của người dùng vào vùng chứa bản đồ.
`projection_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi phép chiếu đã thay đổi.
`renderingtype_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi renderingType thay đổi.
`tilesloaded`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi các thẻ thông tin hiển thị đã tải xong.
`tilt_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi thuộc tính độ nghiêng bản đồ thay đổi.
`zoom_changed`	`function()` Đối số: Không có Sự kiện này được kích hoạt khi thuộc tính thu phóng bản đồ thay đổi.
`rightclick`	Không dùng nữa: Thay vào đó, hãy sử dụng sự kiện `Map.contextmenu` để hỗ trợ các mẫu sử dụng như nhấp chuột bằng phím điều khiển trên macOS. `function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt khi người dùng nhấp chuột phải vào bản đồ.

Giao diện MapOptions

Giao diện google.maps.MapOptions

Đối tượng MapOptions dùng để xác định các thuộc tính có thể được đặt trên Bản đồ.

Thuộc tính
`backgroundColor optional`	Loại: `string optional` Màu dùng cho nền của div Bản đồ. Màu này sẽ hiển thị khi thẻ thông tin chưa tải khi người dùng xoay. Bạn chỉ có thể đặt tuỳ chọn này khi bản đồ được khởi tạo.
`cameraControl optional`	Loại: `boolean optional` Trạng thái bật/tắt của chế độ điều khiển Máy ảnh.
`cameraControlOptions optional`	Loại: `CameraControlOptions optional` Các tuỳ chọn hiển thị cho chế độ điều khiển Máy ảnh.
`center optional`	Loại: `LatLng\|LatLngLiteral optional` Trung tâm bản đồ ban đầu.
`clickableIcons optional`	Loại: `boolean optional` Mặc định: `true` Khi `false`, bạn không thể nhấp vào biểu tượng bản đồ. Biểu tượng bản đồ đại diện cho một địa điểm yêu thích, còn gọi là POI.
`colorScheme optional`	Loại: `ColorScheme\|string optional` Mặc định: `ColorScheme.LIGHT` Bảng phối màu ban đầu của Maps. Bạn chỉ có thể đặt tuỳ chọn này khi bản đồ được khởi tạo.
`controlSize optional`	Loại: `number optional` Kích thước tính bằng pixel của các nút điều khiển xuất hiện trên bản đồ. Bạn phải cung cấp trực tiếp giá trị này khi tạo Bản đồ, việc cập nhật giá trị này sau này có thể đưa các thành phần điều khiển vào trạng thái `undefined`. Chỉ điều chỉnh các chế độ điều khiển do chính Maps API tạo ra. Không điều chỉnh tỷ lệ các chế độ điều khiển tuỳ chỉnh do nhà phát triển tạo.
`disableDefaultUI optional`	Loại: `boolean optional` Bật/tắt tất cả các nút giao diện người dùng mặc định. Có thể được ghi đè riêng lẻ. Không tắt các nút điều khiển bàn phím, được tuỳ chọn `MapOptions.keyboardShortcuts` kiểm soát riêng. Không tắt các chế độ điều khiển bằng cử chỉ, được tuỳ chọn `MapOptions.gestureHandling` kiểm soát riêng.
`disableDoubleClickZoom optional`	Loại: `boolean optional` Bật/tắt tính năng phóng to và căn giữa khi nhấp đúp. Bật theo mặc định. Lưu ý: Bạn không nên sử dụng thuộc tính này. Để tắt tính năng phóng to khi nhấp đúp, bạn có thể sử dụng thuộc tính `gestureHandling` và đặt thuộc tính này thành `"none"`.
`draggable optional`	Không dùng nữa: Ngừng sử dụng vào năm 2017. Để tắt tính năng kéo trên bản đồ, bạn có thể sử dụng thuộc tính `gestureHandling` và đặt thuộc tính này thành `"none"`. Loại: `boolean optional` Nếu là `false`, ngăn không cho bản đồ bị kéo. Tính năng kéo được bật theo mặc định.
`draggableCursor optional`	Loại: `string optional` Tên hoặc URL của con trỏ sẽ hiển thị khi di chuột qua bản đồ có thể kéo. Thuộc tính này sử dụng thuộc tính `cursor` css để thay đổi biểu tượng. Cũng như với thuộc tính css, bạn phải chỉ định ít nhất một con trỏ dự phòng không phải là URL. Ví dụ: `draggableCursor: 'url(http://www.example.com/icon.png), auto;'`.
`draggingCursor optional`	Loại: `string optional` Tên hoặc URL của con trỏ để hiển thị khi bản đồ đang được kéo. Thuộc tính này sử dụng thuộc tính `cursor` css để thay đổi biểu tượng. Cũng như với thuộc tính css, bạn phải chỉ định ít nhất một con trỏ dự phòng không phải là URL. Ví dụ: `draggingCursor: 'url(http://www.example.com/icon.png), auto;'`.
`fullscreenControl optional`	Loại: `boolean optional` Trạng thái bật/tắt của chế độ điều khiển Toàn màn hình.
`fullscreenControlOptions optional`	Loại: `FullscreenControlOptions optional` Các tuỳ chọn hiển thị cho chế độ điều khiển Toàn màn hình.
`gestureHandling optional`	Loại: `string optional` Chế độ cài đặt này kiểm soát cách API xử lý các cử chỉ trên bản đồ. Giá trị được phép: `"cooperative"`: Sự kiện cuộn và cử chỉ chạm một ngón tay sẽ cuộn trang, đồng thời không phóng to hoặc kéo bản đồ. Cử chỉ chạm bằng hai ngón tay để kéo và thu phóng bản đồ. Sự kiện cuộn bằng phím ctrl hoặc phím ⌘ được nhấn sẽ phóng to bản đồ. Ở chế độ này, bản đồ cộng tác với trang. `"greedy"`: Tất cả cử chỉ chạm và sự kiện cuộn đều kéo hoặc thu phóng bản đồ. `"none"`: Người dùng không thể kéo hoặc thu phóng bản đồ bằng cử chỉ. `"auto"`: (mặc định) Việc xử lý cử chỉ có thể là hợp tác hoặc tham lam, tuỳ thuộc vào việc trang có thể cuộn được hay không hoặc nằm trong một iframe.
`heading optional`	Loại: `number optional` Tiêu đề của ảnh chụp trên không tính bằng độ, được đo theo chiều kim đồng hồ từ hướng chính Bắc. Các tiêu đề được chụp nhanh theo góc gần nhất có sẵn có hình ảnh.
`headingInteractionEnabled optional`	Loại: `boolean optional` Mặc định: `false` Liệu bản đồ có cho phép người dùng điều khiển hướng máy ảnh (xoay) hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
`internalUsageAttributionIds optional`	Loại: `Iterable<string> optional` Mặc định: `null` Thêm mã phân bổ mức sử dụng vào trình khởi chạy. Điều này giúp Google hiểu được những thư viện và mẫu nào hữu ích cho nhà phát triển, chẳng hạn như việc sử dụng thư viện cụm điểm đánh dấu. Để chọn không gửi mã phân bổ mức sử dụng, bạn có thể xoá thuộc tính này hoặc thay thế giá trị bằng một chuỗi trống. Hệ thống sẽ chỉ gửi các giá trị duy nhất. Các thay đổi đối với giá trị này sau khi tạo bản sao có thể bị bỏ qua.
`isFractionalZoomEnabled optional`	Loại: `boolean optional` Mặc định: `true` cho bản đồ vectơ và `false` cho bản đồ đường quét Liệu bản đồ có cho phép các cấp độ thu phóng phân đoạn hay không. Hãy nghe `isfractionalzoomenabled_changed` để biết thời điểm đặt mặc định.
`keyboardShortcuts optional`	Loại: `boolean optional` Nếu `false`, ngăn không cho bàn phím điều khiển bản đồ. Theo mặc định, phím tắt được bật.
`mapId optional`	Loại: `string optional` Mã bản đồ của bản đồ. Bạn không thể đặt hoặc thay đổi tham số này sau khi tạo bản đồ. Bạn có thể dùng `Map.DEMO_MAP_ID` để dùng thử các tính năng yêu cầu mã bản đồ nhưng không yêu cầu bật tính năng trên đám mây.
`mapTypeControl optional`	Loại: `boolean optional` Trạng thái bật/tắt ban đầu của chế độ điều khiển Loại bản đồ.
`mapTypeControlOptions optional`	Loại: `MapTypeControlOptions optional` Các tuỳ chọn hiển thị ban đầu cho thành phần điều khiển Loại bản đồ.
`mapTypeId optional`	Loại: `MapTypeId\|string optional` mapTypeId của Bản đồ ban đầu. Giá trị mặc định là `ROADMAP`.
`maxZoom optional`	Loại: `number optional` Cấp độ thu phóng tối đa sẽ hiển thị trên bản đồ. Nếu bạn bỏ qua hoặc đặt thành `null`, thì chế độ thu phóng tối đa của loại bản đồ hiện tại sẽ được sử dụng. Giá trị thu phóng hợp lệ là các số từ 0 đến mức thu phóng tối đa được hỗ trợ.
`minZoom optional`	Loại: `number optional` Cấp thu phóng tối thiểu sẽ hiển thị trên bản đồ. Nếu bạn bỏ qua hoặc đặt thành `null`, thì chế độ thu nhỏ tối thiểu của loại bản đồ hiện tại sẽ được sử dụng. Giá trị thu phóng hợp lệ là các số từ 0 đến mức thu phóng tối đa được hỗ trợ.
`noClear optional`	Loại: `boolean optional` Nếu là `true`, đừng xoá nội dung của div Bản đồ.
`panControl optional`	Không dùng nữa: Kể từ tháng 9 năm 2015, chúng tôi không dùng chế độ điều khiển Kéo nữa. Loại: `boolean optional` Trạng thái bật/tắt của nút điều khiển Kéo.
`panControlOptions optional`	Không dùng nữa: Kể từ tháng 9 năm 2015, chúng tôi không dùng chế độ điều khiển Kéo nữa. Loại: `PanControlOptions optional` Các tuỳ chọn hiển thị cho chế độ điều khiển Xoay.
`renderingType optional`	Loại: `RenderingType optional` Mặc định: `RenderingType.RASTER` Liệu bản đồ có phải là bản đồ vectơ hay bản đồ đường quét. Bạn không thể đặt hoặc thay đổi tham số này sau khi tạo bản đồ. Nếu bạn không đặt, thì cấu hình đám mây cho mã bản đồ sẽ xác định loại kết xuất (nếu có). Xin lưu ý rằng không phải thiết bị và trình duyệt nào cũng hỗ trợ bản đồ vectơ và bản đồ sẽ quay lại bản đồ đường quét nếu cần.
`restriction optional`	Loại: `MapRestriction optional` Xác định ranh giới hạn chế khu vực trên bản đồ mà người dùng có thể truy cập. Khi được đặt, người dùng chỉ có thể kéo và thu phóng trong khi chế độ xem máy ảnh nằm trong giới hạn của ranh giới.
`rotateControl optional`	Loại: `boolean optional` Trạng thái bật/tắt của nút điều khiển Xoay.
`rotateControlOptions optional`	Loại: `RotateControlOptions optional` Các tuỳ chọn hiển thị cho thành phần điều khiển Xoay.
`scaleControl optional`	Loại: `boolean optional` Trạng thái bật/tắt ban đầu của chế độ điều khiển Tỷ lệ.
`scaleControlOptions optional`	Loại: `ScaleControlOptions optional` Các tuỳ chọn hiển thị ban đầu cho chế độ điều khiển Tỷ lệ.
`scrollwheel optional`	Loại: `boolean optional` Nếu `false`, hãy tắt tính năng thu phóng trên bản đồ bằng con lăn chuột. Theo mặc định, con lăn được bật. Lưu ý: Bạn không nên sử dụng thuộc tính này. Để tắt tính năng thu phóng bằng con lăn chuột, bạn có thể sử dụng thuộc tính `gestureHandling` và đặt thuộc tính này thành `"cooperative"` hoặc `"none"`.
`streetView optional`	Loại: `StreetViewPanorama optional` `StreetViewPanorama` để hiển thị khi thả người hình mắc áo Chế độ xem đường phố trên bản đồ. Nếu bạn không chỉ định ảnh toàn cảnh nào, thì `StreetViewPanorama` mặc định sẽ hiển thị trong `div` của bản đồ khi bạn thả người đàn ông ghim.
`streetViewControl optional`	Loại: `boolean optional` Trạng thái bật/tắt ban đầu của chế độ điều khiển Người hình mắc áo trong Chế độ xem đường phố. Thành phần điều khiển này là một phần của giao diện người dùng mặc định và phải được đặt thành `false` khi hiển thị một loại bản đồ không hiển thị lớp phủ đường phố trên Chế độ xem đường phố (ví dụ: loại bản đồ không phải là Trái đất).
`streetViewControlOptions optional`	Loại: `StreetViewControlOptions optional` Các tuỳ chọn hiển thị ban đầu cho chế độ điều khiển Người hình mắc áo trong Chế độ xem đường phố.
`styles optional`	Loại: `Array<MapTypeStyle> optional` Kiểu áp dụng cho từng loại bản đồ mặc định. Xin lưu ý rằng đối với các chế độ `satellite`/`hybrid` và `terrain`, các kiểu này sẽ chỉ áp dụng cho nhãn và hình học. Tính năng này không hoạt động khi bạn sử dụng mã bản đồ hoặc khi sử dụng bản đồ vectơ (hãy sử dụng tính năng thiết kế bản đồ trên đám mây).
`tilt optional`	Loại: `number optional` Đối với bản đồ vectơ, hãy đặt góc tới của bản đồ. Các giá trị được phép bị hạn chế tuỳ thuộc vào mức thu phóng của bản đồ. Đối với bản đồ đường quét, kiểm soát hành vi tự động chuyển đổi cho góc tới của bản đồ. Các giá trị duy nhất được phép là `0` và `45`. Giá trị `0` khiến bản đồ luôn sử dụng chế độ xem trên cao 0° bất kể mức thu phóng và khung nhìn. Giá trị `45` khiến góc nghiêng tự động chuyển sang 45 bất cứ khi nào có hình ảnh 45° cho mức thu phóng và khung nhìn hiện tại, đồng thời chuyển về 0 bất cứ khi nào không có hình ảnh 45° (đây là hành vi mặc định). Hình ảnh 45° chỉ có ở các loại bản đồ `satellite` và `hybrid`, trong một số vị trí và ở một số mức thu phóng. Lưu ý: `getTilt` trả về góc nghiêng hiện tại, chứ không phải giá trị do tuỳ chọn này chỉ định. Vì `getTilt` và tuỳ chọn này đề cập đến các nội dung khác nhau, nên đừng `bind()` thuộc tính `tilt`; việc này có thể dẫn đến các hiệu ứng không thể đoán trước.
`tiltInteractionEnabled optional`	Loại: `boolean optional` Mặc định: `false` Liệu bản đồ có cho phép người dùng điều khiển độ nghiêng của máy ảnh hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
`zoom optional`	Loại: `number optional` Mức thu phóng ban đầu của Bản đồ. Giá trị thu phóng hợp lệ là các số từ 0 đến mức thu phóng tối đa được hỗ trợ. Giá trị thu phóng lớn hơn tương ứng với độ phân giải cao hơn.
`zoomControl optional`	Loại: `boolean optional` Trạng thái bật/tắt của nút điều khiển Thu phóng.
`zoomControlOptions optional`	Loại: `ZoomControlOptions optional` Các tuỳ chọn hiển thị cho chế độ điều khiển Thu phóng.

Lớp MapElement

Lớp google.maps.MapElement

MapElement là lớp con HTMLElement để kết xuất bản đồ. Sau khi tải thư viện maps, bạn có thể tạo bản đồ trong HTML. Ví dụ:

<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>

Trong nội bộ, lớp này sử dụng Map, bạn có thể truy cập lớp này bằng thuộc tính innerMap.

Phần tử tuỳ chỉnh:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

Lớp này mở rộng HTMLElement.

Lớp này triển khai MapElementOptions.

Truy cập bằng cách gọi const {MapElement} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Hàm dựng
`MapElement`	`MapElement([options])` Thông số: `options`: `MapElementOptions optional`

Thuộc tính
`center`	Loại: `LatLng\|LatLngLiteral optional` Vĩ độ/kinh độ trung tâm của bản đồ. Thuộc tính HTML: `<gmp-map center="lat,lng"></gmp-map>`
`headingInteractionDisabled`	Loại: `boolean optional` Mặc định: `false` Liệu bản đồ có cho phép người dùng điều khiển hướng máy ảnh (xoay) hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có). Thuộc tính HTML: `<gmp-map heading-interaction-disabled></gmp-map>`
`innerMap`	Loại: `Map` Tham chiếu đến `Map` mà MapElement sử dụng nội bộ.
`internalUsageAttributionIds`	Loại: `Iterable<string> optional` Mặc định: `null` Thêm mã phân bổ mức sử dụng vào trình khởi chạy. Điều này giúp Google hiểu được những thư viện và mẫu nào hữu ích cho nhà phát triển, chẳng hạn như việc sử dụng thư viện cụm điểm đánh dấu. Để chọn không gửi mã phân bổ mức sử dụng, bạn có thể xoá thuộc tính này hoặc thay thế giá trị bằng một chuỗi trống. Hệ thống sẽ chỉ gửi các giá trị duy nhất. Các thay đổi đối với giá trị này sau khi tạo bản sao có thể bị bỏ qua. Thuộc tính HTML: `<gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>`
`mapId`	Loại: `string optional` Mã bản đồ của bản đồ. Bạn không thể đặt hoặc thay đổi tham số này sau khi tạo bản đồ. Bạn có thể dùng `Map.DEMO_MAP_ID` để dùng thử các tính năng yêu cầu mã bản đồ nhưng không yêu cầu bật tính năng trên đám mây. Thuộc tính HTML: `<gmp-map map-id="string"></gmp-map>`
`renderingType`	Loại: `RenderingType optional` Mặc định: `RenderingType.VECTOR` Liệu bản đồ có phải là bản đồ vectơ hay bản đồ đường quét. Bạn không thể đặt hoặc thay đổi tham số này sau khi tạo bản đồ. Nếu bạn không đặt, thì cấu hình đám mây cho mã bản đồ sẽ xác định loại kết xuất (nếu có). Xin lưu ý rằng không phải thiết bị và trình duyệt nào cũng hỗ trợ bản đồ vectơ và bản đồ sẽ quay lại bản đồ đường quét nếu cần. Thuộc tính HTML: `<gmp-map rendering-type="vector"></gmp-map>` `<gmp-map rendering-type="raster"></gmp-map>`
`tiltInteractionDisabled`	Loại: `boolean optional` Mặc định: `false` Liệu bản đồ có cho phép người dùng điều khiển độ nghiêng của máy ảnh hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có). Thuộc tính HTML: `<gmp-map tilt-interaction-disabled></gmp-map>`
`zoom`	Loại: `number optional` Mức thu phóng của bản đồ. Giá trị thu phóng hợp lệ là các số từ 0 đến mức thu phóng tối đa được hỗ trợ. Giá trị thu phóng lớn hơn tương ứng với độ phân giải cao hơn. Thuộc tính HTML: `<gmp-map zoom="number"></gmp-map>`

Máy giật xèng
`control-block-end-inline-center`	Đặt phần tử có khe ở vị trí `ControlPosition.BLOCK_END_INLINE_CENTER`.
`control-block-end-inline-end`	Đặt phần tử có khe ở vị trí `ControlPosition.BLOCK_END_INLINE_END`.
`control-block-end-inline-start`	Đặt phần tử có khe ở vị trí `ControlPosition.BLOCK_END_INLINE_START`.
`control-block-start-inline-center`	Đặt phần tử có khe ở vị trí `ControlPosition.BLOCK_START_INLINE_CENTER`.
`control-block-start-inline-end`	Đặt phần tử có khe ở vị trí `ControlPosition.BLOCK_START_INLINE_END`.
`control-block-start-inline-start`	Đặt phần tử có khe ở vị trí `ControlPosition.BLOCK_START_INLINE_START`.
`control-inline-end-block-center`	Đặt phần tử có khe ở vị trí `ControlPosition.INLINE_END_BLOCK_CENTER`.
`control-inline-end-block-end`	Đặt phần tử có khe ở vị trí `ControlPosition.INLINE_END_BLOCK_END`.
`control-inline-end-block-start`	Đặt phần tử có khe ở vị trí `ControlPosition.INLINE_END_BLOCK_START`.
`control-inline-start-block-center`	Đặt phần tử có khe ở vị trí `ControlPosition.INLINE_START_BLOCK_CENTER`.
`control-inline-start-block-end`	Đặt phần tử có khe ở vị trí `ControlPosition.INLINE_START_BLOCK_END`.
`control-inline-start-block-start`	Đặt phần tử có khe ở vị trí `ControlPosition.INLINE_START_BLOCK_START`.
`default`	Bạn có thể tạo các thành phần có thể sử dụng lại xung quanh Thành phần web JavaScript của Maps, chẳng hạn như `AdvancedMarkerElement`, bằng cách sử dụng các phần tử tuỳ chỉnh. Theo mặc định, mọi phần tử tuỳ chỉnh được thêm trực tiếp vào `MapElement` sẽ được đưa vào và hiển thị trong `MapPanes.overlayMouseTarget`. Tuy nhiên, bạn có thể đặt lại các Thành phần web API JavaScript của Maps vào các khe nội bộ của `MapElement`.

Phương thức
`addEventListener`	Thông báo: Chỉ có trong kênh v=beta. `addEventListener(type, listener[, options])` Thông số: `type`: `string` Một chuỗi phân biệt chữ hoa chữ thường đại diện cho loại sự kiện cần theo dõi. `listener`: `EventListener\|EventListenerObject` Đối tượng nhận thông báo. Đây phải là một hàm hoặc đối tượng có phương thức handleEvent `options`: `boolean\|AddEventListenerOptions optional` Xem các tuỳ chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ `capture` và `passive`. Giá trị trả về: `void` Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được phân phối đến mục tiêu. Xem addEventListener
`removeEventListener`	Thông báo: Chỉ có trong kênh v=beta. `removeEventListener(type, listener[, options])` Thông số: `type`: `string` Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. `listener`: `EventListener\|EventListenerObject` Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi mục tiêu sự kiện. `options`: `boolean\|EventListenerOptions optional` Xem các tuỳ chọn Giá trị trả về: `void` Xoá trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Xem removeEventListener

Phương thức

addEventListener

addEventListener(type, listener[, options])

Thông số:

type: string Một chuỗi phân biệt chữ hoa chữ thường đại diện cho loại sự kiện cần theo dõi.
listener: EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc đối tượng có phương thức handleEvent
options: boolean|AddEventListenerOptions optional Xem các tuỳ chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.

Giá trị trả về: void

Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được phân phối đến mục tiêu. Xem addEventListener

removeEventListener

removeEventListener(type, listener[, options])

Thông số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi mục tiêu sự kiện.
options: boolean|EventListenerOptions optional Xem các tuỳ chọn

Giá trị trả về: void

Xoá trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Xem removeEventListener

Sự kiện
`gmp-zoomchange`	`function(event)` Đối số: `event`: `ZoomChangeEvent` Sự kiện này được kích hoạt khi thuộc tính thu phóng bản đồ thay đổi.

Giao diện MapElementOptions

Giao diện google.maps.MapElementOptions

Đối tượng MapElementOptions dùng để xác định các thuộc tính có thể được đặt trên MapElement.

Thuộc tính
`center optional`	Loại: `LatLng\|LatLngLiteral optional` Vui lòng xem `MapElement.center`.
`headingInteractionDisabled optional`	Loại: `boolean optional` Vui lòng xem `MapElement.headingInteractionDisabled`.
`internalUsageAttributionIds optional`	Loại: `Iterable<string> optional` Vui lòng xem `MapElement.internalUsageAttributionIds`.
`mapId optional`	Loại: `string optional` Vui lòng xem `MapElement.mapId`.
`renderingType optional`	Loại: `RenderingType optional` Vui lòng xem `MapElement.renderingType`.
`tiltInteractionDisabled optional`	Loại: `boolean optional` Vui lòng xem `MapElement.tiltInteractionDisabled`.
`zoom optional`	Loại: `number optional` Vui lòng xem `MapElement.zoom`.

Lớp ZoomChangeEvent

Lớp google.maps.ZoomChangeEvent

Sự kiện này được tạo từ việc theo dõi thay đổi về mức thu phóng.

Lớp này mở rộng Event.

Truy cập bằng cách gọi const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Giao diện MapTypeStyle

Giao diện google.maps.MapTypeStyle

MapTypeStyle là một tập hợp các bộ chọn và bộ định kiểu xác định cách tạo kiểu cho bản đồ. Bộ chọn chỉ định các đối tượng và/hoặc thành phần trên bản đồ sẽ chịu ảnh hưởng, còn bộ tạo kiểu chỉ định cách sửa đổi các đối tượng và thành phần đó. Để biết thông tin chi tiết, hãy xem tài liệu tham khảo về kiểu.

Thuộc tính
`stylers`	Loại: `Array<Object>` Quy tắc kiểu áp dụng cho các thành phần và đối tượng trên bản đồ đã chọn. Các quy tắc được áp dụng theo thứ tự mà bạn chỉ định trong mảng này. Để biết nguyên tắc sử dụng và các giá trị được phép, hãy xem tài liệu tham khảo về kiểu.
`elementType optional`	Loại: `string optional` Phần tử cần áp dụng trình tạo kiểu. Phần tử là một khía cạnh hình ảnh của một đối tượng trên bản đồ. Ví dụ: nhãn, biểu tượng, nét vẽ hoặc màu tô được áp dụng cho hình học, v.v. Không bắt buộc. Nếu bạn không chỉ định `elementType`, giá trị sẽ được giả định là `'all'`. Để biết thông tin chi tiết về cách sử dụng và các giá trị được phép, hãy xem tài liệu tham khảo về kiểu.
`featureType optional`	Loại: `string optional` Tính năng hoặc nhóm tính năng mà bạn nên áp dụng trình tạo kiểu. Không bắt buộc. Nếu bạn không chỉ định `featureType`, giá trị sẽ được giả định là `'all'`. Để biết thông tin chi tiết về cách sử dụng và các giá trị được phép, hãy xem tài liệu tham khảo về kiểu.

Giao diện MapMouseEvent

Giao diện google.maps.MapMouseEvent

Đối tượng này được trả về từ nhiều sự kiện chuột trên bản đồ và lớp phủ, đồng thời chứa tất cả các trường hiển thị bên dưới.

Thuộc tính
`domEvent`	Loại: `MouseEvent\|TouchEvent\|PointerEvent\|KeyboardEvent\|Event` Sự kiện DOM gốc tương ứng. Nhà phát triển không nên dựa vào các thuộc tính `target`, `currentTarget`, `relatedTarget` và `path` được xác định và nhất quán. Nhà phát triển cũng không nên dựa vào cấu trúc DOM của quá trình triển khai nội bộ API Maps. Do việc ánh xạ sự kiện nội bộ, `domEvent` có thể có ngữ nghĩa khác với `MapMouseEvent` (ví dụ: một "lượt nhấp" `MapMouseEvent` có thể có `domEvent` thuộc loại `KeyboardEvent`).
`latLng optional`	Loại: `LatLng optional` Vĩ độ/kinh độ nằm bên dưới con trỏ khi sự kiện xảy ra.

Thuộc tính

domEvent

Loại: MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event

Sự kiện DOM gốc tương ứng. Nhà phát triển không nên dựa vào các thuộc tính target, currentTarget, relatedTarget và path được xác định và nhất quán. Nhà phát triển cũng không nên dựa vào cấu trúc DOM của quá trình triển khai nội bộ API Maps. Do việc ánh xạ sự kiện nội bộ, domEvent có thể có ngữ nghĩa khác với MapMouseEvent (ví dụ: một "lượt nhấp" MapMouseEvent có thể có domEvent thuộc loại KeyboardEvent).

latLng optional

Loại: LatLng optional

Vĩ độ/kinh độ nằm bên dưới con trỏ khi sự kiện xảy ra.

Phương thức
`stop`	`stop()` Thông số: Không có Giá trị trả về: `void` Ngăn sự kiện này tiếp tục lan truyền.

Giao diện IconMouseEvent

Giao diện google.maps.IconMouseEvent

Đối tượng này được gửi trong một sự kiện khi người dùng nhấp vào một biểu tượng trên bản đồ. Mã địa điểm của địa điểm này được lưu trữ trong thành phần placeId. Để ngăn cửa sổ thông tin mặc định xuất hiện, hãy gọi phương thức stop() trên sự kiện này để ngăn sự kiện đó được truyền. Tìm hiểu thêm về mã địa điểm trong hướng dẫn dành cho nhà phát triển về API Địa điểm.

Giao diện này mở rộng MapMouseEvent.

Thuộc tính
`placeId optional`	Loại: `string optional` Mã địa điểm của địa điểm được nhấp. Bạn có thể sử dụng mã địa điểm này để truy vấn thêm thông tin về đối tượng đã được nhấp vào. Tìm hiểu thêm về mã địa điểm trong hướng dẫn dành cho nhà phát triển về API Địa điểm.
Kế thừa: `domEvent`, `latLng`

Phương thức
Kế thừa: `stop`

Hằng số ColorScheme

Hằng số google.maps.ColorScheme

Giá trị nhận dạng cho bảng phối màu của bản đồ. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. Ví dụ: 'FOLLOW_SYSTEM' hoặc google.maps.ColorScheme.FOLLOW_SYSTEM.

Truy cập bằng cách gọi const {ColorScheme} = await google.maps.importLibrary("core"). Xem phần Thư viện trong API Maps JavaScript.

Hằng số
`DARK`	Bảng phối màu tối cho bản đồ.
`FOLLOW_SYSTEM`	Bảng phối màu được chọn dựa trên lựa chọn ưu tiên của hệ thống.
`LIGHT`	Bảng phối màu sáng cho bản đồ. Giá trị mặc định cho Maps JS cũ.

Hằng số MapTypeId

Hằng số google.maps.MapTypeId

Giá trị nhận dạng cho các MapType phổ biến. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. Ví dụ: 'satellite' hoặc google.maps.MapTypeId.SATELLITE.

Truy cập bằng cách gọi const {MapTypeId} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Hằng số
`HYBRID`	Loại bản đồ này hiển thị một lớp trong suốt của các đường phố chính trên hình ảnh vệ tinh.
`ROADMAP`	Loại bản đồ này hiển thị bản đồ đường phố thông thường.
`SATELLITE`	Loại bản đồ này hiển thị hình ảnh vệ tinh.
`TERRAIN`	Loại bản đồ này hiển thị bản đồ có các đặc điểm vật lý như địa hình và thảm thực vật.

Lớp MapTypeRegistry

Lớp google.maps.MapTypeRegistry

Cấu phần đăng ký cho các thực thể MapType, được khoá bằng mã MapType.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Hàm dựng
`MapTypeRegistry`	`MapTypeRegistry()` Thông số: Không có `MapTypeRegistry` lưu giữ tập hợp các loại bản đồ tuỳ chỉnh có sẵn cho bản đồ để sử dụng. Ví dụ: API tham khảo sổ đăng ký này khi cung cấp danh sách các loại bản đồ có sẵn trong các chế độ điều khiển.

Phương thức
`set`	`set(id, mapType)` Thông số: `id`: `string` Giá trị nhận dạng của MapType cần thêm vào sổ đăng ký. `mapType`: Đối tượng MapType `MapType\|?` để thêm vào sổ đăng ký. Giá trị trả về: Không có Đặt sổ đăng ký để liên kết giá trị nhận dạng chuỗi đã truyền với MapType đã truyền.
Kế thừa: `addListener`, `bindTo`, `get`, `notify`, `setValues`, `unbind`, `unbindAll`

Giao diện MapRestriction

Giao diện google.maps.MapRestriction

Quy định hạn chế có thể áp dụng cho Bản đồ. Khung nhìn của bản đồ sẽ không vượt quá các giới hạn này.

Thuộc tính
`latLngBounds`	Loại: `LatLngBounds\|LatLngBoundsLiteral` Khi được đặt, người dùng chỉ có thể kéo và thu phóng trong giới hạn đã cho. Giới hạn có thể hạn chế cả kinh độ và vĩ độ hoặc chỉ hạn chế vĩ độ. Đối với các giới hạn chỉ có vĩ độ, hãy sử dụng kinh độ tây và kinh độ đông lần lượt là -180 và 180, ví dụ: `latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}`.
`strictBounds optional`	Loại: `boolean optional` Bạn có thể đặt giới hạn hạn chế hơn bằng cách đặt cờ `strictBounds` thành `true`. Điều này làm giảm khoảng cách thu nhỏ mà người dùng có thể thực hiện, đảm bảo mọi thứ bên ngoài giới hạn bị hạn chế vẫn bị ẩn. Giá trị mặc định là `false`, nghĩa là người dùng có thể thu nhỏ cho đến khi toàn bộ vùng giới hạn nằm trong khung hiển thị, có thể bao gồm cả các vùng nằm ngoài vùng giới hạn.

Thuộc tính

latLngBounds

Loại: LatLngBounds|LatLngBoundsLiteral

Khi được đặt, người dùng chỉ có thể kéo và thu phóng trong giới hạn đã cho. Giới hạn có thể hạn chế cả kinh độ và vĩ độ hoặc chỉ hạn chế vĩ độ. Đối với các giới hạn chỉ có vĩ độ, hãy sử dụng kinh độ tây và kinh độ đông lần lượt là -180 và 180, ví dụ: latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.

strictBounds optional

Loại: boolean optional

Bạn có thể đặt giới hạn hạn chế hơn bằng cách đặt cờ strictBounds thành true. Điều này làm giảm khoảng cách thu nhỏ mà người dùng có thể thực hiện, đảm bảo mọi thứ bên ngoài giới hạn bị hạn chế vẫn bị ẩn. Giá trị mặc định là false, nghĩa là người dùng có thể thu nhỏ cho đến khi toàn bộ vùng giới hạn nằm trong khung hiển thị, có thể bao gồm cả các vùng nằm ngoài vùng giới hạn.

Lớp TrafficLayer

Lớp google.maps.TrafficLayer

Lớp lưu lượng truy cập.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {TrafficLayer} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Hàm dựng
`TrafficLayer`	`TrafficLayer([opts])` Thông số: `opts`: `TrafficLayerOptions optional` Một lớp hiển thị tình trạng giao thông đường bộ hiện tại.

Phương thức
`getMap`	`getMap()` Thông số: Không có Giá trị trả về: `Map\|null` Trả về bản đồ hiển thị lớp này.
`setMap`	`setMap(map)` Thông số: `map`: `Map optional` Giá trị trả về: Không có Kết xuất lớp trên bản đồ được chỉ định. Nếu bạn đặt map thành `null`, lớp này sẽ bị xoá.
`setOptions`	`setOptions(options)` Thông số: `options`: `TrafficLayerOptions optional` Giá trị trả về: Không có
Kế thừa: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Giao diện TrafficLayerOptions

Giao diện google.maps.TrafficLayerOptions

Đối tượng TrafficLayerOptions dùng để xác định các thuộc tính có thể được đặt trên TrafficLayer.

Thuộc tính
`autoRefresh optional`	Loại: `boolean optional` Mặc định: `true` Lớp lưu lượng truy cập có tự động làm mới bằng thông tin mới cập nhật hay không.
`map optional`	Loại: `Map optional` Bản đồ hiển thị lớp giao thông.

Lớp TransitLayer

Lớp google.maps.TransitLayer

Lớp chuyển đổi.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {TransitLayer} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Hàm dựng
`TransitLayer`	`TransitLayer()` Thông số: Không có Một lớp hiển thị các tuyến phương tiện công cộng.

Phương thức
`getMap`	`getMap()` Thông số: Không có Giá trị trả về: `Map\|null` Trả về bản đồ hiển thị lớp này.
`setMap`	`setMap(map)` Thông số: `map`: `Map optional` Giá trị trả về: `void` Kết xuất lớp trên bản đồ được chỉ định. Nếu bạn đặt map thành `null`, lớp này sẽ bị xoá.
Kế thừa: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Lớp BicyclingLayer

Lớp google.maps.BicyclingLayer

Một lớp hiển thị các làn đường và đường dành cho xe đạp.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {BicyclingLayer} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Hàm dựng
`BicyclingLayer`	`BicyclingLayer()` Thông số: Không có Một lớp hiển thị các làn đường và đường mòn dành cho xe đạp, đồng thời hạ cấp các đường lớn.

Phương thức
`getMap`	`getMap()` Thông số: Không có Giá trị trả về: `Map\|null` Trả về bản đồ hiển thị lớp này.
`setMap`	`setMap(map)` Thông số: `map`: `Map optional` Giá trị trả về: `void` Kết xuất lớp trên bản đồ được chỉ định. Nếu bạn đặt map thành `null`, lớp này sẽ bị xoá.
Kế thừa: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Giao diện CameraOptions

Giao diện google.maps.CameraOptions

Dùng để đặt các tuỳ chọn máy ảnh của bản đồ.

Thuộc tính
`center optional`	Loại: `LatLngLiteral\|LatLng optional`
`heading optional`	Loại: `number optional`
`tilt optional`	Loại: `number optional`
`zoom optional`	Loại: `number optional`

Giao diện VisibleRegion

Giao diện google.maps.VisibleRegion

Chứa 4 điểm xác định hình đa giác 4 cạnh là vùng hiển thị của bản đồ. Trên bản đồ vectơ, đa giác này có thể là hình thang thay vì hình chữ nhật, khi bản đồ vectơ có độ nghiêng.

Thuộc tính
`farLeft`	Loại: `LatLng`
`farRight`	Loại: `LatLng`
`latLngBounds`	Loại: `LatLngBounds` Hộp giới hạn nhỏ nhất bao gồm vùng hiển thị.
`nearLeft`	Loại: `LatLng`
`nearRight`	Loại: `LatLng`

Hằng số RenderingType

Hằng số google.maps.RenderingType

Truy cập bằng cách gọi const {RenderingType} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Hằng số
`RASTER`	Cho biết bản đồ là bản đồ đường quét.
`UNINITIALIZED`	Cho biết chưa biết bản đồ là vectơ hay đường quét vì bản đồ chưa hoàn tất quá trình khởi chạy.
`VECTOR`	Cho biết bản đồ là bản đồ vectơ.

Giao diện MapCapabilities

Giao diện google.maps.MapCapabilities

Đối tượng chứa thông tin tổng quan nhanh về những tính năng hiện có cho Bản đồ. Xin lưu ý rằng điều này không nhất thiết có nghĩa là các mô-đun liên quan được tải hoặc khởi chạy, mà là bản đồ hiện tại có quyền sử dụng các API này. Hãy xem các thuộc tính để biết danh sách các chức năng có thể có.

Thuộc tính
`isAdvancedMarkersAvailable optional`	Loại: `boolean optional` Nếu đúng, bản đồ này được định cấu hình đúng cách để cho phép sử dụng điểm đánh dấu nâng cao. Xin lưu ý rằng bạn vẫn phải nhập thư viện `marker` để sử dụng các điểm đánh dấu nâng cao. Hãy xem https://goo.gle/gmp-isAdvancedMarkersAvailable để biết thêm thông tin.
`isDataDrivenStylingAvailable optional`	Loại: `boolean optional` Nếu đúng, bản đồ này được định cấu hình đúng cách để cho phép sử dụng kiểu dựa trên dữ liệu cho ít nhất một FeatureLayer. Hãy xem https://goo.gle/gmp-data-driven-styling và https://goo.gle/gmp-FeatureLayerIsAvailable để biết thêm thông tin.
`isWebGLOverlayViewAvailable optional`	Loại: `boolean optional` Nếu đúng, bản đồ này được định cấu hình đúng cách để cho phép sử dụng `WebGLOverlayView`.

Maps

Lớp Map

Hàm dựng

Hằng số

Thuộc tính

Phương thức

Sự kiện

Giao diện MapOptions

Thuộc tính

Lớp MapElement

Hàm dựng

Thuộc tính

Máy giật xèng

Phương thức

Sự kiện

Giao diện MapElementOptions

Thuộc tính

Lớp ZoomChangeEvent

Giao diện MapTypeStyle

Thuộc tính

Giao diện MapMouseEvent

Thuộc tính

Phương thức

Giao diện IconMouseEvent

Thuộc tính

Phương thức

Hằng số ColorScheme

Hằng số

Hằng số MapTypeId

Hằng số

Lớp MapTypeRegistry

Hàm dựng

Phương thức

Giao diện MapRestriction

Thuộc tính

Lớp TrafficLayer

Hàm dựng

Phương thức

Giao diện TrafficLayerOptions

Thuộc tính

Lớp TransitLayer

Hàm dựng

Phương thức

Lớp BicyclingLayer

Hàm dựng

Phương thức

Giao diện CameraOptions

Thuộc tính

Giao diện VisibleRegion

Thuộc tính

Hằng số RenderingType

Hằng số

Giao diện MapCapabilities

Thuộc tính