Klasa KmlLayer
google.maps.KmlLayer
zajęcia
Element KmlLayer
dodaje do mapy znaczniki geograficzne z pliku KML, KMZ lub GeoRSS, który jest przechowywany na publicznie dostępnym serwerze WWW. Po kliknięciu każdej funkcji dostępny jest obiekt KmlFeatureData
.
Te zajęcia są rozszerzone na MVCObject
.
Aby uzyskać dostęp, zadzwoń pod numer const {KmlLayer} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
KmlLayer |
KmlLayer([opts]) Parametry:
Tworzy element KmlLayer , który renderuje zawartość wskazanego pliku KML/KMZ (https://developers.google.com/kml/documentation/kmlreference) lub pliku GeoRSS (http://www.georss.org). |
Metody | |
---|---|
getDefaultViewport |
getDefaultViewport() Parametry: brak
Wartość zwrotu:
LatLngBounds Pobierz domyślny widoczny obszar wyświetlanej warstwy. |
getMap |
getMap() Parametry: brak
Wartość zwrotu:
Map Pobierz mapę, na której renderowana jest warstwa KML. |
getMetadata |
getMetadata() Parametry: brak
Wartość zwrotu:
KmlLayerMetadata Pobierz metadane powiązane z tą warstwą określone w znacznikach warstwy. |
getStatus |
getStatus() Parametry: brak
Wartość zwrotu:
KmlLayerStatus Uzyskanie stanu warstwy, który należy ustawić 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 wartość kolejności nakładania elementów.Pobiera wartość z-index warstwy KML. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Renderuje warstwę KML na określonej mapie. Jeśli ustawienie mapy to null , warstwa zostanie usunięta. |
setOptions |
setOptions(options) Parametry:
Zwracana wartość: brak
|
setUrl |
setUrl(url) Parametry:
Zwracana wartość: brak
Ustawia adres URL wyświetlanego pliku KML. |
setZIndex |
setZIndex(zIndex) Parametry:
Zwracana wartość: brak
Ustawia kolejność nakładania elementów na warstwie KML. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Wydarzenia | |
---|---|
click |
function(kmlClickEvent) Argumenty:
Zdarzenie to jest wywoływane po kliknięciu obiektu w warstwie. |
defaultviewport_changed |
function() Argumenty: brak
Zdarzenie jest uruchamiane, gdy zmieni się domyślny widoczny obszar warstw KML. |
status_changed |
function() Argumenty: brak
Zdarzenie to jest wywoływane po zakończeniu ładowania warstwy KML. Na tym etapie możesz bezpiecznie odczytać właściwość stanu, aby sprawdzić, czy warstwa została wczytana. |
Interfejs KmlLayerOptions
google.maps.KmlLayerOptions
interfejs
Ten obiekt określa właściwości, które można ustawić w obiekcie KmlLayer
.
Właściwości | |
---|---|
clickable optional |
Typ:
boolean optional Wartość domyślna:
true Jeśli ustawiona jest wartość true , warstwa odbiera zdarzenia myszy. |
map optional |
Typ:
Map optional Mapa, na której ma być wyświetlana warstwa. |
preserveViewport optional |
Typ:
boolean optional Wartość domyślna:
false Jeśli ta opcja jest ustawiona na true lub jeśli nie ustawiono środkowego obszaru i powiększenia mapy, mapa wejściowa jest wyśrodkowana i powiększona do ramki ograniczającej zawartość warstwy. |
screenOverlays optional |
Typ:
boolean optional Wartość domyślna:
true Określa, czy mają być renderowane nakładki ekranu. |
suppressInfoWindows optional |
Typ:
boolean optional Pomijaj renderowanie okien informacyjnych po kliknięciu obiektów warstwy. |
url optional |
Typ:
string optional Adres URL dokumentu KML do wyświetlenia. |
zIndex optional |
Typ:
number optional Wartość kolejności nakładania elementów warstwy. |
Interfejs KmlLayerMetadata
google.maps.KmlLayerMetadata
interfejs
Metadane pojedynczej warstwy KML w formacie JSON.
Właściwości | |
---|---|
author |
Typ:
KmlAuthor Element <atom:author> warstwy został wyodrębniony ze znaczników warstwy. |
description |
Typ:
string Element <description> warstwy został wyodrębniony ze znaczników warstwy. |
hasScreenOverlays |
Typ:
boolean Określa, czy warstwa ma nakładki ekranu. |
name |
Typ:
string Element <name> warstwy został wyodrębniony ze znaczników warstwy. |
snippet |
Typ:
string Element <Snippet> warstwy, wyodrębniony ze znaczników warstwy |
Stałe KmlLayerStatus
google.maps.KmlLayerStatus
stałe
Stan zwrócony przez usługę KmlLayer
po zakończeniu wczytywania dokumentu. Określ je według wartości lub nazwy stałej. Na przykład 'OK'
lub google.maps.KmlLayerStatus.OK
.
Aby uzyskać dostęp, zadzwoń pod numer const {KmlLayerStatus} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
DOCUMENT_NOT_FOUND |
Nie można znaleźć dokumentu. Najprawdopodobniej jest to nieprawidłowy adres URL lub dokument nie jest publicznie dostępny. |
DOCUMENT_TOO_LARGE |
Dokument przekracza limity rozmiaru pliku KmlLayer. |
FETCH_ERROR |
Nie udało się pobrać dokumentu. |
INVALID_DOCUMENT |
Dokument nie jest prawidłowym dokumentem KML, KMZ lub GeoRSS. |
INVALID_REQUEST |
Pole KmlLayer jest nieprawidłowe. |
LIMITS_EXCEEDED |
Dokument przekracza limity funkcji 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. |
Interfejs KmlMouseEvent
google.maps.KmlMouseEvent
interfejs
Właściwości zdarzenia kliknięcia w dokumencie KML/KMZ lub GeoRSS.
Właściwości | |
---|---|
featureData |
Typ:
KmlFeatureData Obiekt KmlFeatureData z informacjami o klikniętej funkcji. |
latLng |
Typ:
LatLng Pozycja, w której ma być zakotwiczone okno informacyjne klikniętego obiektu. |
pixelOffset |
Typ:
Size Przesunięcie, które ma być zastosowane do okna informacyjnego zakotwiczonego na klikniętym obiekcie. |
Interfejs KmlFeatureData
google.maps.KmlFeatureData
interfejs
Dane pojedynczej funkcji KML w formacie JSON, zwracane po kliknięciu obiektu KML. Dane zawarte w tym obiekcie odpowiadają danym powiązanym z obiektem w znacznikach KML lub GeoRSS, w których został on zadeklarowany.
Właściwości | |
---|---|
author |
Typ:
KmlAuthor Wartość <atom:author> obiektu wyodrębniona ze znaczników warstwy (jeśli została określona). |
description |
Typ:
string Identyfikator <description> obiektu wyodrębniony ze znaczników warstwy. |
id |
Typ:
string Identyfikator <id> obiektu wyodrębniony ze znaczników warstwy. Jeśli <id> nie został określony, dla tej funkcji zostanie wygenerowany unikalny identyfikator. |
infoWindowHtml |
Typ:
string Tekst w stylu dymka elementu (jeśli został ustawiony). |
name |
Typ:
string Identyfikator <name> obiektu wyodrębniony ze znaczników warstwy. |
snippet |
Typ:
string Identyfikator <Snippet> obiektu wyodrębniony ze znaczników warstwy. |
Interfejs KmlAuthor
google.maps.KmlAuthor
interfejs
Zawiera informacje o autorze dokumentu lub obiektu KML.
Właściwości | |
---|---|
email |
Typ:
string Adres e-mail autora lub pusty ciąg, jeśli nie został podany. |
name |
Typ:
string Imię i nazwisko autora lub pusty ciąg znaków, jeśli nie został podany. |
uri |
Typ:
string Strona główna autora lub pusty ciąg, jeśli nie został określony. |