Image overlays

Giao diện MapType

giao diện google.maps.MapType
được triển khai bởi ImageMapType, StyledMapType

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ơ sở, 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; mặc định là 0.
radius
Loại: number
Bán kính của hành tinh cho 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à 6378137 mét.
alt
không bắt buộc
Loại: string optional
Văn bản thay thế sẽ hiển thị khi nút của MapType này được di chuột qua trong MapTypeControl. Không bắt buộc.
name
không bắt buộc
Loại: string optional
Tên hiển thị trong MapTypeControl. Không bắt buộc.
projection
không bắt buộc
Loại: Projection optional
Phép chiếu dùng để kết xuất MapType này. Không bắt buộc; mặc định là Mercator.
tileSize
không bắt buộc
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 Tọa độ ô vuông.
  • 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 tọa độ ô vuông (x, y) và mức thu phóng đã cho. Thẻ thông tin 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ả để phát hành.
Giá trị trả về: void
Giải phóng ô đã cho, thực hiện mọi thao tác dọn dẹp cần thiết. Thẻ được cung cấp đã bị xoá khỏi tài liệu. Không bắt buộc.

Giao diện Projection

giao diện google.maps.Projection

Giao diện chiếu.

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
Tham số:
Giá trị trả về: Point|null
Chuyển đổi từ hình trụ LatLng sang mặt phẳng Điểm. 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ẽ các 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 thể tính toán 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 phép chiếu bản đồ sang giá trị LatLng. API Maps gọi phương thức này khi cần chuyển 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 thể tính toán LatLng.

Lớp ImageMapType

class google.maps.ImageMapType extends MVCObject implements MapType
library "maps"

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.

const {ImageMapType} = await google.maps.importLibrary("maps");
ImageMapType
ImageMapType(opts)
Tham số:
Tạo 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 optional
radius
Loại: number
tileSize
Loại: Size optional
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 optional Tọa độ ô vuông.
  • zoom: number Thu phóng ô.
  • ownerDocument: Document optional 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ả để 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) thành 1.0) của các ô ImageMapType.
Được 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

giao diện google.maps.ImageMapTypeOptions

Lớp này được dùng để tạo một MapType kết xuất các ô hình ảnh.

alt
không bắt buộc
Loại: string optional
Văn bản thay thế sẽ hiển thị khi nút của MapType này được di chuột qua trong MapTypeControl.
getTileUrl
không bắt buộc
Loại: function(Point, number): (string optional) optional
Trả về một chuỗi (URL) cho tọa độ ô vuông (x, y) và mức thu phóng đã cho.
maxZoom
không bắt buộc
Loại: number optional
Mức thu phóng tối đa cho bản đồ khi hiển thị MapType này.
minZoom
không bắt buộc
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
không bắt buộc
Loại: string optional
Tên hiển thị trong MapTypeControl.
opacity
không bắt buộc
Loại: number optional
Độ mờ áp dụng cho các ô. Độ mờ phải được chỉ định dưới dạng giá trị 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
không bắt buộc
Loại: Size optional
Kích thước ô.

Lớp GroundOverlay

class google.maps.GroundOverlay extends MVCObject
library "maps"

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

const {GroundOverlay} = await google.maps.importLibrary("maps");
GroundOverlay
GroundOverlay(url, bounds[, opts])
Tham số:
Tạo lớp phủ mặt đất từ URL hình ảnh được cung cấp và LatLngBounds của lớp phủ đó. Hình ảnh được điều chỉnh theo tỷ lệ để vừa 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|null
Lấy LatLngBounds của lớp phủ này.
getMap
getMap()
Tham số: Không có
Giá trị trả về: Map|null
Trả về bản đồ mà lớp phủ mặt đất này hiển thị.
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ố:
  • map: Map optional
Giá trị trả về: void
Hiển thị lớp phủ mặt đất trên bản đồ được chỉ định. Nếu bản đồ được đặt thành null, thì lớp phủ sẽ bị xoá.
setOpacity
setOpacity(opacity)
Tham số:
  • opacity: number
Giá trị trả về: void
Đặt độ mờ của lớp phủ mặt đất này.
Được 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 chuột 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

giao diện google.maps.GroundOverlayOptions

Đối tượng này xác định các thuộc tính có thể đặt trên đối tượng GroundOverlay.

clickable
không bắt buộc
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
không bắt buộc
Loại: Map optional
Bản đồ để hiển thị lớp phủ.
opacity
không bắt buộc
Loại: number optional
Mặc định: 1.0
Độ mờ của lớp phủ, được biểu thị dưới dạng một số từ 0 đến 1. Không bắt buộc.

Lớp StyledMapType

class google.maps.StyledMapType extends MVCObject implements MapType
library "maps"

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

const {StyledMapType} = await google.maps.importLibrary("maps");
StyledMapType
StyledMapType(styles[, options])
Tham số:
Tạo một MapType được tạo kiểu bằng các tuỳ chọn đã chỉ định. StyledMapType nhận một mảng MapTypeStyle, trong đó mỗi MapTypeStyle được áp dụng liên tiếp cho bản đồ. MapTypeStyle sau áp dụng cùng MapTypeStyler cho cùng bộ chọn như 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 lúc, bạn sẽ nhận được cảnh báo trong 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 optional
radius
Loại: number
tileSize
Loại: Size optional
getTile
getTile(tileCoord, zoom, ownerDocument)
Tham số:
  • tileCoord: Point optional Tọa độ ô vuông.
  • zoom: number Thu phóng ô.
  • ownerDocument: Document optional 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ả để phát hành.
Giá trị trả về: void
Được kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

StyledMapTypeOptions giao diện

giao diện google.maps.StyledMapTypeOptions

Lớp này được dùng để chỉ định các tuỳ chọn khi tạo StyledMapType. Bạn không thể thay đổi các tuỳ chọn này sau khi tạo thực thể StyledMapType.

alt
không bắt buộc
Loại: string optional
Văn bản hiển thị khi nút của MapType này được di chuột qua trong chế độ điều khiển loại bản đồ.
maxZoom
không bắt buộc
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
không bắt buộc
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
không bắt buộc
Loại: string optional
Tên hiển thị trong thành phần điều khiển loại bản đồ.