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.
Hàm dựng | |
---|---|
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). |
Phương pháp | |
---|---|
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 URLLấ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ố:
Giá trị trả về: Không có
Đặt URL của tệp KML để hiển thị. |
setZIndex |
setZIndex(zIndex) Thông số:
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
|
Sự kiện | |
---|---|
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
.
Thuộc tính | |
---|---|
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.
Thuộc tính | |
---|---|
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.
Các hằng số | |
---|---|
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.
Thuộc tính | |
---|---|
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.
Thuộc tính | |
---|---|
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.
Thuộc tính | |
---|---|
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. |