Maps

Lớp Map (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 Maps.
Map
Map(mapDiv[, opts])
Các thông số: 
  • mapDiv:  HTMLElement Bản đồ sẽ hiển thị để điền vào 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 nhất định, thường là phần tử DIV.
DEMO_MAP_ID Mã bản đồ có thể được dùng cho những mã mẫu yêu cầu Mã bản đồ. Mã bản đồ này không dành cho các ứng dụng phát hành chính thức và không thể dùng cho các tính năng yêu cầu cấu hình đám mây (chẳng hạn như Tạo kiểu trên đám mây).
controls
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 mà thành phần điều khiển cần được kết xuất.
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 đối tượng Data này để hiển thị chúng trên bản đồ này một cách thuận tiện.
mapTypes
Loại:  MapTypeRegistry
Sổ đăng ký gồm 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 cho lớp phủ. Loại bản đồ lớp phủ sẽ hiển thị ở đầu 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 lớp phủ có giá trị chỉ mục thấp hơn).
fitBounds
fitBounds(bounds[, padding])
Các thông số: 
  • bounds:  LatLngBounds|LatLngBoundsLiteral Giới hạn 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 ở cả 4 mặt. Cung cấp 0 tại đây để làm cho một fitBounds không thay đổi giá trị đối với kết quả của getBounds.
Giá trị trả lại hàng: Không có
Thiết lập 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 làm gì cả. Để thay đổi chế độ xem trong khi bản đồ bị ẩn, hãy đặt bản đồ thành visibility: hidden, do đó, đả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 sẽ đặt độ nghiêng và hướng của bản đồ về các giá trị mặc định bằng 0. Việc gọi phương thức này có thể tạo ra ảnh động mượt mà khi bản đồ xoay và thu phóng cho 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 tuỳ thuộc vào phương pháp phỏng đoán nội bộ.
getBounds
getBounds()
Tham số: Không có
Giá trị trả về:  LatLngBounds|undefined Giới hạn vĩ độ/lng của khung nhìn hiện tại.
Trả về giới hạn vĩ độ/lng của khung nhìn hiện tại. Nếu có nhiều bản sao của thế giới, thì giới hạn có kinh độ từ -180 đến 180 độ. Nếu bản đồ chưa được khởi chạy hoặc căn giữa và 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, giới hạn vĩ độ/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 của bản đồ. Xem MapCanvasProjection.getVisibleRegion để biết khu vực hiển thị chính xác cho khung nhìn của bản đồ.
getCenter
getCenter()
Tham số: Không có
Giá trị trả về:  LatLng|undefined
Trả về vị trí hiển thị ở trung tâm bản đồ. 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 giá trị giữa hoặc các giới hạn, 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 của các 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. Nếu giá trị được trả về là true, thì các biểu tượng có thể nhấp được trên bản đồ.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Các 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ã tập dữ liệu trong Google Cloud Console. Nếu mã 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 theo hướng dữ liệu không có sẵn (không có mã bản đồ, không có ô vectơ, không có lớp tính năng Tạo kiểu theo hướng dữ liệu hoặc Tập dữ liệu nào được định cấu hình trong Kiểu bản đồ), thì điều này sẽ ghi lại lỗi và kết quả FeatureLayer.isAvailable sẽ là false.
getDiv
getDiv()
Tham số: Không có
Giá trị trả về:  HTMLElement mapDiv của bản đồ.
getFeatureLayer
getFeatureLayer(featureType)
Các thông 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 Kiểu dựa trên dữ liệu không có sẵn (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ì điều này sẽ ghi lại lỗi và kết quả FeatureLayer.isAvailable sẽ có giá trị 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ị tiêu đề được đo bằng độ (theo chiều kim đồng hồ) tính 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.
getMapCapabilities
getMapCapabilities()
Tham số: Không có
Giá trị trả về:  MapCapabilities
Thông báo cho phương thức gọi về các tính năng hiện có sẵn có cho 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ả 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 sự kiện đó 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 Ả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 màn hình của ảnh toàn cảnh ràng buộc như vậy.
getTilt
getTilt()
Tham số: Không có
Giá trị trả về:  number|undefined
Trả về góc 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 cho hình ảnh chụp trực tiếp từ trên cao hoặc 45 cho hình ảnh 45°. Phương thức này không trả về giá trị do setTilt đặt. Hãy truy cập setTilt để biết chi tiết.
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)
Các thông số: 
Giá trị trả lại hàng: 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ần ảnh động.
panBy
panBy(x, y)
Các 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ả lại hàng: Không có
Thay đổi tâm 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 đồ, quá trình chuyển đổi sẽ diễn ra suôn sẻ. 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 lên nam (đối với giá trị y).
panTo
panTo(latLng)
Các thông số: 
Giá trị trả lại hàng: 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ẽ diễn ra suôn sẻ.
panToBounds
panToBounds(latLngBounds[, padding])
Các thông số: 
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral Các ranh giới cần xoay bả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 ở cả 4 mặt. Giá trị mặc định là "0".
Giá trị trả lại hàng: Không có
Xoay bản đồ theo số lượng tối thiểu cần thiết để chứa LatLngBounds đã cho. Điều này không đảm bảo rằng các ranh giới sẽ xuất hiện trên bản đồ, ngoại trừ việc bản đồ sẽ được xoay để 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ơ, mức thu phóng, độ nghiêng và tiêu đề của bản đồ sẽ không bị thay đổi.
setCenter
setCenter(latlng)
Các thông số: 
Giá trị trả lại hàng: Không có
setClickableIcons
setClickableIcons(value)
Các thông số: 
  • value:  boolean
Giá trị trả lại hàng: Không có
Kiểm soát xem có thể nhấp vào biểu tượng 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 của biểu tượng bản đồ, hãy truyền giá trị false vào phương thức này.
setHeading
setHeading(heading)
Các thông số: 
  • heading:  number
Giá trị trả lại hàng: 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 pháp này chỉ áp dụng cho hình ảnh trên không.
setMapTypeId
setMapTypeId(mapTypeId)
Các thông số: 
Giá trị trả lại hàng: Không có
setOptions
setOptions(options)
Các thông số: 
Giá trị trả lại hàng: Không có
setStreetView
setStreetView(panorama)
Các thông số: 
  • panorama:  StreetViewPanorama optional Ảnh toàn cảnh cần liên kết với bản đồ.
Giá trị trả lại hàng: 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 quay lại bản đồ.
setTilt
setTilt(tilt)
Các thông số: 
  • tilt:  number
Giá trị trả lại hàng: 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ị giới hạn tuỳ thuộc vào mức thu phóng của bản đồ. Đối với bản đồ đường quét, hãy 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 từ trên cao 0° bất kể mức thu phóng và khung nhìn. 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 mức thu phóng và khung nhìn 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, 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 tham chiếu đến những thứ khác nhau, nên đừng bind() thuộc tính tilt; việc này có thể dẫn đến các kết quả ngoài dự đoán.
setZoom
setZoom(zoom)
Các 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 hàng: 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 đượ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 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 đồ. Một MapMouseEvent có các thuộc tính cho vị trí đã nhấp sẽ được trả về trừ phi một biểu tượng địa điểm được nhấp vào, trong trường hợp đó, một IconMouseEvent có mã địa điểm được trả về. IconMouseEvent và MapMouseEvent giống hệt nhau, ngoại trừ việc IconMouseEvent có trường ID địa điểm. Sự kiện này 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 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 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 đồ. 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 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 đồ.
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 đồ chuyển sang 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ố: 
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 người dùng di chuột 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
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 đồ.

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ể đặt trên Bản đồ.
backgroundColor optional
Loại:  string optional
Màu được sử dụng cho nền của div bản đồ. Màu này sẽ hiển thị khi ô chưa được tải khi người dùng xoay. Bạn chỉ có thể đặt lựa chọn này khi bản đồ được khởi chạy.
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 sẽ không thể nhấp vào các 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.
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 đồ. Giá trị này phải được cung cấp trực tiếp khi tạo Bản đồ. Việc cập nhật giá trị này sau đó có thể chuyển các chế độ điều khiển sang trạng thái undefined. Chỉ chi phối các chế độ kiểm soát do chính API Maps 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ể bị ghi đè riêng. Không tắt các nút điều khiển bằng bàn phím (các nút điều khiển này được kiểm soát riêng bằng tuỳ chọn MapOptions.keyboardShortcuts). Không tắt các chế độ điều khiển bằng cử chỉ do 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 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 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 giá trị 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ỏ hiển thị khi di chuột lên 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. 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ỏ để 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. 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 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": Cuộn các sự kiện và cử chỉ chạm bằng một ngón tay để cuộn trang, đồng thời không thu phóng hoặc xoay bản đồ. Cử chỉ chạm bằng hai ngón tay xoay và thu phóng bản đồ. Cuộn các sự kiện bằng cách nhấn phím ctrl hoặc phím ⌘ để 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 xoay hoặc thu phóng bản đồ.
  • "none": Bạn 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) Xử lý cử chỉ mang tính hợp tác hoặc tham gia, tuỳ thuộc vào việc trang có thể cuộn hay nằm trong iframe.
heading optional
Loại:  number optional
Tiêu đề cho hình ảnh trên không theo độ được đo theo chiều kim đồng hồ từ hướng chính Bắc. Tiêu đề được gắn theo góc gần nhất hiện có cho hình ảnh sẵn có.
isFractionalZoomEnabled optional
Loại:  boolean optional
Mặc định: true đối với bản đồ vectơ và false đối với bản đồ đường quét
Liệu bản đồ có cho phép mức thu phóng phân số hay không. Theo dõi isfractionalzoomenabled_changed để biết thời điểm đặt chế độ mặc định.
keyboardShortcuts optional
Loại:  boolean optional
Nếu là 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
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 đồ.
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 tuỳ chọn điều khiển Loại bản đồ.
mapTypeId optional
Loại:  MapTypeId|string optional
MapTypeId ban đầu. Giá trị mặc định là ROADMAP.
maxZoom optional
Loại:  number optional
Mức thu phóng tối đa sẽ hiển thị trên bản đồ. Nếu bị bỏ qua hoặc được đặt thành null, mức thu phóng tối đa 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 đế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ẽ hiển thị trên bản đồ. Nếu bị bỏ qua hoặc được đặt thành null, 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 đến mức thu phóng tối đa được hỗ trợ.
noClear optional
Loại:  boolean optional
Nếu là true, không được 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 Lia máy.

panControlOptions optional
Loại:  PanControlOptions optional
Tuỳ chọn hiển thị cho chế độ điều khiển Lia máy.

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ính sách này, người dùng chỉ có thể xoay và thu phóng trong khi chế độ xem camera vẫn nằm trong các 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 chế độ điều khiển Xoay.
rotateControlOptions optional
Loại:  RotateControlOptions optional
Các tuỳ chọn hiển thị cho nút điều khiển Xoay.
scaleControl optional
Loại:  boolean optional
Trạng thái bật/tắt ban đầu của tính năng điều khiển Tỷ lệ.
scaleControlOptions optional
Loại:  ScaleControlOptions optional
Các tuỳ chọn hiển thị ban đầu cho tuỳ chọn đ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 chuột được 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 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 người hình mắc áo trong Chế độ xem đường phố bị thả trên bản đồ. Nếu bạn không chỉ định ảnh toàn cảnh, thì StreetViewPanorama mặc định sẽ hiển thị trong div của bản đồ khi người hình mắc áo được thả xuống.
streetViewControl optional
Loại:  boolean optional
Trạng thái bật/tắt ban đầu của kiểm soát Người hình mắc áo trong Chế độ xem đường 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 trong Chế độ xem đường phố sẽ không xuất hiện (ví dụ: loại bản đồ không phải Earth).
streetViewControlOptions optional
Loại:  StreetViewControlOptions optional
Các tùy chọn hiển thị ban đầu cho chế độ kiểm soát 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. 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 học.
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ị giới hạn tuỳ thuộc vào mức thu phóng của bản đồ. Đối với bản đồ đường quét, hãy 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. Giá trị 0 làm cho 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 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 mức thu phóng và khung nhìn 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, 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 tham chiếu đến nhiều đối tượng, nên đừng bind() thuộc tính tilt; việc này có thể dẫn đến các hiệu ứng ngoài dự đoán.
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 chế độ điều khiển Thu phóng.
zoomControlOptions optional
Loại:  ZoomControlOptions optional
Các tuỳ chọn hiển thị cho tuỳ chọn điều khiển Thu phóng.

Lớp 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 đồ ở dạ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>

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

Phần tử tuỳ 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 sẽ 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 Maps.
MapElement
MapElement([options])
Các thông 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>
innerMap
Loại:  Map
Tham chiếu đến Map mà MapElement sử dụng nội bộ.
mapId
Loại:  string optional
Mã bản đồ của bản đồ. Xem tài liệu về Mã bản đồ để biết thêm thông tin.
Thuộc tính HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
Loại:  number optional
Mức thu phóng của bản đồ.
Thuộc tính HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Đặt phần tử có rãnh vào vị trí ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Đặt phần tử có rãnh vào vị trí ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Đặt phần tử có rãnh vào vị trí ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Đặt phần tử có rãnh vào vị trí ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Đặt phần tử có rãnh vào vị trí ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Đặt phần tử có rãnh vào vị trí ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Đặt phần tử có rãnh vào vị trí ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Đặt phần tử có rãnh vào vị trí ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Đặt phần tử có rãnh vào vị trí ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Đặt phần tử có rãnh vào vị trí ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Đặt phần tử có rãnh vào vị trí ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Đặt phần tử có rãnh vào 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, 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 khoanh vùng 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 xếp lại vị trí cho các vị trí nội bộ của MapElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Các thông 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 được 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 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 đã chỉ định được phân phối đến mục tiêu. Hãy xem addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Các thông số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. 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

Giao diện google.maps.MapElementOptions

Đối tượng MapElementOptions 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
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 đồ.
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.

Lớp ZoomChangeEvent

Lớp google.maps.ZoomChangeEvent

Sự kiện này được tạo từ việc giám sát sự 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 API JavaScript Maps.

Giao diện MapTypeStyle

Giao diện google.maps.MapTypeStyle

MapTypeStyle là một tập hợp các bộ chọn và trình định kiểu giúp xác định cách tạo kiểu cho bản đồ. Bộ chọn chỉ định các đối tượng bản đồ và/hoặc phần tử sẽ bị ảnh hưởng và trình tạo 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>
Quy tắc kiểu để áp dụng cho các đối tượng và yếu 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 cho phép, hãy xem tài liệu tham khảo về kiểu.
elementType optional
Loại:  string optional
Phần tử áp dụng 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 nền được áp dụng cho hình và các nội dung khác. 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 cho 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 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ị đượ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 cho 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ừ các sự kiện chuột khác nhau trên bản đồ và lớp phủ, đồng thời chứa tất cả các trường được 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 các thuộc tính target, currentTarget, relatedTarget và path để được xác định và nhất quán. Các nhà phát triển cũng không nên dựa vào cấu trúc DOM của triển khai nội bộ của API Maps. Do quá trình liên kết 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 độ 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 không cho 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 đồ. Mã đị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() trên sự kiện này để ngăn sự kiện được truyền tải. Tìm hiểu thêm về mã địa điểm trong hướng dẫn 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ể sử dụng mã địa điểm này để truy vấn thêm thông tin về đối tượng địa lý 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 cho nhà phát triển Places API.
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 các loại MapTypes phổ biến. Hãy chỉ định các biến 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 API JavaScript Maps.
HYBRID Loại bản đồ này hiển thị một lớp trong suốt 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ố pháp tuyến.
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ị các bản đồ có các đối tượng thực tế như địa hình và thực vật.

Lớp MapTypeRegistry

Lớp google.maps.MapTypeRegistry

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 API JavaScript Maps.
MapTypeRegistry
MapTypeRegistry()
Tham 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 hệ thống tên miền này khi cung cấp danh sách các loại bản đồ có sẵn trong các tuỳ chọn kiểm soát.
set
set(id, mapType)
Các thông số: 
  • id:  string Giá trị nhận dạng của MapType cần thêm vào sổ đăng ký.
  • mapType:  MapType|* đối tượng MapType cần thêm vào sổ đăng ký.
Giá trị trả lại hàng: Không có
Thiết lập sổ đăng ký để liên kết giá trị nhận dạng chuỗi đã chuyển với MapType đã chuyển.
Kế thừa: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Giao diện MapRestriction (Hạn chế)

Giao diện google.maps.MapRestriction

Giới hạn có thể được áp dụng cho Bản đồ. Khung nhìn của bản đồ sẽ không vượt quá những giới hạn này.
latLngBounds
Khi bạn đặt chính sách này, người dùng chỉ có thể kéo và thu phóng bên trong các giới hạn đã cho. Ranh giới có thể hạn chế cả kinh độ và vĩ độ, hoặc có thể chỉ hạn chế vĩ độ. Đối với những ranh giới chỉ có vĩ độ, hãy sử dụng kinh độ tây và kinh độ đô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ể thiết lập các 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 người dùng có thể thu nhỏ, đảm bảo rằng mọi nội dung nằm ngoài giới hạn bị hạn chế sẽ luô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ộ khu vực bị giới hạn nhìn thấy, có thể bao gồm cả các khu vực nằm ngoài khu vực bị 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 API JavaScript Maps.
TrafficLayer
TrafficLayer([opts])
Các thông số: 
Một lớp hiển thị giao thông đường bộ hiện tại.
getMap
getMap()
Tham số: Không có
Giá trị trả về:  Map
Trả về bản đồ nơi lớp này được hiển thị.
setMap
setMap(map)
Các thông số: 
Giá trị trả lại hàng: Không có
Hiển thị lớp trên bản đồ được chỉ định. Nếu bản đồ được đặt thành null, lớp sẽ bị xóa.
setOptions
setOptions(options)
Các thông số: 
Giá trị trả lại hàng: 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 TrafficLayer.
autoRefresh optional
Loại:  boolean optional
Mặc định: true
Liệu lớp lưu lượng truy cập có tự động làm mới với thông tin được cập nhật hay không.
map optional
Loại:  Map optional
Bản đồ nơi để hiển thị lớp giao thông.

Lớp TransitLayer

Lớp google.maps.TransitLayer

Lớp chuyển tuyến.

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 Maps.
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
Trả về bản đồ nơi lớp này được hiển thị.
setMap
setMap(map)
Các thông số: 
Giá trị trả lại hàng: Không có
Hiển thị lớp trên bản đồ được chỉ định. Nếu bản đồ được đặt thành null, lớp sẽ bị xóa.
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ị 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 Thư viện trong API JavaScript Maps.
BicyclingLayer
BicyclingLayer()
Tham 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 các đường lớn.
getMap
getMap()
Tham số: Không có
Giá trị trả về:  Map
Trả về bản đồ nơi lớp này được hiển thị.
setMap
setMap(map)
Các thông số: 
Giá trị trả lại hàng: Không có
Hiển thị lớp trên bản đồ được chỉ định. Nếu bản đồ được đặt thành null, lớp 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

Dùng để đặt các tuỳ 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 (Vùng hiển thị)

Giao diện google.maps.VisibleRegion

Chứa bốn điểm xác định đa giác bốn cạnh là khu vực hiển thị của bản đồ. Trên bản đồ vectơ, đa giác này có thể là một 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 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 API JavaScript Maps.
RASTER Cho biết rằng bản đồ này là bản đồ đường quét.
UNINITIALIZED Cho biết rằng chưa xác định được bản đồ là vectơ hay đường quét, vì bản đồ chưa khởi tạo xong.
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 chức năng hiện có trên 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 sẽ đượ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 những chức năng mà bạn có thể thực hiện.
isAdvancedMarkersAvailable optional
Loại:  boolean optional
Nếu đúng, bản đồ này được định cấu hình đúng để 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 đ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 định kiểu theo hướng dữ liệu cho ít nhất một FeatureLayer. Hãy tham khảo https://goo.gle/gmp-data-driven-styling và https://goo.gle/gmp-FeatureLayerIsAvailable để biết thêm thông tin.