KML

Lớp KmlLayer

Lớp google.maps.KmlLayer

KmlLayer thêm mã đánh dấu địa lý vào bản đồ từ tệp KML, MRSS hoặc GeoRSS được lưu trữ trên máy chủ web có thể truy cập công khai. Hệ thống sẽ cung cấp đối tượng KmlFeatureData cho mỗi tính năng khi được nhấp vào.

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

Truy cập bằng cách gọi const {KmlLayer} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong Maps JavaScript API.
KmlLayer
KmlLayer([opts])
Thông số: 
Tạo KmlLayer hiển thị nội dung của tệp KML/KMZ được chỉ định (https://developers.google.com/sftp/documentation/sftpreference) hoặc tệp GeoRSS (http://www.georss.org).
getDefaultViewport
getDefaultViewport()
Thông số: Không có
Giá trị trả về:  LatLngBounds
Nhận khung nhìn mặc định cho lớp đang hiển thị.
getMap
getMap()
Thông số: Không có
Giá trị trả về:  Map
Nhận bản đồ mà lớp KML đang được hiển thị.
getMetadata
getMetadata()
Thông số: Không có
Giá trị trả về:  KmlLayerMetadata
Lấy siêu dữ liệu liên kết với lớp này, như được chỉ định trong mã đánh dấu lớp.
getStatus
getStatus()
Thông số: Không có
Giá trị trả về:  KmlLayerStatus
Nhận trạng thái của lớp, đặt khi tài liệu yêu cầu đã tải.
getUrl
getUrl()
Thông số: Không có
Giá trị trả về:  string URL
Lấy URL của tệp KML đang hiển thị.
getZIndex
getZIndex()
Thông số: Không có
Giá trị trả về:  number Chỉ mục z.
Xem chỉ mục z của Lớp KML.
setMap
setMap(map)
Thông số: 
Giá trị trả về: Không có
Hiển thị Lớp KML trên bản đồ được chỉ định. Nếu bạn thiết lập bản đồ thành null, lớp này sẽ bị xoá.
setOptions
setOptions(options)
Thông số: 
Giá trị trả về: Không có
setUrl
setUrl(url)
Thông số: 
  • url:  string
Giá trị trả về: Không có
Đặt URL của tệp KML để hiển thị.
setZIndex
setZIndex(zIndex)
Thông số: 
  • zIndex:  number Chỉ mục z cần đặt.
Giá trị trả về: Không có
Đặt chỉ mục z cho Lớp KML.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
Đối số: 
Sự kiện này được kích hoạt khi người dùng nhấp vào một tính năng trong lớp.
defaultviewport_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi khung nhìn mặc định của lớp KML đã thay đổi.
status_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi lớp KML đã tải xong. Tại thời điểm này, bạn có thể đọc thuộc tính trạng thái để xác định xem lớp đã tải thành công hay chưa.

Giao diện KmlLayerOptions

Giao diện google.maps.KmlLayerOptions

Đối tượng này xác định các thuộc tính có thể đặt trên đối tượng KmlLayer.
clickable optional
Loại:  boolean optional
Mặc định: true
Nếu true, lớp này sẽ nhận các sự kiện chuột.
map optional
Loại:  Map optional
Bản đồ để hiển thị lớp.
preserveViewport optional
Loại:  boolean optional
Mặc định: false
Nếu tuỳ chọn này được đặt thành true hoặc nếu trung tâm của bản đồ và mức thu phóng chưa được đặt, bản đồ đầu vào sẽ được căn giữa và thu phóng vào hộp giới hạn của nội dung của lớp.
screenOverlays optional
Loại:  boolean optional
Mặc định: true
Có hiển thị lớp phủ màn hình hay không.
suppressInfoWindows optional
Loại:  boolean optional
Ngăn hiển thị cửa sổ thông tin khi người dùng nhấp vào các tính năng của lớp.
url optional
Loại:  string optional
URL của tài liệu KML để hiển thị.
zIndex optional
Loại:  number optional
Chỉ mục z của lớp.

Giao diện KmlLayerMetadata

Giao diện google.maps.KmlLayerMetadata

Siêu dữ liệu cho một lớp KML, ở định dạng JSON.
author
Loại:  KmlAuthor
<atom:author> của lớp, được trích xuất từ mã đánh dấu lớp.
description
Loại:  string
<description> của lớp, được trích xuất từ mã đánh dấu lớp.
hasScreenOverlays
Loại:  boolean
Liệu lớp đó có lớp phủ màn hình hay không.
name
Loại:  string
<name> của lớp, được trích xuất từ mã đánh dấu lớp.
snippet
Loại:  string
<Snippet> của lớp, được trích xuất từ mã đánh dấu lớp

Hằng số KmlLayerStatus

Hằng số google.maps.KmlLayerStatus

Trạng thái do KmlLayer trả về khi hoàn tất việc tải tài liệu. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách dùng tên của hằng số. Ví dụ: 'OK' hoặc google.maps.KmlLayerStatus.OK.

Truy cập bằng cách gọi const {KmlLayerStatus} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong Maps JavaScript API.
DOCUMENT_NOT_FOUND Không tìm thấy tài liệu này. Rất có thể đó là một URL không hợp lệ hoặc tài liệu không được cung cấp công khai.
DOCUMENT_TOO_LARGE Tài liệu này vượt quá giới hạn kích thước tệp của KmlLayer.
FETCH_ERROR Không tìm nạp được tài liệu.
INVALID_DOCUMENT Tài liệu này không phải là tài liệu KML, MRSS hoặc GeoRSS hợp lệ.
INVALID_REQUEST KmlLayer không hợp lệ.
LIMITS_EXCEEDED Tài liệu này vượt quá giới hạn tính năng của KmlLayer.
OK Lớp này đã được tải thành công.
TIMED_OUT Không thể tải tài liệu trong một khoảng thời gian hợp lý.
UNKNOWN Không tải được tài liệu vì một lý do không xác định.

Giao diện KmlMouseEvent

Giao diện google.maps.KmlMouseEvent

Các thuộc tính của một sự kiện nhấp chuột trên tài liệu KML/KMZ hoặc GeoRSS.
featureData
Loại:  KmlFeatureData
Đối tượng KmlFeatureData chứa thông tin về tính năng được nhấp vào.
latLng
Loại:  LatLng
Vị trí gắn cửa sổ thông tin vào tính năng được nhấp.
pixelOffset
Loại:  Size
Độ lệch áp dụng cho cửa sổ thông tin được neo trên tính năng được nhấp.

Giao diện KmlFeatureData

Giao diện google.maps.KmlFeatureData

Dữ liệu cho một tính năng KML ở định dạng JSON, được trả về khi người dùng nhấp vào một tính năng KML. Dữ liệu có trong đối tượng này phản ánh liên kết với đối tượng trong mã đánh dấu KML hoặc GeoRSS mà đối tượng đã được khai báo.
author
Loại:  KmlAuthor
<atom:author> của tính năng, được trích xuất từ mã đánh dấu lớp (nếu được chỉ định).
description
Loại:  string
<description> của tính năng, được trích xuất từ mã đánh dấu lớp.
id
Loại:  string
<id> của tính năng, được trích xuất từ mã đánh dấu lớp. Nếu bạn chưa chỉ định <id> nào thì hệ thống sẽ tạo một mã nhận dạng duy nhất cho tính năng này.
infoWindowHtml
Loại:  string
Văn bản được tạo kiểu bong bóng của tính năng, nếu được đặt.
name
Loại:  string
<name> của tính năng, được trích xuất từ mã đánh dấu lớp.
snippet
Loại:  string
<Snippet> của tính năng, được trích xuất từ mã đánh dấu lớp.

Giao diện KmlAuthor

Giao diện google.maps.KmlAuthor

Chứa thông tin chi tiết về tác giả của tài liệu hoặc tính năng KML.
email
Loại:  string
Địa chỉ email của tác giả hoặc một chuỗi trống nếu không chỉ định.
name
Loại:  string
Tên tác giả hoặc một chuỗi trống nếu không chỉ định.
uri
Loại:  string
Trang chủ của tác giả hoặc một chuỗi trống nếu không chỉ định.