Image overlays

Giao diện MapType

Giao diện google.maps.MapType

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

Giao diện Phép chiếu

Giao diện google.maps.Projection

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
Các thông số: 
Giá trị trả về:  Point|null
Dịch 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 đồ. API Maps 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])
Các thông 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 lên một phép chiếu bản đồ thành các giá trị LatLng. API Maps gọi phương thức này khi cần chuyển các hành động trên màn hình sang các 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

Lớp google.maps.ImageMapType

Lớp này triển khai giao diện MapType và được cung cấp để hiển thị các ô hình ảnh.

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

Lớp này sẽ 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 API JavaScript Maps.
ImageMapType
ImageMapType(opts)
Các thông số: 
Tạo một ImageMapType bằng cách sử dụ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ề: độ mờ number Độ mờ hiện tại.
Trả về mức độ mờ (0 (trong suốt) đến 1.0) của ô ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
Các thông số: 
  • tileCoord:  Point Toạ độ ô.
  • zoom:  number Thu phóng thẻ thông tin.
  • ownerDocument:  Document Tài liệu sở hữu ô này.
Giá trị trả về:  Element|null Ô kết quả.
releaseTile
releaseTile(tileDiv)
Các thông số: 
  • tileDiv:  Element optional Thẻ thông tin cần phát hành.
Giá trị trả lại hàng: Không có
setOpacity
setOpacity(opacity)
Các thông số: 
  • opacity:  number Độ mờ mới.
Giá trị trả lại hàng: Không có
Đặt độ mờ (0 (trong suốt) thành 1.0) của ô 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 thẻ thông tin 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 sẽ kết xuất các ô hình ảnh.
alt optional
Loại:  string optional
Văn bản thay thế sẽ hiển thị khi di chuột qua nút của 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 hiển thị trong MapTypeControl.
opacity optional
Loại:  number optional
Độ mờ để áp dụng cho thẻ thông tin. Độ mờ phải được chỉ định dưới dạng một 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ờ đục.
tileSize optional
Loại:  Size optional
Kích thước ô.

Lớp GroundOverlay

Lớp google.maps.GroundOverlay

Một lớp ảnh 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 API JavaScript Maps.
GroundOverlay
GroundOverlay(url, bounds[, opts])
Các thông số: 
Tạo lớp phủ mặt đất từ URL hình ảnh được cung cấp và LatLngBounds của URL đó. Hình ảnh được chia tỷ lệ cho vừa với giới hạn 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 đồ nơi 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)
Các thông số: 
Giá trị trả lại hàng: Không có
Hiển thị lớp phủ mặt đất trên bản đồ được chỉ định. Nếu bạn đặt bản đồ thành null, thì lớp phủ sẽ bị xoá.
setOpacity
setOpacity(opacity)
Các thông số: 
  • opacity:  number
Giá trị trả lại hàng: 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 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 optional
Loại:  boolean optional
Nếu giá trị là true, lớp phủ mặt đất có thể nhận được các sự kiện nhấp chuột.
map optional
Loại:  Map optional
Bản đồ mà lớp phủ hiển thị trên đó.
opacity optional
Loại:  number optional
Mặc định: 1.0
Độ mờ của lớp phủ, được biểu thị bằng số từ 0 đến 1. Không bắt buộc.

Lớp StyledMapType

Lớp google.maps.StyledMapType

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

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

Lớp này sẽ 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 API JavaScript Maps.
StyledMapType
StyledMapType(styles[, options])
Các thông số: 
Tạo một MapType đã được tạo kiểu với các tuỳ chọn được chỉ định. StyledMapType lấy một mảng MapTypeStyle, trong đó mỗi MapTypeStyle được áp dụng liên tiếp trên bản đồ. MapTypeStyle sau này áp dụng cùng các MapTypeStyler cho cùng bộ chọn như MapTypeStyle trước đó sẽ ghi đè MapTypeStyle trước đó.
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)
Các thông số: 
  • tileCoord:  Point Toạ độ ô.
  • zoom:  number Thu phóng thẻ thông tin.
  • ownerDocument:  Document Tài liệu sở hữu ô này.
Giá trị trả về:  Element|null Ô kết quả.
releaseTile
releaseTile(tile)
Các thông số: 
  • tile:  Element optional Thẻ thông tin cần phát hành.
Giá trị trả lại hàng: Không có
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Giao diện StyledMapTypeOptions

Giao diện google.maps.StyledMapTypeOptions

Lớp này 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 StyledMapType.
alt optional
Loại:  string optional
Văn bản sẽ hiển thị khi di chuột qua nút của MapType này trong phần đ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 hiển thị trong chế độ điều khiển loại bản đồ.