MapElement class
google.maps.MapElement
zajęcia
MapElement to podklasa HTMLElement
służąca do renderowania map. Po wczytaniu biblioteki maps
można utworzyć mapę w HTML-u. Na przykład:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
<button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>
Wewnętrznie używa
Map
, do którego można uzyskać dostęp za pomocą właściwości MapElement.innerMap
.
Element niestandardowy:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
Ta klasa rozszerza klasę HTMLElement
.
Ta klasa implementuje interfejs MapElementOptions
.
Dostęp przez połączenie pod numer const {MapElement} = await google.maps.importLibrary("maps")
.
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
MapElement |
MapElement([options]) Parametry:
|
Właściwości | |
---|---|
center |
Typ:
LatLng|LatLngLiteral optional Szerokość i długość geograficzna środka mapy.
Atrybut HTML:
|
headingInteractionDisabled |
Typ:
boolean optional Domyślnie:
false Określa, czy mapa powinna zezwalać użytkownikowi na sterowanie kierunkiem kamery (obrotem). Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, użyta zostanie konfiguracja w chmurze dla identyfikatora mapy (jeśli jest dostępna).
Atrybut HTML:
|
innerMap |
Typ:
Map Odwołanie do elementu Map , którego MapElement używa wewnętrznie. |
internalUsageAttributionIds |
Typ:
Iterable<string> optional Domyślnie:
null Dodaje do inicjatora identyfikator atrybucji użycia, który pomaga Google określić, które biblioteki i przykłady są przydatne dla deweloperów, np. użycie biblioteki klastrowania znaczników. Aby zrezygnować z wysyłania identyfikatora atrybucji użytkowania, możesz usunąć tę właściwość lub zastąpić jej wartość pustym ciągiem. Wysyłane będą tylko unikalne wartości. Zmiany tej wartości po utworzeniu instancji mogą być ignorowane.
Atrybut HTML:
|
mapId |
Typ:
string optional Identyfikator mapy. Tego parametru nie można ustawić ani zmienić po utworzeniu instancji mapy.
Map.DEMO_MAP_ID można używać do wypróbowywania funkcji, które wymagają identyfikatora mapy, ale nie wymagają włączenia w chmurze.Atrybut HTML:
|
renderingType |
Typ:
RenderingType optional Domyślnie:
RenderingType.VECTOR Określa, czy mapa ma być rastrowa, czy wektorowa. Tego parametru nie można ustawić ani zmienić po utworzeniu instancji mapy. Jeśli nie zostanie ustawiony, typ renderowania (jeśli jest dostępny) zostanie określony przez konfigurację w chmurze dla identyfikatora mapy. Pamiętaj, że mapy wektorowe mogą nie być dostępne na wszystkich urządzeniach i w przeglądarkach. W razie potrzeby mapa zostanie zastąpiona rastrową.
Atrybut HTML:
|
tiltInteractionDisabled |
Typ:
boolean optional Domyślnie:
false Określa, czy mapa powinna zezwalać użytkownikowi na sterowanie pochyleniem kamery. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, użyta zostanie konfiguracja w chmurze dla identyfikatora mapy (jeśli jest dostępna).
Atrybut HTML:
|
zoom |
Typ:
number optional Poziom powiększenia mapy. Prawidłowe wartości powiększenia to liczby od zera do obsługiwanego maksymalnego poziomu powiększenia. Większe wartości powiększenia odpowiadają wyższej rozdzielczości.
Atrybut HTML:
|
Metody | |
---|---|
|
addEventListener(type, listener[, options]) Parametry:
Zwracana wartość:
void Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener. |
|
removeEventListener(type, listener[, options]) Parametry:
Zwracana wartość:
void Usuwa z obiektu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener. |
Wydarzenia | |
---|---|
gmp-zoomchange |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy zmienia się właściwość powiększenia mapy. |
MapElementOptions interfejs
google.maps.MapElementOptions
interfejs
Obiekt MapElementOptions służący do definiowania właściwości, które można ustawić w obiekcie MapElement.
Właściwości | |
---|---|
center optional |
Typ:
LatLng|LatLngLiteral optional Zobacz MapElement.center . |
headingInteractionDisabled optional |
Typ:
boolean optional |
internalUsageAttributionIds optional |
Typ:
Iterable<string> optional |
mapId optional |
Typ:
string optional Zobacz MapElement.mapId . |
renderingType optional |
Typ:
RenderingType optional Zobacz MapElement.renderingType . |
tiltInteractionDisabled optional |
Typ:
boolean optional |
zoom optional |
Typ:
number optional Zobacz MapElement.zoom . |
ZoomChangeEvent class
google.maps.ZoomChangeEvent
zajęcia
To zdarzenie jest tworzone na podstawie monitorowania zmiany powiększenia.
Ta klasa rozszerza klasę Event
.
Dostęp przez połączenie pod numer const {ZoomChangeEvent} = await google.maps.importLibrary("maps")
.
Zobacz Biblioteki w Maps JavaScript API.
Map class
google.maps.Map
zajęcia
Ta klasa rozszerza klasę MVCObject
.
Dostęp przez połączenie pod numer const {Map} = await google.maps.importLibrary("maps")
.
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
Map |
Map(mapDiv[, opts]) Parametry:
Tworzy nową mapę w danym kontenerze HTML, który jest zwykle elementem DIV . |
Stałe | |
---|---|
DEMO_MAP_ID |
Identyfikator mapy, którego można używać w przykładowych kodach wymagających identyfikatora mapy. Ten identyfikator mapy nie jest przeznaczony do użytku w aplikacjach produkcyjnych i nie można go używać w przypadku funkcji, które wymagają konfiguracji w chmurze (np. dostosowywania stylu przez konsolę Cloud). |
Właściwości | |
---|---|
controls |
Typ:
Array<MVCArray<HTMLElement>> Dodatkowe elementy sterujące dołączane do mapy. Aby dodać element sterujący do mapy, dodaj jego <div> do MVCArray odpowiadającego ControlPosition , w którym ma być renderowany. |
data |
Typ:
Data Instancja Data powiązana z mapą. Dodaj do tego obiektu Data funkcje, aby wygodnie wyświetlać je na tej mapie. |
mapTypes |
Typ:
MapTypeRegistry Rejestr instancji MapType według identyfikatora ciągu. |
overlayMapTypes |
Dodatkowe typy map do nałożenia. Typy map nakładkowych będą wyświetlane na mapie bazowej, do której są dołączone, w kolejności, w jakiej występują w tablicy overlayMapTypes (nakładki o wyższych wartościach indeksu są wyświetlane przed nakładkami o niższych wartościach indeksu). |
Metody | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parametry:
Zwracana wartość: brak
Ustawia widoczny obszar tak, aby obejmował podane granice. Uwaga: gdy mapa jest ustawiona na display: none , funkcja fitBounds odczytuje rozmiar mapy jako 0x0, a więc nie wykonuje żadnych działań. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw mapę na visibility: hidden , dzięki czemu element div mapy będzie miał rzeczywisty rozmiar. W przypadku map wektorowych ta metoda ustawia pochylenie i kierunek mapy na domyślne wartości zerowe. Wywołanie tej metody może spowodować płynną animację podczas przesuwania i powiększania mapy w celu dopasowania jej do granic. To, czy ta metoda animuje, zależy od wewnętrznej heurystyki. |
getBounds |
getBounds() Parametry: brak
Wartość zwracana:
LatLngBounds|undefined granice szerokości i długości geograficznej bieżącego widocznego obszaru.Zwraca granice bieżącego widoku w postaci współrzędnych geograficznych. Jeśli widocznych jest więcej niż 1 kopia świata, zakres granic w długości geograficznej wynosi od -180 do 180 stopni włącznie. Jeśli mapa nie została jeszcze zainicjowana lub nie ustawiono środka i poziomu powiększenia, wynikiem jest undefined . W przypadku map wektorowych z niezerowym nachyleniem lub kierunkiem zwrócone granice szerokości i długości geograficznej reprezentują najmniejsze pole ograniczenia, które obejmuje widoczny region obszaru wyświetlania mapy. Więcej informacji o uzyskiwaniu dokładnego widocznego regionu obszaru wyświetlania mapy znajdziesz w sekcji MapCanvasProjection.getVisibleRegion . |
getCenter |
getCenter() Parametry: brak
Zwracana wartość:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parametry: brak
Zwracana wartość:
boolean|undefined Zwraca klikalność ikon mapy. Ikona mapy reprezentuje ciekawe miejsce. Jeśli zwrócona wartość to true , ikony na mapie można kliknąć. |
|
getDatasetFeatureLayer(datasetId) Parametry:
Zwracana wartość:
FeatureLayer Zwraca FeatureLayer dla określonego datasetId . Identyfikatory zbiorów danych muszą być skonfigurowane w konsoli Google Cloud. Jeśli identyfikator zbioru danych nie jest powiązany ze stylem mapy lub jeśli styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak kafelków wektorowych, brak warstw funkcji stylu opartego na danych lub zbiorów danych skonfigurowanych w stylu mapy), zostanie zarejestrowany błąd, a wynikowa wartość FeatureLayer.isAvailable będzie fałszywa. |
getDiv |
getDiv() Parametry: brak
Zwracana wartość:
HTMLElement element mapDiv mapy. |
getFeatureLayer |
getFeatureLayer(featureType) Parametry:
Zwracana wartość:
FeatureLayer Zwraca FeatureLayer określonego FeatureType . FeatureLayer musi być włączony w konsoli Google Cloud. Jeśli na tej mapie nie ma FeatureLayer o podanym FeatureType lub jeśli styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak kafelków wektorowych i brak FeatureLayer włączonego w stylu mapy), rejestrowany jest błąd, a wynikowy FeatureLayer.isAvailable ma wartość false. |
getHeading |
getHeading() Parametry: brak
Zwracana wartość:
number|undefined Zwraca kierunek mapy na kompasie. Wartość kierunku jest mierzona w stopniach (zgodnie z ruchem wskazówek zegara) od kierunku północnego. Jeśli mapa nie została jeszcze zainicjowana, wynikiem jest undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parametry: brak
Zwracana wartość:
boolean|null Zwraca informację, czy interakcje z nagłówkami są włączone. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, użyta zostanie konfiguracja w chmurze dla identyfikatora mapy (jeśli jest dostępna). |
getInternalUsageAttributionIds |
getInternalUsageAttributionIds() Parametry: brak
Zwracana wartość:
Iterable<string>|null Zwraca listę identyfikatorów atrybucji użycia, które pomagają Google określić, które biblioteki i przykłady są przydatne dla deweloperów, np. użycie biblioteki klastrowania znaczników. |
getMapCapabilities |
getMapCapabilities() Parametry: brak
Zwracana wartość:
MapCapabilities Informuje wywołującego o bieżących możliwościach dostępnych na mapie na podstawie podanego identyfikatora mapy. |
getMapTypeId |
getMapTypeId() Parametry: brak
Zwracana wartość:
MapTypeId|string|undefined |
getProjection |
getProjection() Parametry: brak
Zwracana wartość:
Projection|undefined Zwraca bieżące urządzenie Projection . Jeśli mapa nie została jeszcze zainicjowana, wynikiem jest undefined . Nasłuchuj zdarzenia projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to undefined . |
getRenderingType |
getRenderingType() Parametry: brak
Zwracana wartość:
RenderingType Zwraca bieżący RenderingType mapy. |
getStreetView |
getStreetView() Parametry: brak
Wartość zwracana:
|