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, 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 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 API Maps JavaScript.
KmlLayer
KmlLayer([opts])
Thông số: 
Tạo một KmlLayer hiển thị nội dung của tệp KML/KMZ đã chỉ định (https://developers.google.com/kml/documentation/kmlreference) hoặc tệp GeoRSS (http://www.georss.org).
getDefaultViewport
getDefaultViewport()
Thông số:  Không có
Giá trị trả về:  LatLngBounds
Lấy 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
Lấy bản đồ mà Lớp KML đang được kết xuất.
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, được đặt sau khi tài liệu được yêu cầu tải xong.
getUrl
getUrl()
Thông số:  Không có
Giá trị trả về:  URL string
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.
Lấy chỉ mục z của Lớp KML.
setMap
setMap(map)
Thông 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 đặt map 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 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 người dùng nhấp vào một đối tượ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ể được đặt trên đối tượng KmlLayer.
clickable optional
Loại:  boolean optional
Mặc định: true
Nếu là true, lớp sẽ nhận được 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 bạn đặt tuỳ chọn này thành true hoặc nếu bạn chưa bao giờ đặt tâm và tỷ lệ thu phóng của bản đồ, thì bản đồ đầu vào sẽ được căn giữa và thu phóng đến 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
Liệu có kết xuất 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 nhấp vào các đối tượng 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

Giao diện google.maps.KmlLayerMetadata

Siêu dữ liệu cho một lớp KML, ở đị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 có lớp phủ màn hình nào 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 hoàn tất việc tải tài liệu. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. 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 API Maps JavaScript.
DOCUMENT_NOT_FOUND Không tìm thấy tài liệu. Rất có thể đó là 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 thể tìm nạp tài liệu.
INVALID_DOCUMENT Tài liệu 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 vượt quá giới hạn về đối tượng của KmlLayer.
OK Đã tải lớp 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ì 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 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í neo cửa sổ thông tin trên đối tượng được nhấp.
pixelOffset
Loại:  Size
Độ dời để áp dụng cho một cửa sổ thông tin được neo trên đối tượng đã nhấp.

Giao diện KmlFeatureData

Giao diện google.maps.KmlFeatureData

Dữ liệu cho một đối tượng KML ở định dạng JSON, được trả về khi người dùng nhấp vào một đối tượng KML. Dữ liệu chứa trong đối tượng này phản ánh dữ liệu được liên kết với đối tượng trong phần đánh dấu 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>, 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 đố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.