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 được dùng cho các loại bản đồ tuỳ chỉnh. Không thể thay đổi.

maxZoom
Loại:  number
Cấp độ 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
Cấp độ 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.
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 bạn 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
Hình chiếu 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)
Thông số: 
  • tileCoordPoint Toạ độ ô.
  • zoomnumber Thu phóng Thẻ thông tin.
  • ownerDocumentDocument Tài liệu sở hữu thẻ thông tin này.
Giá trị trả về: Thẻ thông tin kết quả Element|null.
Trả về một ô cho toạ độ ô (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)
Thông số: 
  • tile:  Thẻ thông tin Element optional cần phát hành.
Giá trị trả về:  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. Thẻ thông tin đã cung cấp sẽ bị xoá khỏi tài liệu. Không bắt buộc.

Giao diện Projection (Chiếu)

Giao diện google.maps.Projection

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
Thông số: 
Giá trị trả về:  Point|null
Dịch từ hình 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 đồ. API Maps gọi phương thức này khi cần lập biểu đồ 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])
Thông số: 
  • pixelPoint
  • noClampNoWrapboolean 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. API Maps 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 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 để kết xuất thẻ thông tin 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 phần Thư viện trong API Maps JavaScript.

ImageMapType
ImageMapType(opts)
Thông 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()
Thông 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 thẻ thông tin ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
Thông số: 
  • tileCoordPoint Toạ độ ô.
  • zoomnumber Thu phóng Thẻ thông tin.
  • ownerDocumentDocument Tài liệu sở hữu thẻ thông tin này.
Giá trị trả về: Thẻ thông tin kết quả Element|null.
releaseTile
releaseTile(tileDiv)
Thông số: 
  • tileDiv:  Thẻ thông tin Element optional cần phát hành.
Giá trị trả về:  Không có
setOpacity
setOpacity(opacity)
Thông số: 
  • opacitynumber Độ mờ mới.
Giá trị trả về:  Không có
Đặt mức độ mờ (0 (trong suốt) thành 1.0) của thẻ thông tin 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 dùng để tạo MapType hiển thị các ô hình ảnh.

alt optional
Loại:  string optional
Văn bản thay thế sẽ hiển thị khi bạn 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
Cấp độ thu phóng tối đa cho bản đồ khi hiển thị MapType này.
minZoom optional
Loại:  number optional
Cấp độ 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 các thẻ thông tin. Bạn phải chỉ định độ mờ dưới dạng giá trị float 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

Lớp phủ hình ả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 phần Thư viện trong API Maps JavaScript.

GroundOverlay
GroundOverlay(url, bounds[, opts])
Thông số: 
Tạo lớp phủ mặt đất từ URL hình ảnh đã cung cấp và LatLngBounds của URL đó. Hình ảnh được điều chỉnh theo tỷ lệ để vừa với các 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()
Thông số:  Không có
Giá trị trả về:  LatLngBounds
Lấy LatLngBounds của lớp phủ này.
getMap
getMap()
Thông số:  Không có
Giá trị trả về:  Map
Trả về bản đồ hiển thị lớp phủ mặt đất này.
getOpacity
getOpacity()
Thông số:  Không có
Giá trị trả về:  number
Trả về độ mờ của lớp phủ mặt đất này.
getUrl
getUrl()
Thông số:  Không có
Giá trị trả về:  string
Lấy URL của hình ảnh được chiếu.
setMap
setMap(map)
Thông số: 
Giá trị trả về:  Không có
Kết xuất lớp phủ mặt đất trên bản đồ được chỉ định. Nếu bạn đặt map thành null, lớp phủ sẽ bị xoá.
setOpacity
setOpacity(opacity)
Thông số: 
  • opacitynumber
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 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 nhấp đúp 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ể được đặt trên đối tượng GroundOverlay.

clickable optional
Loại:  boolean optional
Nếu là true, lớp phủ mặt đất có thể nhận được các sự kiện chuột.
map optional
Loại:  Map optional
Bả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ị dưới dạng một số nằm trong khoảng 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 triển khai MapType.

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

StyledMapType
StyledMapType(styles[, options])
Thông số: 
Tạo một MapType được tạo kiểu bằng các tuỳ chọn đã chỉ định. StyledMapType lấy một mảng MapTypeStyle, trong đó mỗi MapTypeStyle được áp dụng cho bản đồ liên tiếp. MapTypeStyle sau áp dụng cùng một MapTypeStyler cho cùng một 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 của 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)
Thông số: 
  • tileCoordPoint Toạ độ ô.
  • zoomnumber Thu phóng Thẻ thông tin.
  • ownerDocumentDocument Tài liệu sở hữu thẻ thông tin này.
Giá trị trả về: Thẻ thông tin kết quả Element|null.
releaseTile
releaseTile(tile)
Thông số: 
  • tile:  Thẻ thông tin Element optional 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

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 bản sao StyledMapType.

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