KML

Lớp KmlLayer

Lớp google.maps.KmlLayer

KmlLayer thêm mã đánh dấu địa lý vào bản đồ từ một tệp KML, KMZ hoặc GeoRSS được lưu trữ trên một máy chủ web có thể truy cập công khai. Đối tượng KmlFeatureData được cung cấp cho từng đối tượ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 Thư viện trong Maps JavaScript API.
KmlLayer
KmlLayer([opts])
Tham số: 
Tạo một KmlLayer để hiển thị nội dung của tệp KML/KMZ được chỉ định (https://developers.google.com/kml/documentation/kmlreference) hoặc tệp GeoRSS (http://www.georss.org).
getDefaultViewport
getDefaultViewport()
Tham số:  Không có
Giá trị trả về:  LatLngBounds
Lấy khung hiển thị mặc định cho lớp đang được hiển thị.
getMap
getMap()
Tham số:  Không có
Giá trị trả về:  Map
Lấy bản đồ mà Lớp KML đang được kết xuất.
getMetadata
getMetadata()
Tham số:  Không có
Giá trị trả về:  KmlLayerMetadata
Lấy siêu dữ liệu được liên kết với lớp này, như được chỉ định trong mã đánh dấu lớp.
getStatus
getStatus()
Tham số:  Không có
Giá trị trả về:  KmlLayerStatus
Lấy trạng thái của lớp, được đặt sau khi tài liệu được yêu cầu đã tải.
getUrl
getUrl()
Tham số:  Không có
Giá trị trả về:  string URL
Lấy URL của tệp KML đang được hiển thị.
getZIndex
getZIndex()
Tham số:  Không có
Giá trị trả về:  number Chỉ mục z.
Lấy chỉ mục z của Lớp KML.
setMap
setMap(map)
Tham số: 
Giá trị trả về:  Không có
Kết xuất Lớp KML trên bản đồ đã chỉ định. Nếu bản đồ được đặt thành null, thì lớp sẽ bị xoá.
setOptions
setOptions(options)
Tham số: 
Giá trị trả về:  Không có
setUrl
setUrl(url)
Tham số: 
  • url:  string
Giá trị trả về:  Không có
Đặt URL của tệp KML cần hiển thị.
setZIndex
setZIndex(zIndex)
Tham số: 
  • zIndex:  number Chỉ mục z cần đặt.
Giá trị trả về:  Không có
Đặt chỉ mục z của 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 một đối tượng trong lớp được nhấp vào.
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 các 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 có tải thành công hay không.

Giao diện KmlLayerOptions

google.maps.KmlLayerOptionsgiao 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 KmlLayer.
clickable optional
Loại:  boolean optional
Mặc định: true
Nếu true, lớp sẽ nhận được 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.
preserveViewport optional
Loại:  boolean optional
Mặc định: false
Nếu bạn đặt lựa chọn này thành true hoặc nếu bạn chưa bao giờ đặt tâm và mức thu phóng của bản đồ, thì bản đồ đầu vào sẽ được đặt ở giữa và thu phóng đến hộp giới hạn của nội dung trong lớp.
screenOverlays optional
Loại:  boolean optional
Mặc định: true
Có nên kết xuất lớp phủ màn hình hay không.
suppressInfoWindows optional
Loại:  boolean optional
Ngăn chặn việc hiển thị cửa sổ thông tin khi người dùng nhấp vào các đối tượng trên lớp.
url optional
Loại:  string optional
URL của tài liệu KML cần hiển thị.
zIndex optional
Loại:  number optional
Chỉ mục z của lớp.

Giao diện KmlLayerMetadata

google.maps.KmlLayerMetadatagiao diện

Siêu dữ liệu cho một lớp KML duy nhất, ở định dạng JSON.
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
Lớp này 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
author optional
Loại:  KmlAuthor optional
<atom:author> 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 quá trình tải một tài liệu hoàn tất. Chỉ định các giá trị này theo giá trị hoặc bằng cách sử 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 Thư viện trong Maps JavaScript API.
DOCUMENT_NOT_FOUND Không tìm thấy tài liệu. Rất có thể đây 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 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, KMZ 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 đối tượng của KmlLayer.
OK Đã tải thành công lớp.
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

google.maps.KmlMouseEventgiao diện

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
Một đối tượng KmlFeatureData chứa thông tin về đối tượng được nhấp vào.
latLng
Loại:  LatLng
Vị trí để cố định một cửa sổ thông tin trên đối tượng được nhấp.
pixelOffset
Loại:  Size
Độ lệch cần áp dụng cho cửa sổ thông tin được cố định trên đối tượng đã nhấp.

Giao diện KmlFeatureData

google.maps.KmlFeatureDatagiao diện

Dữ liệu cho một đối tượng KML ở định dạng JSON, được trả về khi một đối tượng KML được nhấp vào. Dữ liệu có trong đối tượng này phản ánh dữ liệu được liên kết với đối tượng trong KML hoặc GeoRSS mà đối tượng đó được khai báo.
author
Loại:  KmlAuthor
<atom:author> của đối tượ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>, thì một mã nhận dạng duy nhất sẽ được tạo cho đối tượng này.
infoWindowHtml
Loại:  string
Văn bản có kiểu của 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

google.maps.KmlAuthorgiao diện

Chứa thông tin chi tiết về tác giả của một tài liệu hoặc đối tượ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 được chỉ định.
name
Loại:  string
Tên tác giả hoặc một chuỗi trống nếu không được 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 được chỉ định.