Places UI Kit: gotowa do użycia biblioteka, która zapewnia programistom możliwość dostosowywania i kontrolowania. Wypróbuj go i podziel się opinią na temat korzystania z interfejsu UI Kit.

Ta strona została przetłumaczona przez Cloud Translation API.

Maps

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: `mapDiv`: `HTMLElement` Mapa zostanie wyrenderowana, aby wypełnić ten element. `opts`: `MapOptions optional` Opcje 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`	Typ: `MVCArray<MapType optional>` 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: `bounds`: `LatLngBounds\|LatLngBoundsLiteral` granice do wyświetlenia. `padding`: `number\|Padding optional` Dopełnienie w pikselach. Granice zostaną dopasowane do części mapy, która pozostanie po usunięciu dopełnienia. Wartość liczbowa spowoduje zastosowanie tego samego dopełnienia po wszystkich 4 stronach. Wpisz tu 0, aby funkcja fitBounds była idempotentna w stosunku do wyniku funkcji getBounds. 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` 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 zostały ustawione, wynikiem jest `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`	Uwaga: dostępna tylko na kanale v=beta. `getDatasetFeatureLayer(datasetId)` Parametry: `datasetId`: `string` 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: `featureType`: `FeatureType` 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: `StreetViewPanorama` panorama powiązana z mapą. Zwraca domyślny obiekt `StreetViewPanorama` powiązany z mapą, który może być domyślną panoramą osadzoną na mapie lub panoramą ustawioną za pomocą funkcji `setStreetView()`. Zmiany w `streetViewControl` mapy będą odzwierciedlane w wyświetlaniu takiego powiązanego 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 wynikiem będzie `0` w przypadku zdjęć wykonanych bezpośrednio z góry lub `45` w przypadku zdjęć wykonanych pod kątem 45°. Ta metoda nie zwraca wartości ustawionej przez `setTilt`. Więcej informacji znajdziesz w sekcji `setTilt`.
`getTiltInteractionEnabled`	`getTiltInteractionEnabled()` Parametry: brak Zwracana wartość: `boolean\|null` Zwraca informację, czy interakcje związane z przechylaniem 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).
`getZoom`	`getZoom()` Parametry: brak Zwracana wartość: `number\|undefined` Zwraca powiększenie mapy. Jeśli powiększenie nie zostało ustawione, wynikiem jest `undefined`.
`moveCamera`	`moveCamera(cameraOptions)` Parametry: `cameraOptions`: `CameraOptions` Zwracana wartość: brak Natychmiast ustawia kamerę mapy na docelowe opcje kamery bez animacji.
`panBy`	`panBy(x, y)` Parametry: `x`: `number` Liczba pikseli, o którą mapa ma zostać przesunięta w kierunku osi X. `y`: `number` liczba pikseli, o którą należy przesunąć mapę w kierunku osi 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. Pamiętaj, że w układzie współrzędnych mapy wartości x rosną z zachodu na wschód, a wartości y – z północy na południe.
`panTo`	`panTo(latLng)` Parametry: `latLng`: `LatLng\|LatLngLiteral` Nowa szerokość i długość geograficzna środka mapy. Zwracana wartość: brak Zmienia środek mapy na podany punkt `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 ma zostać przesunięta mapa. `padding`: `number\|Padding optional` Dopełnienie w pikselach. Wartość liczbowa spowoduje zastosowanie tego samego dopełnienia po wszystkich 4 stronach. Wartością domyślną jest 0. Zwracana wartość: brak Przesuwa mapę o minimalną wymaganą odległość, aby zawierała podany obiekt `LatLngBounds`. Nie gwarantuje, gdzie na mapie będą znajdować się granice, z wyjątkiem tego, że mapa zostanie przesunięta tak, aby w `{currentMapSizeInPx} - {padding}` pokazywać jak największą część granic. W przypadku map rastrowych i wektorowych nie zmieni się powiększenie, pochylenie ani kierunek mapy.
`setCenter`	`setCenter(latlng)` Parametry: `latlng`: `LatLng\|LatLngLiteral` Zwracana wartość: brak
`setClickableIcons`	`setClickableIcons(value)` Parametry: `value`: `boolean` Zwracana wartość: brak Określa, czy ikony na mapie są klikalne. Ikona mapy reprezentuje ciekawe miejsce. Aby wyłączyć możliwość klikania ikon na mapie, przekaż do tej metody wartość `false`.
`setHeading`	`setHeading(heading)` Parametry: `heading`: `number` Zwracana wartość: brak Ustawia kierunek kompasu na mapie mierzony w stopniach od kierunku północnego. W przypadku map rastrowych ta metoda ma zastosowanie tylko do zdjęć lotniczych.
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` Parametry: `headingInteractionEnabled`: `boolean` Zwracana wartość: brak Określa, 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).
`setMapTypeId`	`setMapTypeId(mapTypeId)` Parametry: `mapTypeId`: `MapTypeId\|string` Zwracana wartość: brak
`setOptions`	`setOptions(options)` Parametry: `options`: `MapOptions optional` Zwracana wartość: brak
`setRenderingType`	`setRenderingType(renderingType)` Parametry: `renderingType`: `RenderingType` Zwracana wartość: brak Ustawia bieżący typ renderowania mapy.
`setStreetView`	`setStreetView(panorama)` Parametry: `panorama`: `StreetViewPanorama optional` panorama do powiązania z mapą. Zwracana wartość: brak Wiąże obiekt `StreetViewPanorama` z mapą. Ta panorama zastępuje domyślną panoramę `StreetViewPanorama`, dzięki czemu mapa może być powiązana z zewnętrzną panoramą znajdującą się poza nią. Ustawienie panoramy na `null` powoduje ponowne powiązanie domyślnej osadzonej 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 poziomu powiększenia mapy. W przypadku map rastrowych określa automatyczne przełączanie kąta padania mapy. Dozwolone wartości to tylko `0` i `45`. `setTilt(0)` powoduje, że mapa zawsze używa widoku z góry pod kątem 0° niezależnie od poziomu powiększenia i widocznego obszaru. `setTilt(45)` powoduje automatyczne przełączanie kąta nachylenia na 45°, gdy dla bieżącego poziomu powiększenia i widocznego obszaru dostępne są zdjęcia z kątem 45°, oraz powrót do 0°, gdy zdjęcia z kątem 45° są niedostępne (jest to domyślne zachowanie). Obrazy pod kątem 45° są dostępne tylko w przypadku typów map `satellite` i `hybrid`, w niektórych lokalizacjach i przy niektórych poziomach powiększenia. Uwaga: `getTilt` zwraca aktualny kąt nachylenia, a nie wartość ustawioną przez `setTilt`. Ponieważ `getTilt` i `setTilt` odnoszą się do różnych rzeczy, nie `bind()` właściwości `tilt`, ponieważ może to mieć nieprzewidywalne skutki.
`setTiltInteractionEnabled`	`setTiltInteractionEnabled(tiltInteractionEnabled)` Parametry: `tiltInteractionEnabled`: `boolean` Zwracana wartość: brak Określa, czy interakcje związane z przechylaniem 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).
`setZoom`	`setZoom(zoom)` Parametry: `zoom`: `number` Większe wartości powiększenia odpowiadają wyższej rozdzielczości. Zwracana wartość: brak Ustawia powiększenie mapy.
Odziedziczone: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Wydarzenia
`bounds_changed`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy zmienią się granice obszaru widocznego.
`center_changed`	`function()` Argumenty: brak To zdarzenie jest uruchamiane, gdy zmienia się właściwość środka mapy.
`click`	`function(event)` Argumenty: `event`: `MapMouseEvent\|IconMouseEvent` To zdarzenie jest uruchamiane, gdy użytkownik kliknie mapę. Zwracany jest obiekt MapMouseEvent z właściwościami klikniętej lokalizacji, chyba że kliknięto ikonę miejsca. W takim przypadku zwracany jest obiekt IconMouseEvent z identyfikatorem miejsca. Typy IconMouseEvent i MapMouseEvent są identyczne, z tym że IconMouseEvent ma pole identyfikatora miejsca. Jeśli identyfikator miejsca nie jest ważny, zdarzenie można zawsze traktować jako MapMouseEvent. Jeśli kliknięto marker lub okno informacyjne, zdarzenie kliknięcia nie jest uruchamiane.
`contextmenu`	`function(event)` Argumenty: `event`: `MapMouseEvent` To zdarzenie jest wywoływane, gdy w kontenerze mapy zostanie wywołane zdarzenie DOM contextmenu.
`dblclick`	`function(event)` Argumenty: `event`: `MapMouseEvent` To zdarzenie jest wywoływane, gdy użytkownik kliknie dwukrotnie mapę. Pamiętaj, że zdarzenie kliknięcia czasami uruchamia się raz, a czasami dwa razy, tuż przed tym zdarzeniem.
`drag`	`function()` Argumenty: brak To zdarzenie jest wywoływane wielokrotnie, gdy użytkownik przeciąga mapę.
`dragend`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy użytkownik przestanie przeciągać mapę. Uwaga: zdarzenie dragend NIE jest wywoływane, gdy użytkownik przestanie przesuwać mapę za pomocą klawiatury. Aby określić, kiedy użytkownik przestał przesuwać lub przeciągać mapę, użyj zdarzenia `Map.idle`.
`dragstart`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy użytkownik zaczyna przeciągać mapę.
`heading_changed`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość kierunku mapy.
`idle`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy mapa przechodzi w stan bezczynności po przesunięciu lub powiększeniu.
`isfractionalzoomenabled_changed`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy zmieni się właściwość isFractionalZoomEnabled.
`mapcapabilities_changed`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy zmieniają się funkcje mapy.
`maptypeid_changed`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość mapTypeId.
`mousemove`	`function(event)` Argumenty: `event`: `MapMouseEvent` To zdarzenie jest wywoływane za każdym razem, gdy kursor myszy użytkownika przesuwa się nad kontenerem mapy.
`mouseout`	`function(event)` Argumenty: `event`: `MapMouseEvent` To zdarzenie jest wywoływane, gdy kursor myszy użytkownika opuści kontener mapy.
`mouseover`	`function(event)` Argumenty: `event`: `MapMouseEvent` To zdarzenie jest wywoływane, gdy kursor myszy użytkownika wchodzi do kontenera mapy.
`projection_changed`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy zmieni się projekcja.
`renderingtype_changed`	`function()` Argumenty: brak To zdarzenie jest uruchamiane, gdy zmieni się wartość renderingType.
`tilesloaded`	`function()` Argumenty: brak To zdarzenie jest wywoływane po zakończeniu wczytywania widocznych kafelków.
`tilt_changed`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość pochylenia mapy.
`zoom_changed`	`function()` Argumenty: brak To zdarzenie jest wywoływane, gdy zmienia się właściwość powiększenia mapy.
`rightclick`	Wycofane: zamiast tego użyj zdarzenia `Map.contextmenu`, aby obsługiwać wzorce użycia, takie jak kliknięcie z naciśniętym klawiszem Control na macOS. `function(event)` Argumenty: `event`: `MapMouseEvent` To zdarzenie jest wywoływane, gdy użytkownik kliknie mapę prawym przyciskiem myszy.

MapOptions interfejs

google.maps.MapOptionsinterfejs

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

Właściwości
`backgroundColor optional`	Typ: `string optional` Kolor używany jako tło elementu div mapy. Ten kolor będzie widoczny, zanim kafelki zostaną wczytane podczas przesuwania mapy przez użytkownika. Tę opcję można ustawić tylko podczas inicjowania mapy.
`cameraControl optional`	Typ: `boolean optional` Stan włączenia/wyłączenia sterowania kamerą.

Maps Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Map class

Zespół

Stałe

Właściwości

Metody

Wydarzenia

MapOptions interfejs

Właściwości

Maps