Maps

Klasa Map

google.maps.Map zajęcia

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc pod numer const {Map} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Metody
fitBounds	fitBounds(bounds[, padding]) Parametry:  bounds:  LatLngBounds|LatLngBoundsLiteral Ograniczenia do pokazania. padding:  number|Padding optional Dopełnienie w pikselach. Granice będą pasować do tej części mapy, która pozostanie po usunięciu dopełnienia. Wartość liczbowa wywoła takie samo dopełnienie ze wszystkich 4 stron. Podaj tutaj 0, aby utworzyć idempotentną wartość fitBounds w wyniku getBounds. Zwracana wartość: brak Ustawia widoczny obszar tak, by zawierał podane granice. Uwaga: gdy mapa jest ustawiona na display: none, funkcja fitBounds odczytuje rozmiar mapy jako 0x0 i nie wykonuje żadnych działań. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw mapę na visibility: hidden. Dzięki temu jej element div będzie miał rzeczywisty rozmiar. W przypadku map wektorowych ta metoda ustawia domyślne wartości 0 pochyleń i kierunków mapy. Wywołanie tej metody może spowodować płynną animację podczas przesuwania i powiększania mapy w celu dopasowania do niej. Użycie tej metody zależy od wewnętrznej heurystyki.
getBounds	getBounds() Parametry: brak Zwracana wartość:  LatLngBounds|undefined Granice szerokości/długości bieżącego widocznego obszaru. Zwraca granice szerokości/długości bieżącego widocznego obszaru. Jeśli widoczna jest więcej niż 1 kopia świata, granica długości geograficznej wynosi od -180 do 180 stopni włącznie. Jeśli mapa nie została jeszcze zainicjowana albo nie ustawiono powiększenia i powiększenia, wynik to undefined. W przypadku map wektorowych z nachyleniem lub nachyleniem niezerowym zwrócone granice szerokości i długości geograficznej odpowiadają najmniejszej ramce ograniczającej, która obejmuje widoczny obszar mapy. Aby sprawdzić, gdzie dokładnie wygląda widoczny obszar mapy, kliknij MapCanvasProjection.getVisibleRegion.
getCenter	getCenter() Parametry: brak Zwracana wartość:  LatLng|undefined Zwraca pozycję wyświetlaną na środku mapy. Pamiętaj, że ten obiekt LatLng nie jest opakowany. Aby dowiedzieć się więcej, przeczytaj LatLng. Jeśli środek lub granice nie są ustawione, zwracany jest wynik undefined.
getClickableIcons	getClickableIcons() Parametry: brak Zwracana wartość:  boolean|undefined Zwraca klikalność ikon mapy. Ikona mapy przedstawia ciekawe miejsce, nazywane również miejscem POI. Jeśli zwrócona wartość to true, można kliknąć ikony na mapie.
getDatasetFeatureLayer	getDatasetFeatureLayer(datasetId) Parametry:  datasetId:  string Zwracana wartość:  FeatureLayer Zwraca wartość FeatureLayer w przypadku określonej datasetId. Identyfikatory zbiorów danych trzeba skonfigurować w Google Cloud Console. Jeśli identyfikator zbioru danych nie jest powiązany ze stylem mapy mapy lub styl oparty na danych jest niedostępny (brak identyfikatora mapy, kafelków wektorów, brak warstw funkcji stylu opartego na danych ani zbiorów danych skonfigurowanych w stylu mapy), zostanie zarejestrowany błąd, a wynikowy FeatureLayer.isAvailable ma wartość fałsz.
getDiv	getDiv() Parametry: brak Return Value (Wartość zwrócona): HTMLElement Parametr mapDiv mapy.
getFeatureLayer	getFeatureLayer(featureType) Parametry:  featureType:  FeatureType Zwracana wartość:  FeatureLayer Zwraca FeatureLayer elementu FeatureType. W konsoli Google Cloud musi być włączony FeatureLayer. Jeśli element FeatureLayer o określonym elemencie FeatureType nie istnieje na tej mapie lub styl oparty na danych jest niedostępny (brak identyfikatora mapy, kafelków wektorów i nie włączono FeatureLayer w stylu mapy), zostanie zarejestrowany błąd, a wynikowy FeatureLayer.isAvailable będzie miał wartość Fałsz.
getHeading	getHeading() Parametry: brak Zwracana wartość:  number|undefined Zwraca na kompasie kierunek na mapie. Wartość nagłówka jest mierzona w stopniach (w prawo) od kierunku północnego. Jeśli mapa nie została jeszcze zainicjowana, wynik to undefined.
getMapCapabilities	getMapCapabilities() Parametry: brak Zwracana wartość:  MapCapabilities Informuje obiekt wywołujący o aktualnych 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żącą wartość Projection. Jeśli mapa nie została jeszcze zainicjowana, wynik to undefined. Odsłuchaj zdarzenie projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to zdarzenie undefined.
getRenderingType	getRenderingType() Parametry: brak Zwracana wartość:  RenderingType Zwraca aktualną wartość RenderingType mapy.
getStreetView	getStreetView() Parametry: brak Return Value (Wartość zwrócona): StreetViewPanorama panorama powiązana z mapą. Zwraca domyślną wartość StreetViewPanorama powiązaną z mapą, czyli domyślną panoramę umieszczonym w mapie lub panoramę ustawioną w setStreetView(). Zmiany w obszarze streetViewControl mapy zostaną odzwierciedlone w widoku takiej powiązanej panoramy.
getTilt	getTilt() Parametry: brak Zwracana wartość:  number|undefined Zwraca bieżący kąt padania mapy w stopniach od płaszczyzny widocznego obszaru do płaszczyzny mapy. W przypadku map rastrowych wynik będzie wynosić 0 w przypadku zdjęć zrobionych bezpośrednio z powietrza lub 45 w przypadku zdjęć zrobionych pod kątem 45°. Ta metoda nie zwraca wartości ustawionej przez setTilt. Aby dowiedzieć się więcej, wejdź na setTilt.
getZoom	getZoom() Parametry: brak Zwracana wartość:  number|undefined Zwraca powiększenie mapy. Jeśli powiększenie nie zostało ustawione, będzie to undefined.
moveCamera	moveCamera(cameraOptions) Parametry:  cameraOptions:  CameraOptions Zwracana wartość: brak Natychmiast ustawia kamerę mapy na opcje kamery docelowej (bez animacji).
panBy	panBy(x, y) Parametry:  x:  number liczba pikseli, o które można przesunąć mapę w kierunku x. y:  number liczba pikseli, o które można przesunąć mapę w kierunku Y. Zwracana wartość: brak Zmienia środek mapy o podaną odległość w pikselach. Jeśli odległość jest mniejsza niż szerokość i wysokość mapy, przejście będzie płynnie animowane. Zwróć uwagę, że układ współrzędnych mapy zwiększa się z zachodu na wschód (w przypadku wartości x) i z północy na południe (w przypadku wartości y).
panTo	panTo(latLng) Parametry:  latLng:  LatLng|LatLngLiteral szerokość/długość geograficzna nowego obszaru środkowego na mapie. Zwracana wartość: brak Wyśrodkowuje mapę na wybrany obszar LatLng. Jeśli zmiana jest mniejsza niż szerokość i wysokość mapy, przejście będzie płynnie animowane.
panToBounds	panToBounds(latLngBounds[, padding]) Parametry:  latLngBounds:  LatLngBounds|LatLngBoundsLiteral Granice, do których należy przesunąć mapę. padding:  number|Padding optional Dopełnienie w pikselach. Wartość liczbowa wywoła takie samo dopełnienie ze wszystkich 4 stron. Wartością domyślną jest 0. Zwracana wartość: brak Przesuwa mapę o minimalną wielkość niezbędną do umieszczenia wybranego elementu LatLngBounds. Nie daje to żadnej gwarancji, w którym miejscu na mapie znajdą się granice. Mapa zostanie przesunięta w taki sposób, aby jak najlepiej pokazać obszar w obszarze {currentMapSizeInPx} - {padding}. Zarówno w przypadku map rastrowych, jak i wektorowych powiększenie, pochylenie i nagłówek mapy nie ulegną zmianie.
setCenter	setCenter(latlng) Parametry:  latlng:  LatLng|LatLngLiteral Zwracana wartość: brak
setClickableIcons	setClickableIcons(value) Parametry:  value:  boolean Zwracana wartość: brak Określa, czy ikony mapy mają być klikalne. Ikona mapy przedstawia ciekawe miejsce, nazywane również miejscem POI. Aby wyłączyć klikalność ikon mapy, przekaż do tej metody wartość false.
setHeading	setHeading(heading) Parametry:  heading:  number Zwracana wartość: brak Ustawia kierunek na kompasie na mapie mierzony w stopniach od kierunku północnego. W przypadku map rastrowych ta metoda ma zastosowanie tylko do zdjęć lotniczych.
setMapTypeId	setMapTypeId(mapTypeId) Parametry:  mapTypeId:  MapTypeId|string Zwracana wartość: brak
setOptions	setOptions(options) Parametry:  options:  MapOptions optional Zwracana wartość: brak
setStreetView	setStreetView(panorama) Parametry:  panorama:  StreetViewPanorama optional panorama, którą chcesz powiązać z mapą. Zwracana wartość: brak Wiąże obiekt StreetViewPanorama z mapą. Ta panorama zastępuje domyślne ustawienie StreetViewPanorama, co umożliwia powiązanie mapy z panoramą zewnętrzną spoza niej. Ustawienie panoramy na null powoduje powiązanie domyślnej umieszczonej panoramy z mapą.
setTilt	setTilt(tilt) Parametry:  tilt:  number Zwracana wartość: brak W przypadku map wektorowych ustawia kąt padania mapy. Dozwolone wartości są ograniczone w zależności od powiększenia mapy. W przypadku map rastrowych steruje automatycznym przełączaniem pod kątem kąta padania mapy. Jedyne dozwolone wartości to 0 i 45. setTilt(0) powoduje, że mapa jest zawsze wyświetlana z powietrza o wartości 0°, niezależnie od poziomu powiększenia i widocznego obszaru. setTilt(45) automatycznie przełącza kąt nachylenia na 45°, gdy dla bieżącego poziomu powiększenia i widocznego obszaru dostępne są zdjęcia 45°, oraz przełącza się z powrotem na 0, gdy zdjęcia 45° są niedostępne (jest to zachowanie domyślne). Zdjęcia 45° są dostępne tylko na mapach typu satellite i hybrid, w niektórych lokalizacjach i przy niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt pochylenia, a nie wartość ustawioną w setTilt. Właściwości getTilt i setTilt odnoszą się do różnych rzeczy, dlatego nie używaj właściwości bind() do właściwości tilt, ponieważ może to przynieść nieprzewidywalne efekty.
setZoom	setZoom(zoom) Parametry:  zoom:  number Większe wartości powiększenia oznaczają większą rozdzielczość. Zwracana wartość: brak Ustawia powiększenie mapy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

interfejs MapOptions

google.maps.MapOptions interfejs

Obiekt MapOptions używany do definiowania właściwości, które można ustawić w mapie.

Klasa MapElement

google.maps.MapElement zajęcia

MapElement to podklasa HTMLElement służąca do renderowania map. Po wczytaniu biblioteki maps można utworzyć mapę w kodzie HTML. 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>

Element niestandardowy:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

Ta klasa stanowi rozszerzenie HTMLElement.

Ta klasa implementuje MapElementOptions.

Uzyskaj dostęp, dzwoniąc pod numer const {MapElement} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Metody
addEventListener	addEventListener(type, listener[, options]) Parametry:  type:  string Ciąg znaków reprezentujący typ zdarzenia, na które ma być nasłuchiwany ciąg znaków (wielkość liter ma znaczenie). listener:  EventListener|EventListenerObject obiekt, który otrzymuje powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent options:  boolean|AddEventListenerOptions optional Zobacz opcje. Zdarzenia niestandardowe obsługują tylko zdarzenia capture i passive. Zwracana wartość:  void Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do elementu docelowego. Zobacz addEventListener.
removeEventListener	removeEventListener(type, listener[, options]) Parametry:  type:  string ciąg tekstowy określający typ zdarzenia, z którego ma zostać usunięty detektor zdarzeń. listener:  EventListener|EventListenerObject detektor zdarzeń modułu obsługi zdarzeń usuwany z celu zdarzenia. options:  boolean|EventListenerOptions optional Zobacz opcje Zwracana wartość:  void Usuwa z celu detektor zdarzeń zarejestrowany wcześniej w addEventListener. Zobacz removeEventListener.

Interfejs MapElementOptions

google.maps.MapElementOptions interfejs

Obiekt MapElementOptions służy do definiowania właściwości, które można ustawić w elemencie MapElement.

Klasa ZoomChangeEvent

google.maps.ZoomChangeEvent zajęcia

To zdarzenie jest tworzone na podstawie monitorowania zmiany powiększenia.

Ta klasa stanowi rozszerzenie Event.

Uzyskaj dostęp, dzwoniąc pod numer const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Interfejs MapTypeStyle

google.maps.MapTypeStyle interfejs

MapTypeStyle to zbiór selektorów i stylerów, które określają styl mapy. Selektory określają funkcje i elementy mapy, na które powinny one zostać wprowadzone, a style określają, jak te obiekty i elementy należy modyfikować. Szczegółowe informacje znajdziesz w informacjach o stylu.

interfejs MapMouseEvent

google.maps.MapMouseEvent interfejs

Ten obiekt jest zwracany z różnych zdarzeń myszy na mapie i nakładkach oraz zawiera wszystkie pokazane poniżej pola.

interfejs IconMouseEvent

google.maps.IconMouseEvent interfejs

Ten obiekt jest wysyłany w zdarzeniu, gdy użytkownik kliknie ikonę na mapie. Identyfikator miejsca tego miejsca jest zapisany w elemencie placeId. Aby zapobiec wyświetlaniu domyślnego okna informacyjnego, wywołaj w tym zdarzeniu metodę stop(), co uniemożliwi jego rozpowszechnianie. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów dotyczącym interfejsu API Miejsc Google.

Ten interfejs rozszerza zakres MapMouseEvent.

Stałe MapTypeId

google.maps.MapTypeId stałe

Identyfikatory typowych obiektów MapType. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'satellite' lub google.maps.MapTypeId.SATELLITE.

Uzyskaj dostęp, dzwoniąc pod numer const {MapTypeId} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Klasa MapTypeRegistry

google.maps.MapTypeRegistry zajęcia

Rejestr instancji MapType oznaczony kluczem według identyfikatora MapType.

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc pod numer const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Interfejs MapRestriction

google.maps.MapRestriction interfejs

Ograniczenie, które może zostać zastosowane do mapy. Widoczny obszar mapy nie przekroczy tych ograniczeń.

Klasa TrafficLayer

google.maps.TrafficLayer zajęcia

Warstwa natężenia ruchu.

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc pod numer const {TrafficLayer} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Interfejs TrafficLayerOptions

google.maps.TrafficLayerOptions interfejs

Obiekt TrafficLayerOptions używany do definiowania właściwości, które można ustawić w warstwie TrafficLayer.

Klasa TransitLayer

google.maps.TransitLayer zajęcia

Warstwa transportu publicznego.

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc pod numer const {TransitLayer} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Klasa BicyclingLayer

google.maps.BicyclingLayer zajęcia

Warstwa przedstawiająca ścieżki i ścieżki rowerowe.

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc pod numer const {BicyclingLayer} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Interfejs CameraOptions

google.maps.CameraOptions interfejs

Służy do ustawiania opcji aparatu mapy.

Interfejs VisibleRegion

google.maps.VisibleRegion interfejs

Składa się z czterech punktów definiujących wieloboczny wielokąt, który jest widocznym obszarem mapy. Na mapie wektorowej ten wielokąt może być trapezem, a nie prostokątem, jeśli mapa wektorowa ma przechylenie.

Stałe RenderingType

google.maps.RenderingType stałe

Uzyskaj dostęp, dzwoniąc pod numer const {RenderingType} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Interfejs MapCapabilities

google.maps.MapCapabilities interfejs

Obiekt zawierający migawkę funkcji dostępnych obecnie w mapie. Pamiętaj, że niekoniecznie oznacza to, że odpowiednie moduły zostały wczytane lub zainicjowane, ale że bieżąca mapa ma uprawnienia do korzystania z tych interfejsów API. Listę dostępnych funkcji znajdziesz w właściwościach.