KmlLayer class
google.maps.KmlLayer
zajęcia
KmlLayer dodaje do mapy znaczniki geograficzne z pliku KML, KMZ lub GeoRSS, który jest hostowany na publicznie dostępnym serwerze WWW. Po kliknięciu każdej funkcji wyświetlany jest obiekt KmlFeatureData.
Ta klasa rozszerza klasę MVCObject.
Dostęp przez połączenie pod numer const {KmlLayer} = await google.maps.importLibrary("maps").
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
|---|---|
KmlLayer |
KmlLayer([opts])Parametry:
Tworzy element KmlLayer, który renderuje zawartość określonego pliku KML/KMZ (https://developers.google.com/kml/documentation/kmlreference) lub pliku GeoRSS (http://www.georss.org). |
Metody | |
|---|---|
getDefaultViewport |
getDefaultViewport()Parametry: brak
Zwracana wartość:
LatLngBoundsPobierz domyślny widok dla wyświetlanej warstwy. |
getMap |
getMap()Parametry: brak
Zwracana wartość:
MapPobierz mapę, na której renderowana jest warstwa KML. |
getMetadata |
getMetadata()Parametry: brak
Zwracana wartość:
KmlLayerMetadataPobierz metadane powiązane z tą warstwą, zgodnie z oznaczeniami warstwy. |
getStatus |
getStatus()Parametry: brak
Zwracana wartość:
KmlLayerStatusPobierz stan warstwy, który jest ustawiany po wczytaniu żądanego dokumentu. |
getUrl |
getUrl()Parametry: brak
Zwracana wartość:
string URLPobiera adres URL wyświetlanego pliku KML. |
getZIndex |
getZIndex()Parametry: brak
Zwracana wartość:
number kolejność nakładania elementów.Pobiera kolejność nakładania warstwy KML. |
setMap |
setMap(map)Parametry:
Zwracana wartość: brak
Renderuje warstwę KML na określonej mapie. Jeśli mapa jest ustawiona na null, warstwa zostanie usunięta. |
setOptions |
setOptions(options)Parametry:
Zwracana wartość: brak
|
setUrl |
setUrl(url)Parametry:
Zwracana wartość: brak
Ustawia adres URL pliku KML do wyświetlenia. |
setZIndex |
setZIndex(zIndex)Parametry:
Zwracana wartość: brak
Ustawia kolejność nakładania warstwy KML. |
Odziedziczone:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Wydarzenia | |
|---|---|
click |
function(kmlClickEvent)Argumenty:
To zdarzenie jest wywoływane po kliknięciu elementu w warstwie. |
defaultviewport_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmieni się domyślny widoczny obszar warstw KML. |
status_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane po zakończeniu wczytywania warstwy KML. W tym momencie możesz odczytać właściwość stanu, aby sprawdzić, czy warstwa została wczytana. |
KmlLayerOptions interfejs
google.maps.KmlLayerOptionsinterfejs
Ten obiekt określa właściwości, które można ustawić w obiekcie KmlLayer.
Właściwości | |
|---|---|
clickable optional |
Typ:
boolean optionalDomyślnie:
trueJeśli true, warstwa otrzymuje zdarzenia myszy. |
map optional |
Typ:
Map optionalMapa, na której ma być wyświetlana warstwa. |
preserveViewport optional |
Typ:
boolean optionalDomyślnie:
falseJeśli ta opcja jest ustawiona na true lub jeśli środek i powiększenie mapy nigdy nie zostały ustawione, mapa wejściowa jest wyśrodkowana i powiększona do ramki ograniczającej zawartość warstwy. |
screenOverlays optional |
Typ:
boolean optionalDomyślnie:
trueOkreśla, czy renderować nakładki ekranowe. |
suppressInfoWindows optional |
Typ:
boolean optionalUkrywanie okien informacyjnych po kliknięciu elementów warstwy. |
url optional |
Typ:
string optionalAdres URL dokumentu KML do wyświetlenia. |
zIndex optional |
Typ:
number optionalKolejność nakładania warstwy. |
KmlLayerMetadata interfejs
google.maps.KmlLayerMetadatainterfejs
Metadane pojedynczej warstwy KML w formacie JSON.
Właściwości | |
|---|---|
description |
Typ:
string<description> warstwy wyodrębniony z jej kodu. |
hasScreenOverlays |
Typ:
booleanCzy warstwa ma nakładki ekranowe. |
name |
Typ:
string<name> warstwy wyodrębniony z jej kodu. |
snippet |
Typ:
string<Snippet> warstwy wyodrębnione z jej kodu. |
author optional |
Typ:
KmlAuthor optional<atom:author> warstwy wyodrębniony z jej kodu. |
Stałe KmlLayerStatus
google.maps.KmlLayerStatus
stałe
Stan zwrócony przez KmlLayer po zakończeniu wczytywania dokumentu. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.KmlLayerStatus.OK.
Dostęp przez połączenie pod numer const {KmlLayerStatus} = await google.maps.importLibrary("maps").
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
|---|---|
DOCUMENT_NOT_FOUND |
Nie udało się znaleźć dokumentu. Najprawdopodobniej jest to nieprawidłowy adres URL lub dokument nie jest publicznie dostępny. |
DOCUMENT_TOO_LARGE |
Dokument przekracza limity rozmiaru pliku warstwy KmlLayer. |
FETCH_ERROR |
Nie udało się pobrać dokumentu. |
INVALID_DOCUMENT |
Dokument nie jest prawidłowym dokumentem KML, KMZ ani GeoRSS. |
INVALID_REQUEST |
Element KmlLayer jest nieprawidłowy. |
LIMITS_EXCEEDED |
Dokument przekracza limity elementów warstwy KmlLayer. |
OK |
Warstwa została wczytana. |
TIMED_OUT |
Nie udało się wczytać dokumentu w rozsądnym czasie. |
UNKNOWN |
Nie udało się wczytać dokumentu z nieznanego powodu. |
KmlMouseEvent interfejs
google.maps.KmlMouseEventinterfejs
Właściwości zdarzenia kliknięcia w dokumencie KML/KMZ lub GeoRSS.
Właściwości | |
|---|---|
featureData |
Typ:
KmlFeatureDataObiekt KmlFeatureData zawierający informacje o klikniętej funkcji. |
latLng |
Typ:
LatLngPozycja, w której okno informacyjne ma być zakotwiczone na klikniętym obiekcie. |
pixelOffset |
Typ:
SizePrzesunięcie, które ma zostać zastosowane do okna informacyjnego zakotwiczonego na klikniętym obiekcie. |
KmlFeatureData interfejs
google.maps.KmlFeatureDatainterfejs
Dane pojedynczego obiektu KML w formacie JSON, zwracane po kliknięciu obiektu KML. Dane zawarte w tym obiekcie odzwierciedlają dane powiązane z funkcją w kodzie KML lub GeoRSS, w którym jest ona zadeklarowana.
Właściwości | |
|---|---|
author |
Typ:
KmlAuthor<atom:author> funkcji wyodrębniony z oznaczeń warstwy (jeśli są określone). |
description |
Typ:
string<description> funkcji wyodrębniony z oznaczeń warstwy. |
id |
Typ:
string<id> funkcji wyodrębniony z oznaczeń warstwy. Jeśli nie podasz żadnego <id>, dla tej funkcji zostanie wygenerowany unikalny identyfikator. |
infoWindowHtml |
Typ:
stringTekst w dymku elementu, jeśli jest ustawiony. |
name |
Typ:
string<name> funkcji wyodrębniony z oznaczeń warstwy. |
snippet |
Typ:
string<Snippet> funkcji wyodrębniony z oznaczeń warstwy. |
KmlAuthor interfejs
google.maps.KmlAuthorinterfejs
Zawiera szczegółowe informacje o autorze dokumentu lub elementu KML.
Właściwości | |
|---|---|
email |
Typ:
stringAdres e-mail autora lub pusty ciąg znaków, jeśli nie został określony. |
name |
Typ:
stringImię i nazwisko autora lub pusty ciąg znaków, jeśli nie zostało podane. |
uri |
Typ:
stringStrona główna autora lub pusty ciąg znaków, jeśli nie została określona. |