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 Maps JavaScript.

Map
Map(mapDiv[, opts])
Tham số: 
  • mapDivHTMLElement Bản đồ sẽ kết xuất để lấp đầy phần tử này.
  • optsMapOptions 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.
DEMO_MAP_ID Mã bản đồ có thể được dùng cho các mã mẫu yêu cầu Mã bản đồ. Mã bản đồ này không dùng cho các ứng dụng chính thức và không dùng được cho các tính năng yêu cầu cấu hình đám mây (chẳng hạn như 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 nơi nó sẽ đượ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 đố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 bản sao MapType theo mã chuỗi.
overlayMapTypes
Loại:  MVCArray<MapType optional>
Các loại bản đồ bổ sung vào lớp phủ. Các loại bản đồ lớp phủ sẽ hiển thị phía trên 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ẽ hiển thị trước lớp phủ có giá trị chỉ mục thấp hơn).
fitBounds
fitBounds(bounds[, padding])
Tham số: 
  • boundsLatLngBounds|LatLngBoundsLiteral Các giới hạn sẽ hiển thị.
  • paddingnumber|Padding optional Khoảng đệm tính bằng pixel. Các ranh giới sẽ nằm vừa trong phần bản đồ còn lại sau khi xoá khoảng đệm. Một giá trị số sẽ tạo ra cùng một khoảng đệm ở cả 4 cạnh. Cung cấp 0 tại đây để làm cho fitBounds không thay đổi giá trị trên kết quả của getBounds.
Giá trị trả về: Không có
Thiết lập khung nhìn chứa các giới hạn đã cho.
Lưu ý: Khi tập hợp map đượ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, để đả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 về các giá trị mặc định bằng 0 của bản đồ. 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 để vừa với 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 Các 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 có thể nhìn thấy, giới hạn có kinh độ từ -180 đến 180 độ. Nếu bản đồ chưa được khởi chạy hoặc chưa đặt tâm và thu phóng thì kết quả sẽ là undefined. Đối với bản đồ vectơ có độ nghiêng hoặc hướng khá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 bản đồ. Xem MapCanvasProjection.getVisibleRegion để biết khu vực hiển thị chính xác của khung nhìn trên bản đồ.
getCenter
getCenter()
Tham số: Không có
Giá trị trả về:  LatLng|undefined
Trả về vị trí được hiển thị ở tâm bản đồ. Lưu ý rằng đối tượng LatLng này không được gói. Vui lòng tham khảo LatLng để biết thêm thông tin. Nếu bạn chưa đặt tâm hoặc 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)
Tham số: 
  • datasetIdstring
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ó ID 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ì lỗi 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)
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 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ẽ 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ị tiêu đề được đo bằng độ (theo chiều kim đồng hồ) từ hướng chính Bắc. Nếu bản đồ chưa được khởi chạy thì kết quả sẽ là undefined.
getMapCapabilities
getMapCapabilities()
Tham 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 tại có sẵn trên 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 chạy 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ề giới hạn StreetViewPanorama mặc định về 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(). Những thay đổi đối với streetViewControl của bản đồ sẽ được phản ánh trong phần hiển thị 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 đồ, theo độ từ mặt phẳng khung nhìn tới mặt phẳng bản đồ. Đối với bản đồ đường quét, kết quả sẽ là 0 cho hình ảnh được 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)
Tham số: 
Giá trị trả về: Không có
Đặt ngay máy ảnh của bản đồ thành các tuỳ chọn máy ảnh mục tiêu mà không cần hoạt ảnh.
panBy
panBy(x, y)
Tham số: 
  • xnumber Số pixel để di chuyển bản đồ theo hướng x.
  • ynumber Số pixel để di chuyển bản đồ theo hướng y.
Giá trị trả về: Không có
Thay đổi tâm của bản đồ theo khoảng cách đã cho tính bằng pixel. Nếu khoảng cách nhỏ hơn cả chiều rộng và chiều cao của bản đồ, quá trình chuyển đổi sẽ được 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 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 sự 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])
Tham số: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral Các ranh giới để xoay bản đồ.
  • paddingnumber|Padding optional Khoảng đệm tính bằng pixel. Một giá trị số sẽ tạo ra cùng một khoảng đệm ở cả 4 cạnh. Giá trị mặc định là "0".
Giá trị trả về: 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 vị trí mà các ranh giới sẽ xuất hiện trên bản đồ, ngoại trừ việc bản đồ sẽ được kéo để hiển thị nhiều giới hạn nhất có thể bên trong {currentMapSizeInPx} - {padding}. Đối với cả bản đồ đường quét và bản đồ vectơ, mức 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ố: 
  • valueboolean
Giá trị trả về: Không có
Kiểm soát việc các biểu tượng bản đồ có thể nhấp được 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. Để vô hiệu hoá khả năng nhấp vào biểu tượng bản đồ, hãy truyền giá trị false vào phương thức này.
setHeading
setHeading(heading)
Tham số: 
  • headingnumber
Giá trị trả về: Không có
Đặt hướng la bàn cho bản đồ được đo theo độ 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)
Tham số: 
Giá trị trả về: Không có
setOptions
setOptions(options)
Tham số: 
Giá trị trả về: Không có
setStreetView
setStreetView(panorama)
Tham số: 
  • panoramaStreetViewPanorama optional Ảnh toàn cảnh để liên kết với bản đồ.
Giá trị trả về: Không có
Liên kết StreetViewPanorama với bản đồ. Ảnh toàn cảnh này ghi đè StreetViewPanorama mặc định, cho phép bản đồ liên kết với ảnh toàn cảnh bên ngoài bên ngoài bản đồ. Đặ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)
Tham số: 
  • tiltnumber
Giá trị trả về: Không có
Đối với bản đồ vectơ, hãy thiết lập 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 thao tác chuyển đổi tự động đối với góc tới của bản đồ. Bạn chỉ được phép sử dụng các giá trị 045. setTilt(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. setTilt(45) làm cho góc nghiêng tự động chuyển thành 45 bất cứ khi nào có hình ảnh 45° cho mức thu phóng và khung nhìn hiện tại, đồng thời chuyển về 0 bất cứ khi nào không có hình ảnh 45° (đây là chế độ mặc định). Hình ảnh 45° chỉ có sẵn cho các loại bản đồ satellitehybrid, 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, không phải giá trị do setTilt đặt. Vì getTiltsetTilt đề cập đến những nội dung khác nhau, nên đừng bind() thuộc tính tilt; làm như vậy có thể dẫn đến các kết quả ngoài dự đoán.
setZoom
setZoom(zoom)
Tham số: 
  • zoomnumber Các giá trị thu phóng lớn hơn tương ứng với độ phân giải cao hơn.
Giá trị trả về: Không có
Đặt mức thu phóng của bản đồ.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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 của 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 với các thuộc tính cho vị trí đã nhấp sẽ được trả về trừ phi biểu tượng địa điểm được nhấp vào. Trong trường hợp này, IconMouseEvent có mã địa điểm sẽ được trả về. IconMouseEvent và MapMouseEvent giống nhau, ngoại trừ trường IconMouseEvent có trường mã địa điểm. Sự kiện này luôn có thể được xem là một MapMouseEvent khi mã địa điểm không quan trọng. Sự kiện nhấp chuột không được kích hoạt nếu một đ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 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 đôi khi sự kiện nhấp chuột 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 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 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 nhấp 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 của 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 được dùng để xác định các thuộc tính có thể được đặt trên Bản đồ.

backgroundColor optional
Loại:  string optional
Màu được dùng cho nền của div Bản đồ. Màu này sẽ hiển thị khi các ô chưa được tải khi người dùng kéo. Bạn chỉ có thể đặt tuỳ 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 là 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 đồ. Bạn phải cung cấp giá trị này trực tiếp khi tạo Bản đồ. Việc cập nhật giá trị này vào lúc khác có thể chuyển các chế độ kiểm soát sang trạng thái undefined. Chỉ chi phối các chế độ kiểm soát do chính API Maps tạo. Không điều chỉnh theo 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 giao diện người dùng mặc định. Có thể được 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 là false, ngăn 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ư với thuộc tính css, bạn phải chỉ định ít nhất một con trỏ dự phòng không phải là URL. Ví dụ: draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
Loại:  string optional
Tên hoặc url của con trỏ để hiển thị khi bản đồ đượ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ư với thuộc tính css, bạn phải chỉ định ít nhất một con trỏ dự phòng không phải là URL. Ví dụ: draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl optional
Loại:  boolean optional
Trạng thái bật/tắt của chế độ kiểm soát Toàn màn hình.
fullscreenControlOptions optional
Loại:  FullscreenControlOptions optional
Các tuỳ chọn hiển thị của 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 cho phép:
  • "cooperative": Các sự kiện cuộn và cử chỉ chạm bằng một ngón tay sẽ cuộn trên trang, nhưng không thu phóng hoặc xoay bản đồ. Cử chỉ chạm bằng hai ngón tay kéo 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 đồ.
    Ở chế độ này, bản đồ sẽ kết hợp với trang.
  • "greedy": Tất cả các cử chỉ chạm và sự kiện cuộn, kéo hoặc thu phóng bản đồ.
  • "none": Không thể kéo hoặc thu phóng bản đồ bằng cử chỉ của người dùng.
  • "auto": (mặc định) Thao tác xử lý cử chỉ mang tính phối hợp hoặc tự do, 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 đề của 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 chụp theo góc gần nhất hiện có mà có sẵn hình ảnh.
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 mặc định được đặt.
keyboardShortcuts optional
Loại:  boolean optional
Nếu là false, hãy ngăn bàn phím kiểm soát bản đồ. Các 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 bản đồ được tạo thực thể.
mapTypeControl optional
Loại:  boolean optional
Trạng thái bật/tắt ban đầu của chế độ kiểm soát Loại bản đồ.
mapTypeControlOptions optional
Loại:  MapTypeControlOptions optional
Các tuỳ 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. 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 của loại bản đồ hiện tại sẽ được sử dụng. Giá trị thu phóng hợp lệ là các số từ 0 đến mức thu phóng tối đa được hỗ trợ.
minZoom optional
Loại:  number optional
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, 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, đừng xoá nội dung của thẻ 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ị của 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 được đặt, người dùng chỉ có thể xoay và thu phóng trong khi chế độ xem máy ảnh 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 điều khiển Xoay.
rotateControlOptions optional
Loại:  RotateControlOptions optional
Các tuỳ chọn hiển thị của chế độ đ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 tuỳ 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 tuỳ chọn 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 chế độ 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
Một StreetViewPanorama để hiển thị khi người hình mắc áo trong Chế độ xem đường phố được thả trên bản đồ. Nếu không chỉ định ảnh toàn cảnh, StreetViewPanorama mặc định sẽ được hiển thị trong div của bản đồ khi người hình mắc áo được thả.
streetViewControl optional
Loại:  boolean optional
Trạng thái bật/tắt ban đầu của chế độ 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 của Chế độ xem đường phố sẽ không xuất hiện (ví dụ: loại bản đồ không phải trên Earth).
streetViewControlOptions optional
Loại:  StreetViewControlOptions optional
Các tùy chọn hiển thị ban đầu cho 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/hybridterrain, 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 thiết lập 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 thao tác chuyển đổi tự động đối với góc tới của bản đồ. Bạn chỉ được phép sử dụng các giá trị 045. 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 có hình ảnh 45° cho mức thu phóng và khung nhìn hiện tại, đồng thời chuyển về 0 bất cứ khi nào không có hình ảnh 45° (đây là chế độ mặc định). Hình ảnh 45° chỉ có sẵn cho các loại bản đồ satellitehybrid, trong một số vị trí và ở một số mức thu phóng. Lưu ý: getTilt trả về góc nghiêng hiện tại, chứ không phải giá trị do tuỳ chọn này chỉ định. Vì getTilt và tuỳ chọn này đề cập đến những nội dung khác nhau, nên không bind() thuộc tính tilt; làm như vậy có thể dẫn đến các kết quả 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 tuỳ chọn điều khiển Thu phóng.
zoomControlOptions optional
Loại:  ZoomControlOptions optional
Các tuỳ chọn hiển thị của chế độ đ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 đồ trong HTML. Ví dụ:

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

Trong nội bộ, 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 Maps JavaScript.

MapElement
MapElement([options])
Tham số: 
center
Loại:  LatLng|LatLngLiteral optional
Vĩ độ/kinh độ ở giữa 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 ID 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ị trí ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Đặt phần tử có rãnh ở vị trí ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Đặt phần tử có rãnh ở vị trí ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Đặt phần tử có rãnh ở vị trí ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Đặt phần tử có rãnh ở vị trí ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Đặt phần tử có rãnh ở vị trí ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Đặt phần tử có rãnh ở vị trí ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Đặt phần tử có rãnh ở vị trí ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Đặt phần tử có rãnh ở vị trí ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Đặt phần tử có rãnh ở vị trí ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Đặt phần tử có rãnh ở vị trí ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Đặt phần tử có rãnh ở vị trí ControlPosition.INLINE_START_BLOCK_START.
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • typestring 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.
  • listenerEventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc đối tượng có phương thức handleEvent
  • optionsboolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capturepassive.
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. Xem addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Xem removeEventListener
gmp-zoomchange
function(event)
Đối số: 
Sự kiện này được kích hoạt khi thuộc tính thu phóng của bản đồ thay đổi.

Giao diện MapElementOptions

Giao diện google.maps.MapElementOptions

Đối tượng MapElementOptions được dùng để xác định các thuộc tính có thể được đặ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 bản đồ được tạo thực thể.
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 bằng cách theo dõi 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 Maps JavaScript.

Giao diện MapTypeStyle

Giao diện google.maps.MapTypeStyle

MapTypeStyle là một tập hợp các bộ chọn và 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 tính năng và/hoặc thành phần của bản đồ sẽ bị ảnh hưởng, còn trình định kiểu chỉ định cách sửa đổi các tính năng và thành phần đó. Để biết thông tin chi tiết, hãy xem tài liệu tham khảo về kiểu.

stylers
Loại:  Array<Object>
Quy tắc kiểu để áp dụng cho các đối tượng và thành phần của bản đồ được 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 hướng dẫn 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.
elementType optional
Loại:  string optional
Phần tử cần áp dụng trình tạo kiểu. Phần tử là một phương diện dạng hình ảnh của một đối tượng trên bản đồ. Ví dụ: nhãn, biểu tượng, nét vẽ hoặc màu nền được áp dụng cho hình và nhiều 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 chi tiết về cách sử dụng và các giá trị được phép, hãy xem tài liệu tham khảo về kiểu.
featureType optional
Loại:  string optional
Tính năng hoặc nhóm tính năng mà bạn nên áp dụng trình tạo kiểu. Không bắt buộc. Nếu bạn không chỉ định featureType, giá trị được giả định là 'all'. Để biết chi tiết về cách sử dụng và các giá trị được phép, hãy xem tài liệu tham khảo về kiểu.

Giao diện MapMouseEvent

Giao diện google.maps.MapMouseEvent

Đối tượng này được trả về từ nhiều sự kiện chuột trên bản đồ và lớp phủ, đồng thời chứa tất cả các trường đượ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, relatedTargetpath đã được định nghĩa 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 cách triển khai nội bộ 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 độ 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 cửa sổ thông tin được truyền. Tìm hiểu thêm về mã địa điểm trong hướng dẫn 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 được nhấp vào. Mã địa điểm này có thể được dùng để 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 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 các loại MapTypes phổ biến. Hãy chỉ định các giá trị này theo giá trị hoặc bằ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 Maps JavaScript.

HYBRID Loại bản đồ này hiển thị một lớp trong suốt của các đường phố chính trên hình ảnh vệ tinh.
ROADMAP Loại bản đồ này hiển thị bản đồ 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ị bản đồ kèm theo các đặc điểm thực tế như địa hình và cây cối.

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 Maps JavaScript.

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 ý kiến đă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.
set
set(id, mapType)
Tham số: 
  • idstring Giá trị nhận dạng của MapType cần thêm vào sổ đăng ký.
  • mapTypeMapType|* Đối tượng MapType cần thêm vào sổ đăng ký.
Giá trị trả về: 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

Giao diện google.maps.MapRestriction

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

latLngBounds
Khi được đặt, người dùng chỉ có thể kéo và thu phóng bên trong giới hạn đã cho. Ranh giới có thể hạn chế cả kinh độ và vĩ độ hoặc chỉ có thể 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 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ạo các giới hạn nghiêm ngặt hơn bằng cách đặt cờ strictBounds thành true. Điều này làm giảm khoảng cách mà 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ế đều sẽ bị ẩn. Giá trị mặc định là false, nghĩa là người dùng có thể thu nhỏ cho đến khi nhìn thấy toàn bộ khu vực giới hạn, có thể bao gồm cả các khu vực nằm ngoài khu vực giới hạn.

Lớp TrafficLayer

Lớp google.maps.TrafficLayer

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

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

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

TrafficLayer
TrafficLayer([opts])
Tham 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 đồ mà trên đó lớp này được hiển thị.
setMap
setMap(map)
Tham số: 
Giá trị trả về: 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)
Tham số: 
Giá trị trả về: Không có
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Giao diện TrafficLayerOptions

Giao diện google.maps.TrafficLayerOptions

Đối tượng TrafficLayerOptions dùng để xác định các thuộc tính có thể đặ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
Lập bản đồ để 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 Maps JavaScript.

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 đồ mà trên đó lớp này được hiển thị.
setMap
setMap(map)
Tham số: 
Giá trị trả về: 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 Maps JavaScript.

BicyclingLayer
BicyclingLayer()
Tham số: Không có
Một lớp hiển thị làn đường và đường dành cho xe đạp cũng như 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 đồ mà trên đó lớp này được hiển thị.
setMap
setMap(map)
Tham số: 
Giá trị trả về: 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

Được sử 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 (Khung 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 Maps JavaScript.

RASTER Cho biết bản đồ này là bản đồ đường quét.
UNINITIALIZED Cho biết 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 đồ này 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 được tải hoặc khởi chạy, mà chính là bản đồ hiện tại có quyền sử dụng các API này. Xem các thuộc tính để biết danh sách những khả năng 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. 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 kiểu dựa trên dữ liệu cho ít nhất một FeatureLayer. Hãy xem https://goo.gle/gmp-data-driven-stylinghttps://goo.gle/gmp-FeatureLayerIsAvailable để biết thêm thông tin.