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 Thư viện trong Maps JavaScript API.
Map
Map(mapDiv[, opts])
Tham số: 
  • mapDiv:  HTMLElement Bản đồ sẽ hiển thị để lấp đầy phần tử này.
  • opts:  MapOptions optional Lựa 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.
DEMO_MAP_ID Mã bản đồ có thể 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 phát hành công khai và không thể dùng cho những tính năng yêu cầu cấu hình đám mây (chẳng hạn như Kiểu đám mây).
controls
Các chế độ điều khiển bổ sung để đính kèm vào bản đồ. Để thêm một chế độ điều khiển vào bản đồ, hãy thêm <div> của chế độ điều khiển vào MVCArray tương ứng với ControlPosition mà chế độ điều khiển đó sẽ được hiển thị.
data
Loại:  Data
Một thực thể của Data, được liên kết với bản đồ. Thêm các đối tượng vào Data này để hiển thị một cách thuận tiện trên bản đồ này.
mapTypes
Loại:  MapTypeRegistry
Một sổ đă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 đồ bổ sung để phủ lên. Các loại bản đồ lớp phủ sẽ hiển thị ở trên cùng của 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).
fitBounds
fitBounds(bounds[, padding])
Tham 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 ranh giới sẽ vừa với phần còn lại của bản đồ sau khi khoảng đệm bị xoá. Giá trị số sẽ tạo ra khoảng đệm giống nhau ở cả 4 phía. Cung cấp 0 ở đây để tạo một fitBounds có tính chất luỹ đẳng trên kết quả của getBounds.
Giá trị trả về:  Không có
Đặt khung nhìn để chứa các ranh giới đã 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 làm gì cả. Để thay đổi khung nhìn trong 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 một ảnh động mượt mà khi bản đồ di chuyển và thu phóng để vừa với ranh giới. Việc phương thức này có tạo hiệu ứng hay không phụ thuộc vào một phương pháp phỏng đoán nội bộ.
getBounds
getBounds()
Tham số:  Không có
Giá trị trả về:  LatLngBounds|undefined Ranh giới vĩ độ/kinh độ của khung nhìn hiện tại.
Trả về ranh giới vĩ độ/kinh độ của khung nhìn hiện tại. Nếu có nhiều bản sao của thế giới xuất hiện, thì phạm vi ranh giới theo kinh độ sẽ từ -180 đến 180 độ (bao gồm). Nếu bản đồ chưa được khởi chạy hoặc tâm và mức thu phóng chưa được đặt, thì kết quả sẽ là undefined. Đối với bản đồ vectơ có độ nghiêng hoặc hướng khác 0, ranh giới vĩ độ/kinh độ được trả về sẽ biểu thị hộp giới hạn nhỏ nhất bao gồm vùng hiển thị của khung nhìn bản đồ. Xem MapCanvasProjection.getVisibleRegion để biết chính xác khu vực hiển thị của khung hiển thị bản đồ.
getCenter
getCenter()
Tham số:  Không có
Giá trị trả về:  LatLng|undefined
Trả về vị trí xuất hiện ở tâm bản đồ. Xin lưu ý rằng đối tượng LatLng này không được bao bọc. 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()
Tham 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 được gọi là POI. Nếu giá trị trả về là true, thì bạn có thể nhấp vào các biểu tượng trên bản đồ.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Tham số: 
  • datasetId:  string
Giá trị trả về:  FeatureLayer
Trả về FeatureLayer cho datasetId được 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 tính năng Tạo kiểu dựa trên dữ liệu không có sẵn (không có mã nhận dạng bản đồ, không có ô vectơ, không có lớp đối tượng hoặc Tập dữ liệu Tạo kiểu dựa trên dữ liệu được định cấu hình trong Kiểu bản đồ), thì thao tác này sẽ ghi lại một lỗi và FeatureLayer.isAvailable kết quả sẽ là false.
getDiv
getDiv()
Tham số:  Không có
Giá trị trả về:  HTMLElement mapDiv của bản đồ.
getFeatureLayer
getFeatureLayer(featureType)
Tham số: 
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ó tính năng Tạo kiểu dựa trên dữ liệu (không có mã bản đồ, không có ô vectơ và không có FeatureLayer nào được bật trong kiểu bản đồ), thì thao tác này sẽ ghi lại một lỗi và FeatureLayer.isAvailable kết quả sẽ là false.
getHeading
getHeading()
Tham 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 Bắc. Nếu bản đồ chưa được khởi tạo, thì kết quả là undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
Tham số:  Không có
Giá trị trả về:  boolean|null
Trả về trạng thái bật/tắt của các tương tác với tiêu đề. 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 dùng (nếu có).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Tham số:  Không có
Giá trị trả về:  Iterable<string>|null
Trả về danh sách mã nhận dạng 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ư mức sử dụng thư viện phân cụm điểm đánh dấu.
getMapCapabilities
getMapCapabilities()
Tham số:  Không có
Giá trị trả về:  MapCapabilities
Thông báo cho người gọi về các chức năng hiện có của bản đồ dựa trên mã bản đồ được cung cấp.
getMapTypeId
getMapTypeId()
Tham số:  Không có
Giá trị trả về:  MapTypeId|string|undefined
getProjection
getProjection()
Tham 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ả là undefined. Theo dõi sự kiện projection_changed và kiểm tra giá trị của sự kiện đó để đảm bảo giá trị này không phải là undefined.
getRenderingType
getRenderingType()
Tham số:  Không có
Giá trị trả về:  RenderingType
Trả về RenderingType hiện tại của bản đồ.
getStreetView
getStreetView()
Tham số:  Không có
Giá trị trả về:  StreetViewPanorama Khung hiển thị toàn cảnh được liên kết với bản đồ.
Trả về StreetViewPanorama mặc định được 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 có ranh giới như vậy.
getTilt
getTilt()
Tham 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 đồ raster, kết quả sẽ là 0 đối với hình ảnh chụp từ trên cao hoặc 45 đối với hình ảnh chụp ở góc 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()
Tham số:  Không có
Giá trị trả về:  boolean|null
Trả về trạng thái bật/tắt của các lượt tương tác bằng cách nghiê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 dùng (nếu có).
getZoom
getZoom()
Tham 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 thì kết quả sẽ là undefined.
moveCamera
moveCamera(cameraOptions)
Tham số: 
Giá trị trả về:  Không có
Đặt ngay camera của bản đồ thành các lựa chọn camera mục tiêu mà không có hiệu ứng chuyển động.
panBy
panBy(x, y)
Tham số: 
  • x:  number Số lượng pixel để di chuyển bản đồ theo hướng x.
  • y:  number Số lượng 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 này nhỏ hơn cả chiều rộng và chiều cao của bản đồ, thì quá trình chuyển đổi sẽ diễn ra mượt mà. Xin lưu ý rằng hệ toạ độ bản đồ tăng từ tây sang đông (đối với giá trị x) và từ bắc xuống nam (đối với giá trị y).
panTo
panTo(latLng)
Tham số: 
Giá trị trả về:  Không có
Thay đổi tâm của bản đồ thành LatLng đã cho. Nếu mức 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 mượt mà.
panToBounds
panToBounds(latLngBounds[, padding])
Tham số: 
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral Ranh giới để di chuyển bản đồ đến.
  • padding:  number|Padding optional Khoảng đệm tính bằng pixel. Giá trị số sẽ tạo ra khoảng đệm giống nhau ở cả 4 phía. Giá trị mặc định là "0".
Giá trị trả về:  Không có
Di chuyển bản đồ theo mức tối thiểu cần thiết để chứa LatLngBounds đã cho. Không có gì đảm bảo rằng ranh giới sẽ nằm ở đâu trên bản đồ, ngoại trừ việc bản đồ sẽ được dịch chuyển để hiển thị càng nhiều ranh giới càng tốt trong {currentMapSizeInPx} - {padding}. Đối với cả bản đồ raster và bản đồ vectơ, chế độ thu phóng, độ nghiêng và hướng của bản đồ sẽ không thay đổi.
setCenter
setCenter(latlng)
Tham số: 
Giá trị trả về:  Không có
setClickableIcons
setClickableIcons(value)
Tham số: 
  • value:  boolean
Giá trị trả về:  Không có
Kiểm soát việc các biểu tượng trên bản đồ có thể nhấp vào hay không. Biểu tượng bản đồ đại diện cho một địa điểm yêu thích, còn được gọi là POI. Để tắt khả năng nhấp vào các biểu tượng trên bản đồ, hãy truyền giá trị false vào phương thức này.
setHeading
setHeading(heading)
Tham 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 Bắc. Đối với bản đồ raster, phương thức này chỉ áp dụng cho hình ảnh chụp từ trên không.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
Tham số: 
  • headingInteractionEnabled:  boolean
Giá trị trả về:  Không có
Đặt xem có bật chế độ 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 dùng (nếu có).
setMapTypeId
setMapTypeId(mapTypeId)
Tham số: 
Giá trị trả về:  Không có
setOptions
setOptions(options)
Tham số: 
Giá trị trả về:  Không có
setRenderingType
setRenderingType(renderingType)
Tham số: 
Giá trị trả về:  Không có
Đặt RenderingType hiện tại của bản đồ.
setStreetView
setStreetView(panorama)
Tham số: 
  • panorama:  StreetViewPanorama optional Ảnh toàn cảnh cần liên kết với bản đồ.
Giá trị trả về:  Không có
Liên kết một StreetViewPanorama với bản đồ. Ảnh toàn cảnh này sẽ 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 chế độ xem toàn cảnh thành null sẽ liên kết chế độ xem toàn cảnh được nhúng mặc định trở lại bản đồ.
setTilt
setTilt(tilt)
Tham 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 sẽ bị hạn chế tuỳ thuộc vào mức thu phóng của bản đồ.

Đối với bản đồ raster, hãy kiểm soát hành vi chuyển đổi tự động cho góc tới của bản đồ. 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 từ trên cao 0° bất kể mức thu phóng và khung hiển thị. 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 mức thu phóng và khung hiển thị 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 những thứ khác nhau, nên đừng bind() thuộc tính tilt; làm như vậy có thể mang lại những hiệu ứng không thể đoán trước.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
Tham số: 
  • tiltInteractionEnabled:  boolean
Giá trị trả về:  Không có
Đặt xem có bật chế độ 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 dùng (nếu có).
setZoom
setZoom(zoom)
Tham số: 
  • zoom:  number Giá trị thu phóng càng lớn thì độ phân giải càng cao.
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
bounds_changed
function()
Đối số:  Không có
Sự kiện này sẽ kích hoạt khi ranh giới 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ố: 
Sự kiện này được kích hoạt khi người dùng nhấp vào bản đồ. MapMouseEvent có các thuộc tính cho vị trí được nhấp sẽ được trả về, trừ phi bạn nhấp vào biểu tượng địa điểm. Trong trường hợp đó, IconMouseEvent có mã địa điểm sẽ được trả về. IconMouseEvent và MapMouseEvent giống nhau, ngoại trừ việc 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 kích hoạt nếu người dùng nhấp vào một điểm đánh dấu hoặc cửa sổ thông tin.
contextmenu
function(event)
Đối số: 
Sự kiện này được kích hoạt khi sự kiện DOM contextmenu được kích hoạt trên vùng chứa bản đồ.
dblclick
function(event)
Đối số: 
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 chuột đôi khi sẽ kích hoạt một lần và đôi khi 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 nhiều lần 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 di chuyển bản đồ bằng bàn phím. Vui lòng sử dụng sự kiện Map.idle để xác định thời điểm người dùng ngừng di chuyển 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 hướng của 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ạng thái rảnh sau khi người dùng di chuyển 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 chức năng của bản đồ thay đổi.
maptypeid_changed
function()
Đối số:  Không có
Sự kiện này sẽ kích hoạt khi thuộc tính mapTypeId thay đổi.
mousemove
function(event)
Đối số: 
Sự kiện này sẽ kích hoạt bất cứ khi nào chuột của người dùng di chuyển trên vùng chứa bản đồ.
mouseout
function(event)
Đối số: 
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ố: 
Sự kiện này sẽ kích hoạt khi chuột của người dùng di chuyển 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 ô hiển thị đã tải xong.
tilt_changed
function()
Đối số:  Không có
Sự kiện này sẽ kích hoạt khi thuộc tính độ nghiêng của 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
function(event)
Đối số: 
Sự kiện này sẽ kích hoạt khi người dùng nhấp chuột phải vào bản đồ.

Giao diện MapOptions

google.maps.MapOptionsgiao diện

Đối tượng MapOptions dùng để xác định các thuộc tính có thể được đặt trên một Bản đồ.
backgroundColor optional
Loại:  string optional
Màu dùng cho nền của thẻ div Bản đồ. Màu này sẽ xuất hiện khi các ô chưa tải xong trong lúc người dùng di chuyển. Bạn chỉ có thể đặt lựa 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 Camera.
cameraControlOptions optional
Loại:  CameraControlOptions optional
Các lựa chọn hiển thị cho chế độ điều khiển Camera.
center optional
Loại:  LatLng|LatLngLiteral optional
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 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 được 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 Bản đồ. Bạn chỉ có thể đặt lựa 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 chế độ đ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 đó có thể khiến các chế độ kiểm soát chuyển sang trạng thái undefined. Chỉ điều chỉnh các chế độ kiểm soát do chính Maps API tạo ra. Không điều chỉnh tỷ lệ các chế độ kiểm soát 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 mặc định trên giao diện người dùng. Có thể bị ghi đè riêng lẻ. Không tắt các chế độ điều khiển bằng bàn phím (được kiểm soát riêng bằng lựa chọn MapOptions.keyboardShortcuts). Không tắt chế độ điều khiển bằng cử chỉ. Chế độ này được kiểm soát riêng bằng lựa chọn MapOptions.gestureHandling.
disableDoubleClickZoom optional
Loại:  boolean optional
Bật/tắt tính năng thu phóng và căn giữa khi nhấp đúp. Bật theo mặc định.

Lưu ý: Bạn không nên dùng thuộc tính này. Để tắt tính năng thu phóng khi nhấp đúp, bạn có thể sử dụng thuộc tính gestureHandling và đặt thành "none".
draggable optional
Loại:  boolean optional
Nếu false, ngăn không cho kéo bản đồ. 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ẽ xuất hiện khi di chuột lên một bản đồ có thể kéo. Thuộc tính này dùng thuộc tính cursor css để thay đổi biểu tượng. Giống như 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ỏ sẽ hiển thị khi bản đồ đang được kéo. Thuộc tính này dùng thuộc tính cursor css để thay đổi biểu tượng. Giống như 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 lựa chọn hiển thị cho chế độ Điều khiển ở chế độ 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ử chỉ trên bản đồ. Các giá trị được phép:
  • "cooperative": Các sự kiện cuộn và cử chỉ chạm một ngón tay sẽ cuộn trang chứ không phóng to hoặc di chuyển bản đồ. Cử chỉ chạm bằng hai ngón tay sẽ di chuyển và thu phóng bản đồ. Sự kiện cuộn khi nhấn phím ctrl hoặc phím ⌘ sẽ thu phóng bản đồ.
    Ở chế độ này, bản đồ sẽ hợp tác với trang.
  • "greedy": Tất cả cử chỉ chạm và sự kiện cuộn đều di chuyển hoặc thu phóng bản đồ.
  • "none": Người dùng không thể dùng cử chỉ để xoay hoặc thu phóng bản đồ.
  • "auto": (mặc định) Thao tác xử lý cử chỉ là cộng tác hoặc tham lam, tuỳ thuộc vào việc trang có thể cuộn hay ở trong iframe.
heading optional
Loại:  number optional
Hướng của hình ảnh trên không tính bằng độ, đo theo chiều kim đồng hồ từ hướng Bắc. Hướng được điều chỉnh theo góc gần nhất 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 kiểm soát hướng camera (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 dùng (nếu có).
internalUsageAttributionIds optional
Loại:  Iterable<string> optional
Mặc định: null
Thêm mã nhận dạng phân bổ mức sử dụng vào trình khởi tạo. Mã 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ư mức sử dụng thư viện phân cụm điểm đánh dấu. Để chọn không gửi mã nhận dạng 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ị riêng biệt. Những thay đổi đối với giá trị này sau khi khởi tạo có thể bị bỏ qua.
isFractionalZoomEnabled optional
Loại:  boolean optional
Mặc định: true cho bản đồ vectơ và false cho bản đồ raster
Liệu bản đồ có cho phép các mức thu phóng phân số hay không. Nghe isfractionalzoomenabled_changed để biết thời điểm chế độ mặc định được đặt.
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 sẽ đượ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 một bản đồ được khởi tạo. 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 đá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 lựa chọn hiển thị ban đầu cho chế độ điều khiển Loại bản đồ.
mapTypeId optional
Loại:  MapTypeId|string optional
MapTypeId ban đầu của Bản đồ. Giá trị mặc định là ROADMAP.
maxZoom optional
Loại:  number optional
Mức thu phóng tối đa sẽ xuất hiện trên bản đồ. Nếu bạn bỏ qua hoặc đặt thành null, thì mức thu phóng tối đa của loại bản đồ hiện tại sẽ được dùng thay thế. Giá trị thu phóng hợp lệ là các số từ 0 cho đến mức thu phóng tối đa được hỗ trợ.
minZoom optional
Loại:  number optional
Mức thu phóng tối thiểu sẽ xuất hiện trên bản đồ. Nếu bị bỏ qua hoặc được đặt thành null, thì mức thu phóng 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 cho đế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
Loại:  boolean optional
Trạng thái bật/tắt của chế độ điều khiển Chảo.

panControlOptions optional
Loại:  PanControlOptions optional
Các lựa chọn hiển thị cho chế độ điều khiển Di chuyển.

renderingType optional
Loại:  RenderingType optional
Mặc định: RenderingType.RASTER
Bản đồ phải là bản đồ raster hay bản đồ vectơ. Bạn không thể đặt hoặc thay đổi tham số này sau khi một bản đồ được khởi tạo. Nếu bạn không đặt chế độ này, 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 bản đồ vectơ có thể không dùng được trên một số thiết bị và trình duyệt. Bản đồ sẽ chuyển về bản đồ raster khi cần.
restriction optional
Loại:  MapRestriction optional
Xác định ranh giới hạn chế khu vực của bản đồ mà người dùng có thể truy cập. Khi được đặt, người dùng chỉ có thể di chuyển và thu phóng trong khi chế độ xem camera vẫn 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 Xoay.
rotateControlOptions optional
Loại:  RotateControlOptions optional
Các lựa chọn hiển thị cho chế độ Xoay.
scaleControl optional
Loại:  boolean optional
Trạng thái bật/tắt ban đầu của chế độ điều khiển Scale (Tỷ lệ).
scaleControlOptions optional
Loại:  ScaleControlOptions optional
Các lựa 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. Bánh xe cuộn được bật theo mặc định.

Lưu ý: Bạn không nên dùng thuộc tính này. Để tắt tính năng thu phóng bằng con lăn, bạn có thể dùng thuộc tính gestureHandling và đặt thành "cooperative" hoặc "none".
streetView optional
Loại:  StreetViewPanorama optional
Một StreetViewPanorama sẽ xuất hiện khi bạn thả người hình mắc áo Chế độ xem đường phố vào bản đồ. Nếu bạn không chỉ định ảnh toàn cảnh, thì StreetViewPanorama mặc định sẽ xuất hiện trong div của bản đồ khi bạn thả hình nhân.
streetViewControl optional
Loại:  boolean optional
Trạng thái ban đầu (đã bật/tắt) 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 thuộc 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 đồ mà lớp phủ đường của Chế độ xem đường phố không được xuất hiện (ví dụ: loại bản đồ không phải là bản đồ Trái Đất).
streetViewControlOptions optional
Loại:  StreetViewControlOptions optional
Các lựa 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, những 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ã nhận dạng bản đồ hoặc khi sử dụng bản đồ vectơ (thay vào đó, hãy sử dụng tính năng tạo kiểu cho bản đồ dựa 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 sẽ bị hạn chế tuỳ thuộc vào mức thu phóng của bản đồ. Đối với bản đồ raster, hãy kiểm soát hành vi chuyển đổi tự động cho góc tới của bản đồ. 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 từ 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 hiển thị 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 lựa chọn này chỉ định. Vì getTilt và lựa chọn này đề cập đến những thứ khác nhau, nên đừng bind() thuộc tính tilt; làm như vậy có thể gây ra những 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 kiểm soát độ nghiêng của camera 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 dùng (nếu có).
zoom optional
Loại:  number optional
Cấp độ thu phóng ban đầu của Bản đồ. Giá trị thu phóng hợp lệ là các số từ 0 cho đến mức thu phóng tối đa được hỗ trợ. Giá trị thu phóng càng lớn thì độ phân giải càng cao.
zoomControl optional
Loại:  boolean optional
Trạng thái bật/tắt của chế độ thu phóng.
zoomControlOptions optional
Loại:  ZoomControlOptions optional
Các lựa chọn hiển thị cho chế độ điều khiển Thu phóng.

Lớp MapElement

Lớp google.maps.MapElement

MapElement là một lớp con HTMLElement để hiển thị bản đồ. Sau khi tải thư viện maps, bạn có thể tạo một bản đồ bằng 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>
Về nội bộ, nó sử dụng Map. Bạn có thể truy cập vào Map 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 Thư viện trong Maps JavaScript API.
MapElement
MapElement([options])
Tham số: 
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 kiểm soát hướng camera (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 dùng (nếu có).
Thuộc tính HTML:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
Loại:  Map
Một 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ã nhận dạng phân bổ mức sử dụng vào trình khởi tạo. Mã 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ư mức sử dụng thư viện phân cụm điểm đánh dấu. Để chọn không gửi mã nhận dạng 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ị riêng biệt. Những thay đổi đối với giá trị này sau khi khởi tạo 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 một bản đồ được khởi tạo. 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 đá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
Bản đồ phải là bản đồ raster hay bản đồ vectơ. Bạn không thể đặt hoặc thay đổi tham số này sau khi một bản đồ được khởi tạo. Nếu bạn không đặt chế độ này, 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 bản đồ vectơ có thể không dùng được trên một số thiết bị và trình duyệt. Bản đồ sẽ chuyển về bản đồ raster khi 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 kiểm soát độ nghiêng của camera 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 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 cho đến mức thu phóng tối đa được hỗ trợ. Giá trị thu phóng càng lớn thì độ phân giải càng cao.
Thuộc tính HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Đặt phần tử có khe cắm ở vị trí ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Đặt phần tử có khe cắm ở vị trí ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Đặt phần tử có khe cắm ở vị trí ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Đặt phần tử có khe cắm ở vị trí ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Đặt phần tử có khe cắm ở vị trí ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Đặt phần tử có khe cắm ở vị trí ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Đặt phần tử có khe cắm ở vị trí ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Đặt phần tử có khe cắm ở vị trí ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Đặt phần tử có khe cắm ở vị trí ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Đặt phần tử có khe cắm ở vị trí ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Đặt phần tử có khe cắm ở vị trí ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Đặt phần tử có khe cắm ở vị trí ControlPosition.INLINE_START_BLOCK_START.
default
Bạn có thể tạo các thành phần có thể tái sử dụng xung quanh Maps JavaScript Web Components, 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 phân bổ và hiển thị trong MapPanes.overlayMouseTarget. Tuy nhiên, các Thành phần web của Maps JavaScript API có thể được chuyển lại vào các khe cắm nội bộ của MapElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị 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 một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa 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 gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.
gmp-zoomchange
function(event)
Đối số: 
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

google.maps.MapElementOptionsgiao diện

Đối tượng MapElementOptions dùng để xác định các thuộc tính có thể được đặt trên một MapElement.
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 Thư viện trong Maps JavaScript API.

Giao diện MapTypeStyle

google.maps.MapTypeStylegiao diện

MapTypeStyle là một tập hợp các bộ chọn và bộ tạo 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 phần tử trên bản đồ cần được áp dụng, còn bộ định kiểu chỉ định cách sửa đổi các đối tượng và phần tử đó. Để biết thông tin chi tiết, hãy xem tài liệu tham khảo về kiểu.
stylers
Loại:  Array<Object>
Các quy tắc về kiểu để áp dụng cho các đối tượng và phần tử 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 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 chữ.
elementType optional
Loại:  string optional
Phần tử mà bạn nên áp dụng một trình tạo kiểu. Phần tử là một khía cạnh trực quan 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ị đượ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
Đối tượng hoặc nhóm đối tượng mà bạn nên áp dụng một kiểu. Không bắt buộc. Nếu bạn không chỉ định featureType, giá trị đượ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

google.maps.MapMouseEventgiao diện

Đố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 xuất hiện bên dưới.
domEvent
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ộ Maps API. Do việc lập bản đồ sự kiện nội bộ, domEvent có thể có ngữ nghĩa khác với MapMouseEvent (ví dụ: MapMouseEvent "click" 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.
stop
stop()
Tham số:  Không có
Giá trị trả về:  void
Ngăn sự kiện này lan truyền thêm.

Giao diện IconMouseEvent

google.maps.IconMouseEventgiao diện

Đố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 đi. Tìm hiểu thêm về mã địa điểm trong hướng dẫn dành cho nhà phát triển Places API.

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

placeId optional
Loại:  string optional
Mã địa điểm của địa điểm được nhấp vào. Bạn có thể dùng mã địa điểm này để truy vấn thêm thông tin về tính năng mà người dùng đã 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 Places API.
Được kế thừa: domEvent, latLng
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 giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. 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 Thư viện trong Maps JavaScript API.
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 các 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 MapType phổ biến. Chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. 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 Thư viện trong Maps JavaScript API.
HYBRID Loại bản đồ này hiển thị một lớp trong suốt gồm 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

Một sổ đăng ký cho các thực thể MapType, được khoá theo 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 Thư viện trong Maps JavaScript API.
MapTypeRegistry
MapTypeRegistry()
Tham số:  Không có
MapTypeRegistry lưu trữ tập hợp các loại bản đồ tuỳ chỉnh mà bản đồ có thể sử dụng. API sẽ 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ế độ kiểm soát, chẳng hạn như.
set
set(id, mapType)
Tham 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 cần 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

google.maps.MapRestrictiongiao diện

Một quy định hạn chế có thể áp dụng cho Bản đồ. Khung hiển thị của bản đồ sẽ không vượt quá những hạn chế này.
latLngBounds
Khi được đặt, người dùng chỉ có thể di chuyển và thu phóng trong phạm vi đã cho. Ranh giới có thể hạn chế cả kinh độ và vĩ độ hoặc chỉ hạn chế vĩ độ. Đối với các ranh giới 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 cờ strictBounds thành true để giới hạn phạm vi. Điều này làm giảm mức độ thu nhỏ mà người dùng có thể thực hiện, đảm bảo rằng mọi thứ bên ngoài ranh giới bị hạn chế đều bị ẩn. Giá trị mặc định là false, tức là người dùng có thể thu nhỏ cho đến khi toàn bộ vùng giới hạn xuất hiện trong khung hiển thị, có thể bao gồm cả các vùng bên ngoài vùng giới hạn.

Lớp TrafficLayer

Lớp google.maps.TrafficLayer

Lớp giao thông.

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 Thư viện trong Maps JavaScript API.
TrafficLayer
TrafficLayer([opts])
Tham số: 
Một lớp hiển thị tình hình giao thông đường bộ hiện tại.
getMap
getMap()
Tham số:  Không có
Giá trị trả về:  Map|null
Trả về bản đồ mà lớp này được hiển thị.
setMap
setMap(map)
Tham số: 
  • map:  Map optional
Giá trị trả về:  Không có
Kết xuất lớp trên bản đồ đã chỉ định. Nếu bản đồ được đặt thành null, thì lớp sẽ bị xoá.
setOptions
setOptions(options)
Tham số: 
Giá trị trả về:  Không có
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Giao diện TrafficLayerOptions

google.maps.TrafficLayerOptionsgiao diện

Đối tượng TrafficLayerOptions dùng để xác định các thuộc tính có thể được đặt trên TrafficLayer.
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 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 phương tiện công cộng.

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 Thư viện trong Maps JavaScript API.
TransitLayer
TransitLayer()
Tham số:  Không có
Một lớp hiển thị các đường chuyển tuyến.
getMap
getMap()
Tham số:  Không có
Giá trị trả về:  Map|null
Trả về bản đồ mà lớp này được hiển thị.
setMap
setMap(map)
Tham số: 
  • map:  Map optional
Giá trị trả về:  void
Kết xuất lớp trên bản đồ đã chỉ định. Nếu bản đồ được đặt thành null, thì lớp 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 cho biết đường và làn đườ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 Thư viện trong Maps JavaScript API.
BicyclingLayer
BicyclingLayer()
Tham số:  Không có
Một lớp hiển thị làn đường và đường dành cho xe đạp, đồng thời giảm mức độ hiển thị của các con đường lớn.
getMap
getMap()
Tham số:  Không có
Giá trị trả về:  Map|null
Trả về bản đồ mà lớp này được hiển thị.
setMap
setMap(map)
Tham số: 
  • map:  Map optional
Giá trị trả về:  void
Kết xuất lớp trên bản đồ đã chỉ định. Nếu bản đồ được đặt thành null, thì lớp sẽ bị xoá.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Giao diện CameraOptions

google.maps.CameraOptionsgiao diện

Dùng để đặt các lựa chọn về camera của bản đồ.
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

google.maps.VisibleRegiongiao diện

Chứa 4 điểm xác đị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ơ bị nghiêng.
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 Thư viện trong Maps JavaScript API.
RASTER Cho biết rằng bản đồ là bản đồ raster.
UNINITIALIZED Cho biết rằng bạn chưa biết bản đồ là vectơ hay raster, vì bản đồ chưa hoàn tất quá trình khởi tạo.
VECTOR Cho biết rằng bản đồ là bản đồ vectơ.

Giao diện MapCapabilities

google.maps.MapCapabilitiesgiao diện

Đối tượng chứa ảnh chụp nhanh về những chức 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 có liên quan được tải hoặc khởi tạo, 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ó.
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 truy cập vào 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 truy cập vào 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 là true, thì bản đồ này được định cấu hình đúng cách để cho phép sử dụng WebGLOverlayView.