Coordinates

Klasa LatLng

Klasa google.maps.LatLng

LatLng jest punktem we współrzędnych geograficznych: szerokości i długości geograficznej.

  • Szerokość geograficzna może wynosić od -90 do 90 stopni (włącznie). Wartości powyżej lub poniżej tego zakresu są ograniczane do zakresu [-90, 90]. Oznacza to, że jeśli podana wartość jest mniejsza niż -90, zostanie ustawiona na -90. Jeśli wartość jest większa niż 90, zostanie ustawiona na 90.
  • Długość geograficzna może wynosić od -180 do 180 stopni (włącznie). Wartości powyżej lub poniżej tego zakresu zostaną spakowane, aby mieściły się w danym zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.
Mimo że domyślna odwzorowanie mapy wiąże się z długością geograficzną określoną na osi x, a szerokość geograficzną ze współrzędną y – szerokość geograficzna jest zawsze zapisywana najpierw jako pierwszy, a po niej długość.
Zwróć uwagę, że nie można modyfikować współrzędnych elementu LatLng. Jeśli chcesz obliczyć inny punkt, musisz utworzyć nowy.

Większość metod akceptujących obiekty LatLng akceptuje też obiekt LatLngLiteral, więc te metody są równoważne: 

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151});

Konstruktor akceptuje też obiekty LatLngLiteral i LatLng. Jeśli do konstruktora zostanie przekazana instancja LatLng, zostanie utworzona kopia.

Możliwe wywołania konstruktora: 

 new google.maps.LatLng(-34, 151);
 new google.maps.LatLng(-34, 151, true);
 new google.maps.LatLng({lat: -34, lng: 151});
 new google.maps.LatLng({lat: -34, lng: 151}, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);

Zadzwoń pod numer const {LatLng} = await google.maps.importLibrary("core"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parametry: 
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean optional
Tworzy obiekt LatLng reprezentujący punkt geograficzny. Szerokość geograficzna jest określona w stopniach [-90, 90]. Długość geograficzna jest określona w stopniach ([-180, 180). Aby włączyć wartości spoza tego zakresu, ustaw noClampNoWrap na true. Zwróć uwagę na porządkowanie szerokości i długości geograficznej.
equals
equals(other)
Parametry: 
Wartość zwrotu:  boolean
Funkcja porównywania.
lat
lat()
Parametry: brak
Wartość zwrotu:  number
Zwraca szerokość geograficzną w stopniach.
lng
lng()
Parametry: brak
Wartość zwrotu:  number
Zwraca długość geograficzną w stopniach.
toJSON
toJSON()
Parametry: brak
Wartość zwrotu:  LatLngLiteral
Konwertuje na format JSON. Tej funkcji należy używać w usłudze JSON.stringify.
toString
toString()
Parametry: brak
Wartość zwrotu:  string
Konwertuje na reprezentację ciągu.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precision:  number optional
Wartość zwrotu:  string
Zwraca ciąg znaków „lat,lng” w przypadku tego formatu LatLng. Domyślnie zaokrąglamy wartości długości i szerokości geograficznej do 6 miejsc po przecinku.

Interfejs LatLngLiteral

google.maps.LatLngLiteral interfejs

W wielu miejscach dosłowne nazwy obiektów są uznawane za obiekty LatLng. Gdy interfejs API Map Google je natrafi na obiekty LatLng,

Przykłady: 

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

Litery obiektu LatLng nie są obsługiwane w bibliotece Geometry.
lat
Typ:  number
Szerokość geograficzna w stopniach. Wartości zostaną zmniejszone do zakresu [-90, 90]. Oznacza to, że jeśli podana wartość jest mniejsza niż -90, zostanie ustawiona na -90. Jeśli wartość jest większa niż 90, zostanie ustawiona na 90.
lng
Typ:  number
Długość geograficzna w stopniach. Wartości spoza zakresu [-180, 180] są spakowane, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.

Klasa LatLngBound

Klasa google.maps.LatLngBounds

Instancja LatLngBounds reprezentuje prostokąt ze współrzędnymi geograficznymi, w tym takim, który przecina południową długość południową o 180 stopni.

Zadzwoń pod numer const {LatLngBounds} = await google.maps.importLibrary("core"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametry: 
Konstruuje prostokąt z punktów na jego wschodnim i wschodnim rogu.
contains
contains(latLng)
Parametry: 
Wartość zwrotu:  boolean
Zwraca wartość true, jeśli podana szerokość i długość geograficzna mieści się w tym zakresie.
equals
equals(other)
Parametry: 
Wartość zwrotu:  boolean
Zwraca wartość true, jeśli wartość graniczna jest równa danym granicom.
extend
extend(point)
Parametry: 
Wartość zwrotu:  LatLngBounds
Rozszerza te granice, podając odpowiedni punkt.
getCenter
getCenter()
Parametry: brak
Wartość zwrotu:  LatLng
Oblicza środek tego LatLngBounds
getNorthEast
getNorthEast()
Parametry: brak
Wartość zwrotu:  LatLng
Zwraca północno-wschodni róg tego obszaru.
getSouthWest
getSouthWest()
Parametry: brak
Wartość zwrotu:  LatLng
Zwraca południowo-zachodni zachód tego granicy.
intersects
intersects(other)
Parametry: 
Wartość zwrotu:  boolean
Zwraca wartość true, jeśli ta granica dzieli punkty z drugą granicą.
isEmpty
isEmpty()
Parametry: brak
Wartość zwrotu:  boolean
Zwraca, jeśli granice są puste.
toJSON
toJSON()
Parametry: brak
Wartość zwrotu:  LatLngBoundsLiteral
Konwertuje na format JSON. Tej funkcji należy używać w usłudze JSON.stringify.
toSpan
toSpan()
Parametry: brak
Wartość zwrotu:  LatLng
Konwertuje granicę mapy na szerokość i długość geograficzną.
toString
toString()
Parametry: brak
Wartość zwrotu:  string
Konwertuje na ciąg znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precision:  number optional
Wartość zwrotu:  string
Zwraca w tym granicach ciąg w postaci „lat_lo,lng_lo,lat_hi,lng_hi”, gdzie „lo” odpowiada południowo-zachodnim narożnikowi ramki ograniczającej, a „hi” odpowiada północno-wschodnim rogu tego pola.
union
union(other)
Parametry: 
Wartość zwrotu:  LatLngBounds
Rozszerza te granice, tak aby obejmowały sumę wartości określonych i podanych.
MAX_BOUNDS Szerokość geograficzna – maksymalna granica Ziemi. Te granice obejmują całą kulę ziemską.

Interfejs LatLngBoundsLiteral

google.maps.LatLngBoundsLiteral interfejs

Litery obiektów są akceptowane w miejsce obiektów LatLngBounds w całym interfejsie API. Są one automatycznie konwertowane na obiekty LatLngBounds. Należy ustawić wszystkie south, west, north i east. W przeciwnym razie zostanie zgłoszony wyjątek.
east
Typ:  number
Długość geograficzna wschodnia w stopniach. Wartości spoza zakresu [-180, 180] zostaną ujęte w zakres [-180, 180]. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.
north
Typ:  number
Szerokość geograficzna północna w stopniach. Wartości zostaną zmniejszone do zakresu [-90, 90]. Oznacza to, że jeśli podana wartość jest mniejsza niż -90, zostanie ustawiona na -90. Jeśli wartość jest większa niż 90, zostanie ustawiona na 90.
south
Typ:  number
Szerokość geograficzna południowa w stopniach. Wartości zostaną zmniejszone do zakresu [-90, 90]. Oznacza to, że jeśli podana wartość jest mniejsza niż -90, zostanie ustawiona na -90. Jeśli wartość jest większa niż 90, zostanie ustawiona na 90.
west
Typ:  number
Długość geograficzna zachodnia w stopniach. Wartości spoza zakresu [-180, 180] zostaną ujęte w zakres [-180, 180]. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.

zajęcia LatLngAltitude

Klasa google.maps.LatLngAltitude

LatLngAltitude to punkt 3D we współrzędnych geograficznych: szerokości i długości geograficznej oraz wysokości.

  • Szerokość geograficzna może wynosić od -90 do 90 stopni (włącznie). Wartości powyżej lub poniżej tego zakresu są ograniczane do zakresu [-90, 90]. Oznacza to, że jeśli podana wartość jest mniejsza niż -90, zostanie ustawiona na -90. Jeśli wartość jest większa niż 90, zostanie ustawiona na 90.
  • Długość geograficzna może wynosić od -180 do 180 stopni (włącznie). Wartości powyżej lub poniżej tego zakresu zostaną spakowane, aby mieściły się w danym zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.
  • Wysokość jest mierzona w metrach. Wartości dodatnie oznaczają wysokość powyżej poziomu gruntu, a ujemne – wysokość pod powierzchnią gruntu.

Te zajęcia implementują LatLngAltitudeLiteral.

Te zajęcia implementują LatLngLiteral.

Zadzwoń pod numer const {LatLngAltitude} = await google.maps.importLibrary("core"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametry: 
  • value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Wartość inicjująca.
  • noClampNoWrap:  boolean optional to, czy chcesz zachować wartości inicjowania, nawet jeśli nie są to prawidłowe wartości szerokości geograficznej [-90, 90] czy wartości długości geograficznej w zakresie [-180, 180]. Domyślne ustawienie to false – ograniczanie szerokości i długości geograficznej.
altitude
Typ:  number
Zwraca wysokość.
lat
Typ:  number
Zwraca szerokość geograficzną.
lng
Typ:  number
Zwraca długość geograficzną.
equals
equals(other)
Parametry: 
Wartość zwrotu:  boolean czy oba obiekty są równe.
Funkcja porównywania.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  LatLngAltitudeLiteral reprezentacja tego obiektu w formacie JSON.

Interfejs LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interfejs

W wielu miejscach dosłowne nazwy obiektów są uznawane za obiekty LatLngAltitude. Gdy interfejs API Map Google je natrafi na obiekty LatLngAltitude,

Ten interfejs jest rozszerzany do LatLngLiteral.

altitude
Typ:  number
Domyślne: 0
Odległość (w metrach) od powierzchni ziemi. Wartość ujemna oznacza obszar pod ziemią.
lat
Typ:  number
Szerokość geograficzna w stopniach. Wartości zostaną zmniejszone do zakresu [-90, 90]. Oznacza to, że jeśli podana wartość jest mniejsza niż -90, zostanie ustawiona na -90. Jeśli wartość jest większa niż 90, zostanie ustawiona na 90.
lng
Typ:  number
Długość geograficzna w stopniach. Wartości spoza zakresu [-180, 180] są spakowane, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.

Klasa Point

Klasa google.maps.Point

Zadzwoń pod numer const {Point} = await google.maps.importLibrary("core"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Point
Point(x, y)
Parametry: 
  • x:  number
  • y:  number
Punkt na płaszczyźnie dwuwymiarowej
x
Typ:  number
Współrzędna X
y
Typ:  number
Współrzędna Y
equals
equals(other)
Parametry: 
Wartość zwrotu:  boolean
Porównaj dwa punkty
toString
toString()
Parametry: brak
Wartość zwrotu:  string
Zwraca ciąg znaków reprezentujący ten punkt.

Klasa Size

Klasa google.maps.Size

Zadzwoń pod numer const {Size} = await google.maps.importLibrary("core"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Size
Size(width, height[, widthUnit, heightUnit])
Parametry: 
  • width:  number
  • height:  number
  • widthUnit:  string optional
  • heightUnit:  string optional
Rozmiar dwuwymiarowy – szerokość na osi X, a wysokość na osi Y.
height
Typ:  number
Wysokość na osi Y w pikselach.
width
Typ:  number
Szerokość na osi X wyrażona w pikselach.
equals
equals(other)
Parametry: 
Wartość zwrotu:  boolean
Porównanie 2 rozmiarów.
toString
toString()
Parametry: brak
Wartość zwrotu:  string
Zwraca ciąg znaków o tym rozmiarze.

Dopełnienie

google.maps.Padding interfejs

bottom optional
Typ:  number optional
Dopełnienie na dole w pikselach.
left optional
Typ:  number optional
Dopełnienie po lewej w pikselach.
right optional
Typ:  number optional
Dopełnienie po prawej w pikselach.
top optional
Typ:  number optional
Dopełnienie górnej części (w pikselach).

Interfejs CircleLiteral

google.maps.CircleLiteral interfejs

Literał obiektu reprezentujący okrąg.

Ten interfejs jest rozszerzany do CircleOptions.

center
W centrum okręgu.
radius
Typ:  number
Promień w metrach na powierzchni Ziemi.
Dziedziczone: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex