Maps

Bản đồ

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 API JavaScript của Maps.
Map
Map(mapDiv[, opts])
Thông số: 
  • mapDiv:  HTMLElement Bản đồ sẽ kết xuất để lấp đầy thành phần này.
  • opts:  MapOptions optional Tùy chọn
Tạo bản đồ mới bên trong vùng chứa HTML đã cho, thường là phần tử DIV.
controls
Các đ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 mà thành phần này nên được kết xuất.
data
Loại:  Data
Một bản sao của Data, liên kết với bản đồ. Thêm đối tượng vào đối tượng Data này để hiển thị chúng dễ dàng trên bản đồ này.
mapTypes
Loại:  MapTypeRegistry
Sổ đăng ký các phiên bản MapType theo mã chuỗi.
overlayMapTypes
Loại:  MVCArray<MapType optional>
Loại bản đồ bổ sung cho lớp phủ. Các loại bản đồ lớp phủ sẽ xuất hiện ở đầu bản đồ cơ sở đượ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ẽ xuất hiện trước những lớp phủ có giá trị chỉ mục thấp hơn).
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 ranh giới này sẽ vừa với một phần của bản đồ còn lại sau khi khoảng đệm bị xóa. Một giá trị số sẽ cho ra cùng một khoảng đệm ở cả 4 cạnh. Cung cấp 0 ở đây để tạo giá trị phù hợp FitBounds trên kết quả của getBounds.
Giá trị trả lại: Không có
Đặt khung nhìn để chứa các giới hạn đã cho.
Lưu ý: Khi bạn đặt bản đồ thành display: none, hàm fitBounds sẽ đọc kích thước của bản đồ dưới dạng 0x0 và không thực hiện thao tác nào. Để thay đổi khung nhìn trong khi bản đồ bị ẩn, hãy đặt bản đồ thành visibility: hidden, để đảm bảo div bản đồ có kích thước thực. Đối với bản đồ vectơ, phương pháp này sẽ đặt độ nghiêng của bản đồ và hướng tới giá trị 0 mặc định của bản đồ. Việc gọi phương thức này có thể khiến ảnh động mượt mà khi bản đồ xoay và thu phóng để vừa với ranh giới. 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 Các ranh giới vĩ độ/kinh độ của chế độ xem hiện tại.
Trả về ranh giới vĩ độ/kinh độ của chế độ xem hiện tại. Nếu có nhiều hơn một bản sao của thế giới được hiển thị, giới hạn được tính bằng kinh độ từ -180 đến 180 độ. Nếu bản đồ chưa được khởi tạo hoặc tâm và mức thu phóng chưa được thiết lập thì kết quả sẽ là undefined. Đối với bản đồ vectơ có độ nghiêng hoặc tiêu đề khác 0, các giới hạn vĩ độ/kinh độ được trả về đại diện cho hộp bao quanh nhỏ nhất bao gồm vùng nhìn được của chế độ xem bản đồ. Xem MapCanvasProjection.getVisibleRegion để có được khu vực hiển thị chính xác của khung nhìn của bản đồ.
getCenter
getCenter()
Thông số: Không có
Giá trị trả về:  LatLng|undefined
Trả về vị trí được hiển thị ở giữa bản đồ. Xin lưu ý rằng đối tượng LatLng này không được bọc. Vui lòng tham khảo LatLng để biết thêm thông tin. Nếu bạn chưa đặt trung 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 của các biểu tượng bản đồ. Biểu tượng bản đồ thể hiện một địa điểm ưa thích, còn được gọi là địa điểm ưa thích. Nếu giá trị được trả về là true, thì có thể nhấp vào các biểu tượng trên bản đồ.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Thông số: 
  • datasetId:  string
Giá trị trả về:  FeatureLayer
Trả về FeatureLayer cho datasetId được chỉ định. ID tập dữ liệu phải được định cấu hình trong Google Cloud Console. Nếu ID 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 kiểu dữ liệu không có sẵn (không có ID bản đồ, không có ô vectơ, không có lớp đối tượng Kiểu dữ liệu theo hướng dữ liệu hoặc Tập dữ liệu được định cấu hình trong Kiểu bản đồ), điều này sẽ ghi lại một lỗi và FeatureLayer.isAvailable kết quả sẽ là false.
getDiv
getDiv()
Thông số: Không có
Giá trị trả về:  HTMLElement MapDiv của bản đồ.
getFeatureLayer
getFeatureLayer(featureType)
Thông số: 
Giá trị trả về:  FeatureLayer
Trả về FeatureLayer của FeatureType cụ thể. Bạn phải bật mộ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 theo hướng Dữ liệu (không có ID bản đồ, không có ô vectơ và không có FeatureLayer nào được bật trong kiểu bản đồ), điều này sẽ ghi lại một lỗi và FeatureLayer.isAvailable kết quả sẽ là false.
getHeading
getHeading()
Thông số: Không có
Giá trị trả về:  number|undefined
Trả về tiêu đề la bàn của bản đồ. Giá trị tiêu đề đượ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ả sẽ là undefined.
getMapCapabilities
getMapCapabilities()
Thông số: Không có
Giá trị trả về:  MapCapabilities
Thông báo cho người gọi về các khả năng hiện có sẵn có trên bản đồ dựa trên ID 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. Nghe sự kiện projection_changed và kiểm tra giá trị của sự kiện đó để đảm bảo sự kiện đó 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 được liên kết với bản đồ.
Trả về StreetViewPanorama mặc định được liên kết với bản đồ, 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(). Các thay đổi đối với streetViewControl của bản đồ sẽ được phản ánh trong giao diện của ảnh toàn cảnh được ràng buộc 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 chế độ xem đế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 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 chi tiết.
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, thì kết quả sẽ là undefined.
moveCamera
moveCamera(cameraOptions)
Thông số: 
Giá trị trả lại: Không có
Ngay lập tức đặt máy ảnh của bản đồ thành tùy chọn máy ảnh mục tiêu mà không cần hoạt ảnh.
panBy
panBy(x, y)
Thông số: 
  • x:  number Số pixel cần di chuyển bản đồ theo hướng x.
  • y:  number Số pixel cần di chuyển bản đồ theo hướng y.
Giá trị trả lại: 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 đồ, chuyển đổi sẽ được làm mượt hoạt ảnh. Lưu ý rằng hệ tọa độ bản đồ tăng từ tây sang đông (đối với giá trị x) và bắc xuống nam (đối với giá trị y).
panTo
panTo(latLng)
Thông số: 
Giá trị trả lại: Không có
Thay đổi tâm của bản đồ thành LatLng đã cho. Nếu sự thay đổi nhỏ hơn cả chiều rộng và chiều cao của bản đồ, chuyển đổi sẽ được làm động một cách mượt mà.
panToBounds
panToBounds(latLngBounds[, padding])
Thông số: 
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral Các giới hạn để xoay bản đồ tới.
  • padding:  number|Padding optional Khoảng đệm tính bằng pixel. Một giá trị số sẽ cho ra cùng một khoảng đệm ở cả 4 cạnh. Giá trị mặc định là "0".
Giá trị trả lại: Không có
Xoay bản đồ theo lượng tối thiểu cần thiết để chứa LatLngBounds đã cho. Nó không đảm bảo rằng ranh giới sẽ ở đâu trên bản đồ, ngoại trừ việc bản đồ sẽ được xoay để hiển thị nhiều giới hạn nhất có thể trong {currentMapSizeInPx} - {padding}. Đối với cả bản đồ đường quét và vectơ, việc thu phóng, nghiêng và tiêu đề của bản đồ sẽ không thay đổi.
setCenter
setCenter(latlng)
Thông số: 
Giá trị trả lại: Không có
setClickableIcons
setClickableIcons(value)
Thông số: 
  • value:  boolean
Giá trị trả lại: Không có
Kiểm soát xem có thể nhấp vào các biểu tượng bản đồ hay không. Biểu tượng bản đồ thể hiện một địa điểm ưa thích, còn được gọi là địa điểm ưa thích. Để vô hiệu hóa khả năng nhấp của các biểu tượng bản đồ, hãy chuyển một giá trị false vào phương thức này.
setHeading
setHeading(heading)
Thông số: 
  • heading:  number
Giá trị trả lại: Không có
Đặt hướng la bàn cho bản đồ đo bằng độ từ hướng Bắc. Đối với bản đồ quét, phương pháp này chỉ áp dụng cho hình ảnh chụp từ trên cao.
setMapTypeId
setMapTypeId(mapTypeId)
Thông số: 
Giá trị trả lại: Không có
setOptions
setOptions(options)
Thông số: 
Giá trị trả lại: Không có
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ả lại: 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 ảnh toàn cảnh bên ngoài 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 bản đồ.
setTilt
setTilt(tilt)
Thông số: 
  • tilt:  number
Giá trị trả lại: Không có
Đối với bản đồ vectơ, hãy đặt góc tới của bản đồ. Giá trị cho phép bị hạn chế tùy thuộc vào mức độ thu phóng của bản đồ. Đối với bản đồ quét, kiểm soát hành vi chuyển đổi tự động cho góc tới của bản đồ. Chỉ cho phép các giá trị 0 và 45. setTilt(0) làm cho bản đồ luôn sử dụng chế độ xem trên không 0° bất kể mức thu phóng và chế độ xem. setTilt(45) làm cho góc nghiêng tự động chuyển thành 45 bất cứ khi nào hình ảnh 45° có sẵn cho chế độ xem và mức thu phóng hiện tại và 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ó sẵn cho các loại bản đồ satellite và hybrid, ở 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 dùng để chỉ nhiều thứ, nên đừng dùng bind() thuộc tính tilt; làm như vậy có thể gây ra hiệu ứng khó dự đoán.
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ả lại: Không có
Đặt mức thu phóng của bản đồ.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
DEMO_MAP_ID ID bản đồ có thể được sử dụng cho các mẫu mã yêu cầu ID bản đồ. ID bản đồ này không nhằm sử dụng trong các ứng dụng sản xuất và không thể sử dụng cho các tính năng yêu cầu cấu hình đám mây (như Tạo kiểu đám mây).
bounds_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi 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 trung 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í đã nhấp được trả về trừ khi biểu tượng địa điểm được nhấp vào, trong trường hợp này, IconMouseEvent có ID địa điểm được trả về. IconMouseEvent và MapMouseEvent giống hệt nhau, ngoại trừ IconMouseEvent có trường mã địa điểm. Sự kiện luôn có thể được coi là MapMouseEvent khi ID địa điểm không quan trọng. Sự kiện nhấp chuột không được kích hoạt nếu điểm đánh dấu hoặc cửa sổ thông tin đã được nhấp vào.
contextmenu
function(event)
Đối số: 
Sự kiện này được kích hoạt khi sự kiện trình đơn ngữ cảnh DOM đượ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 đồ. Lưu ý rằng sự kiện nhấp chuột cũng sẽ kích hoạt, 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 đồ.
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ở nên không hoạt động 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 khả 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ố: 
Sự kiện này được kích hoạt bất cứ khi nào chuột của người dùng di chuyển qua 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 thoát khỏi vùng chứa bản đồ.
mouseover
function(event)
Đối số: 
Sự kiện này được kích hoạt khi chuột của người dùng đi 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 renderType đã 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 đượ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
function(event)
Đối số: 
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 đồ.

MapOptions

Giao diện google.maps.MapOptions

Đối tượng MapOptions được sử dụng để xác định các thuộc tính có thể đặt trên Bản đồ.
backgroundColor optional
Loại:  string optional
Màu được sử dụng cho nền của div Map. Màu này sẽ hiển thị khi các hình xếp chưa được tải khi người dùng xoay. Bạn chỉ có thể đặt tùy chọn này khi khởi chạy bản đồ.
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, không thể nhấp vào biểu tượng bản đồ. Biểu tượng bản đồ thể hiện một địa điểm ưa thích, còn được gọi là địa điểm ưa thích.
controlSize optional
Loại:  number optional
Kích thước bằng pixel của các điều khiển xuất hiện trên bản đồ. Giá trị này phải được cung cấp trực tiếp khi tạo Bản đồ, cập nhật giá trị này sau đó có thể đưa các điều khiển vào trạng thái undefined. Chỉ chi phối các kiểm soát được thực hiện bởi API Maps. Không mở rộng phạm vi kiểm soát tùy 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 trên giao diện người dùng mặc định. Có thể bị ghi đè riêng. Không tắt các tuỳ chọn điều khiển bàn phím. Các tuỳ chọn này do tuỳ chọn MapOptions.keyboardShortcuts kiểm soát riêng. Không tắt các tuỳ chọn điều khiển bằng cử chỉ. Các tuỳ chọn này được kiểm soát riêng bằng tuỳ 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 trên nhấp đúp. Bật theo mặc định.

Lưu ý: Không nên sử 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 thuộc tính này thành "none".
draggable optional
Loại:  boolean optional
Nếu false, hãy ngăn 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ẽ 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 css cursor để thay đổi biểu tượng. Cũ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ỏ cần hiển thị khi bản đồ đang được kéo. Thuộc tính này sử dụng thuộc tính css cursor để thay đổi biểu tượng. Cũ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 điều khiển Toàn màn hình.
fullscreenControlOptions optional
Loại:  FullscreenControlOptions optional
Tùy chọn hiển thị cho đ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 bằng một ngón tay sẽ cuộn trang và không thu phóng hoặc xoay bản đồ. Các cử chỉ chạm bằng hai ngón tay xoay và thu phóng bản đồ. Cuộn sự kiện bằng phím ctrl hoặc phím ⌘ đã nhấn để thu phóng bản đồ.
    Trong 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 sẽ xoay hoặc thu phóng bản đồ.
  • "none": Không thể xoay hoặc thu phóng bản đồ bằng cử chỉ của người dùng.
  • "auto": (mặc định) Cách xử lý cử chỉ mang tính phối hợp hoặc tham lam, tuỳ thuộc vào việc trang có thể cuộn hay nằm trong iframe.
heading optional
Loại:  number optional
Hướng của hình ảnh trên không theo độ được đo theo chiều kim đồng hồ từ hướng đông bắc. Tiêu đề được gắn với góc sẵn có gần nhất mà hình ảnh có sẵn.
isFractionalZoomEnabled optional
Loại:  boolean optional
Mặc định: true cho bản đồ vectơ và false cho bản đồ quét
Bản đồ có cho phép mức thu phóng theo phân số hay không. Nghe isfractionalzoomenabled_changed để biết thời điểm mặc định được đặt.
keyboardShortcuts optional
Loại:  boolean optional
Nếu false, hãy ngăn bàn phím kiểm soát bản đồ. Phím tắt được bật theo mặc định.
mapId optional
Loại:  string optional
ID của Map của bản đồ. Không thể đặt hoặc thay đổi tham số này sau khi tạo bản đồ.
mapTypeControl optional
Loại:  boolean optional
Trạng thái bật/tắt ban đầu của kiểm soát Loại bản đồ.
mapTypeControlOptions optional
Loại:  MapTypeControlOptions optional
Tùy chọn hiển thị ban đầu cho kiểm soát Loại bản đồ.
mapTypeId optional
Loại:  MapTypeId|string optional
MapTypeId ban đầu của Map. Giá trị mặc định là ROADMAP.
maxZoom optional
Loại:  number optional
Mức thu phóng tối đa sẽ được hiển thị 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 sử dụng. Giá trị thu phóng hợp lệ là các số từ 0 trở lê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ẽ được hiển thị trên bản đồ. Nếu bạn bỏ qua hoặc đặt thành null, thì mức thu phóng tối thiểu từ 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 trở lên mức thu phóng tối đa được hỗ trợ.
noClear optional
Loại:  boolean optional
Nếu true, không được xoá nội dung của div Map.
panControl optional
Loại:  boolean optional
Trạng thái bật/tắt của điều khiển xoay.

Lưu ý: Điều khiển xoay không khả dụng trong bộ điều khiển mới được giới thiệu trong phiên bản 3.22 của API JavaScript của Google Maps. Trong khi sử dụng v3.22 và v3.23, bạn có thể chọn sử dụng bộ điều khiển trước đó hơn là các điều khiển mới, do đó làm cho điều khiển Pan có sẵn như một phần của bộ điều khiển cũ. Xem Tính năng mới trong Điều khiển bản đồ v3.22.
panControlOptions optional
Loại:  PanControlOptions optional
Tùy chọn hiển thị cho điều khiển xoay.

Lưu ý: Điều khiển xoay không khả dụng trong bộ điều khiển mới được giới thiệu trong phiên bản 3.22 của API JavaScript của Google Maps. Trong khi sử dụng v3.22 và v3.23, bạn có thể chọn sử dụng bộ điều khiển trước đó hơn là các điều khiển mới, do đó làm cho điều khiển Pan có sẵn như một phần của bộ điều khiển cũ. Xem Tính năng mới trong Điều khiển bản đồ v3.22.
restriction optional
Loại:  MapRestriction optional
Xác định ranh giới giới hạn khu vực bản đồ mà người dùng có thể truy cập. Khi bạn đặt chế độ này, người dùng chỉ có thể xoay và thu phóng trong khi chế độ xem của máy ảnh không vượt quá giới hạn.
rotateControl optional
Loại:  boolean optional
Trạng thái bật/tắt của điều khiển Xoay.
rotateControlOptions optional
Loại:  RotateControlOptions optional
Tùy chọn hiển thị cho điều khiển Xoay.
scaleControl optional
Loại:  boolean optional
Trạng thái bật/tắt ban đầu của Điều khiển tỷ lệ.
scaleControlOptions optional
Loại:  ScaleControlOptions optional
Các tùy chọn hiển thị ban đầu cho Đ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. Con lăn được bật theo mặc định.

Lưu ý: 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ể dùng thuộc tính gestureHandling và đặt thành "cooperative" hoặc "none".
streetView optional
Loại:  StreetViewPanorama optional
StreetViewPanorama để hiển thị khi người hình mắc áo ở Chế độ xem phố được thả trên bản đồ. Nếu không có ảnh toàn cảnh nào được chỉ định, StreetViewPanorama mặc định sẽ được hiển thị trong div của bản đồ khi người hình mắc áo bị thả.
streetViewControl optional
Loại:  boolean optional
Trạng thái kích hoạt/vô hiệu hóa ban đầu của kiểm soát Người hình mắc áo ở Chế độ xem phố. Chế độ đ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ị loại bản đồ mà lớp phủ đường ở Chế độ xem phố không xuất hiện (ví dụ: loại bản đồ không thuộc Earth).
streetViewControlOptions optional
Loại:  StreetViewControlOptions optional
Các tùy chọn hiển thị ban đầu cho điều khiển Người hình mắc áo của Chế độ xem phố.
styles optional
Loại:  Array<MapTypeStyle> optional
Kiểu để áp dụng cho từng loại bản đồ mặc định. Lưu ý rằng đối với chế độ satellite/hybrid và terrain, các kiểu này sẽ chỉ áp dụng cho nhãn và hình.
tilt optional
Loại:  number optional
Đối với bản đồ vectơ, hãy đặt góc tới của bản đồ. Giá trị cho phép bị hạn chế tùy thuộc vào mức độ thu phóng của bản đồ. Đối với bản đồ quét, kiểm soát hành vi chuyển đổi tự động cho góc tới của bản đồ. Chỉ cho phép các giá trị 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à chế độ xem. Giá trị 45 làm cho góc nghiêng tự động chuyển thành 45 bất cứ khi nào hình ảnh 45° có sẵn cho chế độ xem và mức thu phóng hiện tại và 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ó sẵn cho các loại bản đồ satellite và hybrid, ở 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 tham chiếu đến nhiều nội dung khác nhau, không nên bind() thuộc tính tilt; làm như vậy có thể gây ra hiệu ứng khó dự đoán.
zoom optional
Loại:  number optional
Mức thu phóng Bản đồ ban đầu. Giá trị thu phóng hợp lệ là các số từ 0 trở lê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 điều khiển Thu phóng.
zoomControlOptions optional
Loại:  ZoomControlOptions optional
Tùy chọn hiển thị cho điều khiển Thu phóng.

MapElement

Lớp google.maps.MapElement

MapElement là một 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"></gmp-map>

Trong nội bộ, phương thức này sử dụng Map có thể truy cập được bằng thuộc tính innerMap.

Phần tử tùy chỉnh:
<gmp-map center="lat,lng" map-id="string" 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 API JavaScript của Maps.
center
Loại:  LatLng|LatLngLiteral optional
Thuộc tính HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Loại:  Map
Tham chiếu đến Map mà MapElement sử dụng nội bộ.
mapId
Loại:  string optional
Thuộc tính HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
Loại:  number optional
Thuộc tính HTML:
  • <gmp-map zoom="number"></gmp-map>
BetaaddEventListener
addEventListener(type, listener[, options])
Thông số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường tượng trưng 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 một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem tùy 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 đã chỉ định được gửi tới đích. Xem addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Thông số: 
  • type:  string Một chuỗi chỉ định loại sự kiện mà bạn sẽ xoá trình nghe sự kiện.
  • listener:  EventListener|EventListenerObject Trình xử lý 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 tùy chọn
Giá trị trả về:  void
Xoá trình xử lý sự kiện đã đăng ký trước đó với addEventListener khỏi mục tiêu. Xem removeEventListener

MapElementOptions của giao diện

Giao diện google.maps.MapElementOptions

Đối tượng MapElementOptions được sử dụng để xác định các thuộc tính có thể đặt trên MapElement.
center optional
Loại:  LatLng|LatLngLiteral optional
Trung tâm bản đồ ban đầu.
mapId optional
Loại:  string optional
ID của Map của bản đồ. Không thể đặt hoặc thay đổi tham số này sau khi tạo bản đồ.
zoom optional
Loại:  number optional
Mức thu phóng Bản đồ ban đầu. Giá trị thu phóng hợp lệ là các số từ 0 trở lê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.

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

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

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 đồ. ID địa điểm của địa điểm này được lưu trữ trong thành viên placeId. Để ngăn cửa sổ thông tin mặc định hiển thị, hãy gọi phương thức stop() trong sự kiện này để ngăn sự kiện được truyền. Tìm hiểu thêm về ID địa điểm trong hướng dẫn dành cho nhà phát triển API Địa điểm.

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

placeId optional
Loại:  string optional
Mã địa điểm của địa điểm mà người dùng đã nhấp vào. Bạn có thể sử dụng ID địa điểm này để truy vấn thêm thông tin về đối tượng địa lý đã được nhấp vào.

Tìm hiểu thêm về ID địa điểm trong hướng dẫn dành cho nhà phát triển API Địa điểm.
Kế thừa: domEvent, latLng
Kế thừa: stop

Hằng số MapTypeId

hằng số google.maps.MapTypeId

Giá trị nhận dạng cho MapTypes chung. Hãy chỉ định các giá trị này theo giá trị hoặc sử dụng tên 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 API JavaScript của Maps.
HYBRID Loại bản đồ này hiển thị một lớp đường trong suốt trên các hình ảnh vệ tinh.
ROADMAP Loại bản đồ này hiển thị bản đồ phố bình thường.
SATELLITE Loại bản đồ này hiển thị các hình ảnh vệ tinh.
TERRAIN Loại bản đồ này hiển thị bản đồ với các đối tượng địa lý như địa hình và thảm thực vật.

MapTypeRegistry lớp

Lớp google.maps.MapTypeRegistry

Sổ đăng ký các phiên bản MapType, được khóa bởi id 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 API JavaScript của Maps.
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 kiểm soát.
set
set(id, mapType)
Thông số: 
  • id:  string Giá trị nhận dạng của MapType để thêm vào sổ đăng ký.
  • mapType:  MapType|* đối tượng MapType để thêm vào sổ đăng ký.
Giá trị trả lại: Không có
Thiết lập đăng ký để liên kết số nhận dạng chuỗi đã qua với MapType đã chuyển.
Kế thừa: addListener, bindTo, get, notify, setValues, unbind, unbindAll

MapRestriction

Giao diện google.maps.MapRestriction

Giới hạn có thể áp dụng cho Bản đồ. Chế độ xem của bản đồ sẽ không vượt quá các giới hạn này.
latLngBounds
Khi đặt, người dùng chỉ có thể xoay và thu phóng bên trong giới hạn đã cho. Giới hạn có thể giới hạn cả kinh độ và vĩ độ hoặc chỉ có thể giới hạn vĩ độ. Đối với giới hạn chỉ có vĩ độ, hãy sử dụng kinh độ tây và kinh độ tương ứng 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 lớn hơn bằng cách đặt cờ strictBounds thành true. Điều này làm giảm khoảng cách người dùng có thể thu nhỏ, đảm bảo rằng mọi thứ nằm ngoài ranh giới bị hạn chế vẫn bị ẩn. Tuỳ chọn mặc định là false, nghĩa là người dùng có thể thu nhỏ cho đến khi toàn bộ khu vực bị giới hạn hiển thị, có thể bao gồm cả các khu vực bên ngoài khu vực này.

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 API JavaScript của Maps.
TrafficLayer
TrafficLayer([opts])
Thông số: 
Một lớp hiển thị giao thông đường bộ hiện tại.
getMap
getMap()
Thông số: Không có
Giá trị trả về:  Map
Trả về bản đồ mà lớp này được hiển thị.
setMap
setMap(map)
Thông số: 
Giá trị trả lại: Không có
Hiển thị lớp trên bản đồ đã chỉ định. Nếu bản đồ được đặt thành null, lớp này sẽ bị xóa.
setOptions
setOptions(options)
Thông số: 
Giá trị trả lại: 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ể đặt trên một LayerLayer.
autoRefresh optional
Loại:  boolean optional
Mặc định: true
Liệu lớp lưu lượng có làm mới bằng thông tin cập nhật tự động hay không.
map optional
Loại:  Map optional
Bản đồ sẽ hiển thị lớp giao thông.

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 API JavaScript của Maps.
TransitLayer
TransitLayer()
Thông số: Không có
Lớp hiển thị đường chuyển tuyến.
getMap
getMap()
Thông số: Không có
Giá trị trả về:  Map
Trả về bản đồ mà lớp này được hiển thị.
setMap
setMap(map)
Thông số: 
Giá trị trả lại: Không có
Hiển thị lớp trên bản đồ đã chỉ định. Nếu bản đồ được đặt thành null, lớp này sẽ bị xóa.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

BicyclingLayer lớp

Lớp google.maps.BicyclingLayer

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

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

Giao diện CameraOptions

Giao diện google.maps.CameraOptions

Được sử dụng để đặt tùy chọn máy ảnh 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

Giao diện google.maps.VisibleRegion

Chứa bốn điểm xác định đa giác bốn phía 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.
farLeft
Loại:  LatLng
farRight
Loại:  LatLng
latLngBounds
Loại:  LatLngBounds
Hộp bao quanh 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 API JavaScript của Maps.
RASTER Cho biết rằng bản đồ là bản đồ quét.
UNINITIALIZED Cho biết rằng bản đồ chưa có vectơ hoặc đường quét, vì bản đồ chưa hoàn thành quá trình khởi tạo.
VECTOR Cho biết rằng bản đồ là bản đồ vectơ.

MapCapabilities

Giao diện google.maps.MapCapabilities

Đối tượng chứa ảnh chụp nhanh về những khả năng hiện có của Bản đồ. Xem các thuộc tính để biết danh sách các khả năng có thể xảy ra.
isAdvancedMarkersAvailable optional
Loại:  boolean optional
isDataDrivenStylingAvailable optional
Loại:  boolean optional