Image overlays

Interfejs MapType

Interfejs google.maps.MapType

Ten interfejs definiuje typ mapy i jest zwykle używany w przypadku niestandardowych typów map. Wartość niezmienna.
maxZoom
Typ: number
Maksymalny poziom powiększenia mapy podczas wyświetlania tego typu mapy. Wymagane w przypadku podstawowych typów map, ignorowane w przypadku typów map nakładanych.
minZoom
Typ: number
Minimalny poziom powiększenia mapy podczas wyświetlania tego typu mapy. Opcjonalny, domyślna wartość to 0.
radius
Typ: number
Promień planety na mapie w metrach. Opcjonalny; domyślnie jest to promień równikowy Ziemi wynoszący 6 378 137 metrów.
alt
opcjonalne
Typ: string optional
Tekst alternatywny wyświetlany po najechaniu kursorem na przycisk MapType w MapTypeControl. Opcjonalnie:
name
opcjonalne
Typ: string optional
Nazwa wyświetlana w MapTypeControl. Opcjonalnie:
projection
opcjonalne
Typ: Projection optional
Projekcja używana do renderowania tego typu mapy. Opcjonalny, domyślnie Mercator.
tileSize
opcjonalne
Typ: Size optional
Wymiary każdego kafelka. Wymagane.
getTile
getTile(tileCoord, zoom, ownerDocument)
Parametry:
  • tileCoord: Point Współrzędne mapy.
  • zoom: number Powiększenie kafelka.
  • ownerDocument: Document Dokument, do którego należy ten kafelek.
Zwracana wartość: Element|null – wynikowy kafelek.
Zwraca fragment mapy dla podanych współrzędnych mapy (x, y) i poziomu powiększenia. Ten kafelek zostanie dołączony do podanego dokumentu ownerDocument. Niedostępne w przypadku typów map podstawowych.
releaseTile
releaseTile(tile)
Parametry:
  • tile: Element optional kafelek do zwolnienia.
Wartość zwracana: void
Zwalnia dany kafelek, wykonując niezbędne czyszczenie. Podany element został już usunięty z dokumentu. Opcjonalnie:

Interfejs projekcji

Interfejs google.maps.Projection

Interfejs projekcji.
fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
Parametry:
Wartość zwracana: Point|null
Przekształca współrzędne LatLng na współrzędne Point. Ten interfejs określa funkcję, która implementuje translację z podanych wartości LatLng na współrzędne świata w odwzorowaniu mapy. Interfejs API Map wywołuje tę metodę, gdy musi nanieść lokalizacje na ekranie. Obiekty Projection muszą implementować tę metodę, ale mogą zwracać null, jeśli projekcja nie może obliczyć Point.
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
Parametry:
  • pixel: Point
  • noClampNoWrap: boolean optional
Wartość zwracana: LatLng|null
Ten interfejs określa funkcję, która implementuje translację ze współrzędnych świata w projekcji mapy na wartości LatLng. Interfejs API Map wywołuje tę metodę, gdy musi przełożyć działania na ekranie na pozycje na mapie. Obiekty Projection muszą implementować tę metodę, ale mogą zwracać null, jeśli projekcja nie może obliczyć LatLng.

Klasa ImageMapType

google.maps.ImageMapType class
extends MVCObject
implements MapType
library "maps"

Ta klasa implementuje interfejs MapType i służy do renderowania kafelków obrazów.

const {ImageMapType} = await google.maps.importLibrary("maps");
ImageMapType
ImageMapType(opts)
Parametry:
Tworzy obiekt ImageMapType przy użyciu podanych opcji ImageMapTypeOptions
alt
Typ: string optional
maxZoom
Typ: number
minZoom
Typ: number
name
Typ: string optional
projection
Typ: Projection optional
radius
Typ: number
tileSize
Typ: Size optional
getOpacity
getOpacity()
Parametry: brak
Wartość zwracana: number opacity Bieżąca nieprzezroczystość.
Zwraca poziom nieprzezroczystości (od 0 (przezroczysty) do 1.0) kafelków ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
Parametry:
  • tileCoord: Point optional Współrzędne mapy.
  • zoom: number Powiększenie kafelka.
  • ownerDocument: Document optional Dokument, do którego należy ten kafelek.
Zwracana wartość: Element|null – wynikowy kafelek.
releaseTile
releaseTile(tileDiv)
Parametry:
  • tileDiv: Element optional kafelek do zwolnienia.
Zwracana wartość: brak
setOpacity
setOpacity(opacity)
Parametry:
  • opacity: number Nowa nieprzezroczystość.
Zwracana wartość: brak
Ustawia poziom nieprzezroczystości (od 0 (przezroczysty) do 1.0) kafelków ImageMapType.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
tilesloaded
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy widoczne kafelki zostaną wczytane.

ImageMapTypeOptions interface

Interfejs google.maps.ImageMapTypeOptions

Ta klasa służy do tworzenia obiektu MapType, który renderuje kafelki obrazu.
alt
opcjonalne
Typ: string optional
Tekst alternatywny wyświetlany po najechaniu kursorem na przycisk MapType w MapTypeControl.
getTileUrl
opcjonalne
Typ: function(Point, number): (string optional) optional
Zwraca ciąg znaków (URL) dla podanych współrzędnych mapy (x, y) i poziomu powiększenia.
maxZoom
opcjonalne
Typ: number optional
Maksymalny poziom powiększenia mapy podczas wyświetlania tego typu mapy.
minZoom
opcjonalne
Typ: number optional
Minimalny poziom powiększenia mapy podczas wyświetlania tego typu mapy. Opcjonalnie:
name
opcjonalne
Typ: string optional
Nazwa wyświetlana w MapTypeControl.
opacity
opcjonalne
Typ: number optional
Przezroczystość, która ma zostać zastosowana do kafelków. Przezroczystość powinna być określona jako wartość zmiennoprzecinkowa z zakresu od 0 do 1,0, gdzie 0 oznacza pełną przezroczystość, a 1 – pełną nieprzezroczystość.
tileSize
opcjonalne
Typ: Size optional
Rozmiar kafelka.

Klasa GroundOverlay

google.maps.GroundOverlay class
extends MVCObject
library "maps"

Prostokątny obraz nad powierzchnią mapy.

const {GroundOverlay} = await google.maps.importLibrary("maps");
GroundOverlay
GroundOverlay(url, bounds[, opts])
Parametry:
Tworzy nakładkę naziemną na podstawie podanego adresu URL obrazu i jego LatLngBounds. Obraz jest skalowany tak, aby pasował do bieżących granic, i wyświetlany przy użyciu bieżącego rzutu mapy.
getBounds
getBounds()
Parametry: brak
Wartość zwracana: LatLngBounds|null
Pobiera LatLngBounds tej nakładki.
getMap
getMap()
Parametry: brak
Wartość zwracana: Map|null
Zwraca mapę, na której wyświetlana jest ta nakładka naziemna.
getOpacity
getOpacity()
Parametry: brak
Wartość zwracana: number
Zwraca nieprzezroczystość tej nakładki naziemnej.
getUrl
getUrl()
Parametry: brak
Wartość zwracana: string
Pobiera adres URL wyświetlanego obrazu.
setMap
setMap(map)
Parametry:
  • map: Map optional
Zwracana wartość: brak
Renderuje nakładkę naziemną na określonej mapie. Jeśli mapa jest ustawiona na null, nakładka zostanie usunięta.
setOpacity
setOpacity(opacity)
Parametry:
  • opacity: number
Zwracana wartość: brak
Ustawia przezroczystość tej nakładki naziemnej.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(event)
Argumenty:
To zdarzenie jest wywoływane, gdy zdarzenie kliknięcia DOM jest wywoływane w elemencie GroundOverlay.
dblclick
function(event)
Argumenty:
To zdarzenie jest wywoływane, gdy zdarzenie dblclick DOM jest wywoływane na elemencie GroundOverlay.

Interfejs GroundOverlayOptions

Interfejs google.maps.GroundOverlayOptions

Ten obiekt definiuje właściwości, które można ustawić w obiekcie GroundOverlay.
clickable
opcjonalne
Typ: boolean optional
Jeśli wartość to true, nakładka naziemna może odbierać zdarzenia myszy.
map
opcjonalne
Typ: Map optional
Mapa, na której ma być wyświetlana nakładka.
opacity
opcjonalne
Typ: number optional
Domyślnie: 1.0
Przezroczystość nakładki wyrażona jako liczba z zakresu od 0 do 1. Opcjonalnie:

Klasa StyledMapType

google.maps.StyledMapType class
extends MVCObject
implements MapType
library "maps"

Tworzy MapType ze stylem niestandardowym.

const {StyledMapType} = await google.maps.importLibrary("maps");
StyledMapType
StyledMapType(styles[, options])
Parametry:
Tworzy stylizowany element MapType z określonymi opcjami. Metoda StyledMapType przyjmuje tablicę obiektów MapTypeStyle, które MapTypeStyle są kolejno stosowane do mapy. Późniejszy element MapTypeStyle, który stosuje te same elementy MapTypeStyler do tych samych selektorów co wcześniejszy element MapTypeStyle, zastąpi wcześniejszy element MapTypeStyle.

Pamiętaj, że StyledMapType nie jest obsługiwany, gdy ustawiony jest identyfikator mapy. Jeśli użyjesz obu tych funkcji jednocześnie, otrzymasz ostrzeżenie w konsoli.
alt
Typ: string
maxZoom
Typ: number
minZoom
Typ: number
name
Typ: string
projection
Typ: Projection optional
radius
Typ: number
tileSize
Typ: Size optional
getTile
getTile(tileCoord, zoom, ownerDocument)
Parametry:
  • tileCoord: Point optional Współrzędne mapy.
  • zoom: number Powiększenie kafelka.
  • ownerDocument: Document optional Dokument, do którego należy ten kafelek.
Zwracana wartość: Element|null – wynikowy kafelek.
releaseTile
releaseTile(tile)
Parametry:
  • tile: Element optional kafelek do zwolnienia.
Zwracana wartość: brak
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

StyledMapTypeOptions interface

Interfejs google.maps.StyledMapTypeOptions

Ta klasa służy do określania opcji podczas tworzenia obiektu StyledMapType. Tych opcji nie można zmienić po utworzeniu instancji StyledMapType.
alt
opcjonalne
Typ: string optional
Tekst, który ma się wyświetlać po najechaniu kursorem na przycisk MapType w elemencie sterującym typu mapy.
maxZoom
opcjonalne
Typ: number optional
Maksymalny poziom powiększenia mapy podczas wyświetlania tego elementu: MapType. Opcjonalnie:
minZoom
opcjonalne
Typ: number optional
Minimalny poziom powiększenia mapy podczas wyświetlania tego elementu: MapType. Opcjonalnie:
name
opcjonalne
Typ: string optional
Nazwa wyświetlana w elemencie sterującym typem mapy.