Image overlays

Giao diện MapType

google.maps.MapTypegiao diện

Giao diện này xác định loại bản đồ và thường được dùng cho các loại bản đồ tuỳ chỉnh. Không thể thay đổi.
maxZoom
Loại:  number
Mức thu phóng tối đa cho bản đồ khi hiển thị MapType này. Bắt buộc đối với MapTypes cơ bản, bị bỏ qua đối với MapTypes lớp phủ.
minZoom
Loại:  number
Mức thu phóng tối thiểu cho bản đồ khi hiển thị MapType này. Không bắt buộc; giá trị mặc định là 0.
radius
Loại:  number
Bán kính của hành tinh trên bản đồ, tính bằng mét. Không bắt buộc; mặc định là bán kính xích đạo của Trái đất là 6.378.137 mét.
alt optional
Loại:  string optional
Văn bản thay thế sẽ xuất hiện khi người dùng di chuột lên nút MapType này trong MapTypeControl. Không bắt buộc.
name optional
Loại:  string optional
Tên sẽ hiển thị trong MapTypeControl. Không bắt buộc.
projection optional
Loại:  Projection optional
Phép chiếu dùng để hiển thị MapType này. Không bắt buộc; mặc định là Mercator.
tileSize optional
Loại:  Size optional
Kích thước của mỗi ô. Bắt buộc.
getTile
getTile(tileCoord, zoom, ownerDocument)
Tham số: 
  • tileCoord:  Point Toạ độ ô.
  • zoom:  number Thu phóng ô.
  • ownerDocument:  Document Tài liệu sở hữu ô này.
Giá trị trả về:  Element|null Ô kết quả.
Trả về một ô cho toạ độ ô (x, y) và mức thu phóng đã cho. Ô này sẽ được thêm vào ownerDocument đã cho. Không dùng được cho các loại bản đồ cơ sở.
releaseTile
releaseTile(tile)
Tham số: 
  • tile:  Element optional Thẻ thông tin cần phát hành.
Giá trị trả về:  Không có
Phát hành ô đã cho, thực hiện mọi thao tác dọn dẹp cần thiết. Ô được cung cấp sẽ bị xoá khỏi tài liệu. Không bắt buộc.

Giao diện Chiếu

google.maps.Projectiongiao diện

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
Tham số: 
Giá trị trả về:  Point|null
Dịch từ trụ LatLng sang mặt phẳng Point. Giao diện này chỉ định một hàm triển khai việc dịch từ các giá trị LatLng đã cho sang toạ độ thế giới trên phép chiếu bản đồ. Maps API gọi phương thức này khi cần vẽ vị trí trên màn hình. Các đối tượng Projection phải triển khai phương thức này, nhưng có thể trả về null nếu phép chiếu không tính được Point.
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
Tham số: 
  • pixel:  Point
  • noClampNoWrap:  boolean optional
Giá trị trả về:  LatLng|null
Giao diện này chỉ định một hàm triển khai việc dịch từ toạ độ thế giới trên một phép chiếu bản đồ sang các giá trị LatLng. Maps API gọi phương thức này khi cần dịch các thao tác trên màn hình thành vị trí trên bản đồ. Các đối tượng Projection phải triển khai phương thức này, nhưng có thể trả về null nếu phép chiếu không tính được LatLng.

Lớp ImageMapType

Lớp google.maps.ImageMapType

Lớp này triển khai giao diện MapType và được cung cấp để kết xuất các ô hình ảnh.

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

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

Truy cập bằng cách gọi const {ImageMapType} = await google.maps.importLibrary("maps").
Xem Thư viện trong Maps JavaScript API.
ImageMapType
ImageMapType(opts)
Tham số: 
Tạo một ImageMapType bằng ImageMapTypeOptions được cung cấp
alt
Loại:  string optional
maxZoom
Loại:  number
minZoom
Loại:  number
name
Loại:  string optional
projection
Loại:  Projection
radius
Loại:  number
tileSize
Loại:  Size
getOpacity
getOpacity()
Tham số:  Không có
Giá trị trả về:  number độ mờ Độ mờ hiện tại.
Trả về mức độ mờ (0 (trong suốt) đến 1.0) của các ô ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
Tham số: 
  • tileCoord:  Point Toạ độ ô.
  • zoom:  number Thu phóng ô.
  • ownerDocument:  Document Tài liệu sở hữu ô này.
Giá trị trả về:  Element|null Ô kết quả.
releaseTile
releaseTile(tileDiv)
Tham số: 
  • tileDiv:  Element optional Thẻ thông tin cần phát hành.
Giá trị trả về:  Không có
setOpacity
setOpacity(opacity)
Tham số: 
  • opacity:  number Độ mờ mới.
Giá trị trả về:  Không có
Đặt mức độ mờ (0 (trong suốt) đến 1.0) của các ô ImageMapType.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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.

Giao diện ImageMapTypeOptions

google.maps.ImageMapTypeOptionsgiao diện

Lớp này được dùng để tạo một MapType hiển thị các ô hình ảnh.
alt optional
Loại:  string optional
Văn bản thay thế sẽ xuất hiện khi người dùng di chuột lên nút MapType này trong MapTypeControl.
getTileUrl optional
Loại:  function(Point, number): (string optional) optional
Trả về một chuỗi (URL) cho toạ độ ô (x, y) và mức thu phóng đã cho.
maxZoom optional
Loại:  number optional
Mức thu phóng tối đa cho bản đồ khi hiển thị MapType này.
minZoom optional
Loại:  number optional
Mức thu phóng tối thiểu cho bản đồ khi hiển thị MapType này. Không bắt buộc.
name optional
Loại:  string optional
Tên sẽ hiển thị trong MapTypeControl.
opacity optional
Loại:  number optional
Độ mờ cần áp dụng cho các ô. Độ mờ phải được chỉ định dưới dạng giá trị số thực từ 0 đến 1.0, trong đó 0 là hoàn toàn trong suốt và 1 là hoàn toàn mờ.
tileSize optional
Loại:  Size optional
Kích thước ô.

Lớp GroundOverlay

Lớp google.maps.GroundOverlay

Một lớp phủ hình chữ nhật trên bản đồ.

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

Truy cập bằng cách gọi const {GroundOverlay} = await google.maps.importLibrary("maps").
Xem Thư viện trong Maps JavaScript API.
GroundOverlay
GroundOverlay(url, bounds[, opts])
Tham số: 
Tạo một lớp phủ mặt đất từ URL hình ảnh đã cung cấp và LatLngBounds của hình ảnh đó. Hình ảnh được thu nhỏ để phù hợp với ranh giới hiện tại và được chiếu bằng phép chiếu bản đồ hiện tại.
getBounds
getBounds()
Tham số:  Không có
Giá trị trả về:  LatLngBounds
Lấy LatLngBounds của lớp phủ này.
getMap
getMap()
Tham số:  Không có
Giá trị trả về:  Map
Trả về bản đồ mà lớp phủ mặt đất này xuất hiện.
getOpacity
getOpacity()
Tham số:  Không có
Giá trị trả về:  number
Trả về độ mờ của lớp phủ mặt đất này.
getUrl
getUrl()
Tham số:  Không có
Giá trị trả về:  string
Lấy URL của hình ảnh được chiếu.
setMap
setMap(map)
Tham số: 
Giá trị trả về:  Không có
Kết xuất lớp phủ mặt đất trên bản đồ đã chỉ định. Nếu bạn đặt bản đồ thành null, lớp phủ sẽ bị xoá.
setOpacity
setOpacity(opacity)
Tham số: 
  • opacity:  number
Giá trị trả về:  Không có
Đặt độ mờ của lớp phủ mặt đất này.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(event)
Đối số: 
Sự kiện này được kích hoạt khi sự kiện nhấp vào DOM được kích hoạt trên GroundOverlay.
dblclick
function(event)
Đối số: 
Sự kiện này được kích hoạt khi sự kiện dblclick DOM được kích hoạt trên GroundOverlay.

Giao diện GroundOverlayOptions

google.maps.GroundOverlayOptionsgiao diện

Đối tượng này xác định các thuộc tính có thể được đặt trên một đối tượng GroundOverlay.
clickable optional
Loại:  boolean optional
Nếu true, lớp phủ mặt đất có thể nhận các sự kiện chuột.
map optional
Loại:  Map optional
Bản đồ mà bạn muốn hiển thị lớp phủ.
opacity optional
Loại:  number optional
Mặc định: 1.0
Độ mờ của lớp phủ, được biểu thị bằng một số trong khoảng từ 0 đến 1. Không bắt buộc.

Lớp StyledMapType

Lớp google.maps.StyledMapType

Tạo một MapType có kiểu tuỳ chỉnh.

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

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

Truy cập bằng cách gọi const {StyledMapType} = await google.maps.importLibrary("maps").
Xem Thư viện trong Maps JavaScript API.
StyledMapType
StyledMapType(styles[, options])
Tham số: 
Tạo một MapType có kiểu với các lựa chọn đã chỉ định. StyledMapType lấy một mảng MapTypeStyle, trong đó mỗi MapTypeStyle được áp dụng cho bản đồ một cách liên tục. Một MapTypeStyle sau này áp dụng cùng một MapTypeStyler cho cùng một bộ chọn như một MapTypeStyle trước đó sẽ ghi đè MapTypeStyle trước đó.

Xin lưu ý rằng StyledMapType không được hỗ trợ khi bạn đặt mã bản đồ. Khi sử dụng cả hai cùng nhau, bạn sẽ nhận được cảnh báo trên bảng điều khiển.
alt
Loại:  string
maxZoom
Loại:  number
minZoom
Loại:  number
name
Loại:  string
projection
Loại:  Projection
radius
Loại:  number
tileSize
Loại:  Size
getTile
getTile(tileCoord, zoom, ownerDocument)
Tham số: 
  • tileCoord:  Point Toạ độ ô.
  • zoom:  number Thu phóng ô.
  • ownerDocument:  Document Tài liệu sở hữu ô này.
Giá trị trả về:  Element|null Ô kết quả.
releaseTile
releaseTile(tile)
Tham số: 
  • tile:  Element optional Thẻ thông tin cần phát hành.
Giá trị trả về:  Không có
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Giao diện StyledMapTypeOptions

google.maps.StyledMapTypeOptionsgiao diện

Lớp này dùng để chỉ định các lựa chọn khi tạo StyledMapType. Bạn không thể thay đổi các lựa chọn này sau khi StyledMapType được khởi tạo.
alt optional
Loại:  string optional
Văn bản sẽ hiển thị khi nút MapType này được di chuột qua trong chế độ điều khiển loại bản đồ.
maxZoom optional
Loại:  number optional
Mức thu phóng tối đa cho bản đồ khi hiển thị MapType này. Không bắt buộc.
minZoom optional
Loại:  number optional
Mức thu phóng tối thiểu cho bản đồ khi hiển thị MapType này. Không bắt buộc.
name optional
Loại:  string optional
Tên sẽ xuất hiện trong chế độ điều khiển loại bản đồ.