Coordinates

LatLng class

google.maps.LatLng zajęcia

LatLng to punkt o współrzędnych geograficznych: szerokości i długości geograficznej.

  • Szerokość geograficzna mieści się w zakresie 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 mieści się w zakresie od -180 do 180 stopni włącznie. Wartości powyżej lub poniżej tego zakresu zostaną zawinięte, tak aby mieściły się w zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Wynika to z faktu, że długości geograficzne obejmują cały glob.
Chociaż domyślna projekcja mapy wiąże długość geograficzną ze współrzędną x mapy, a szerokość geograficzną ze współrzędną y, współrzędna szerokości geograficznej jest zawsze zapisywana jako pierwsza, a po niej następuje długość geograficzna.
Pamiętaj, że nie możesz modyfikować współrzędnych LatLng. Jeśli chcesz obliczyć inny punkt, musisz utworzyć nowy.

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

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

Konstruktor akceptuje też obiekty LatLngLiteralLatLng. Jeśli do konstruktora zostanie przekazana instancja LatLng, zostanie utworzona jej 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);

Dostęp przez połączenie pod numer const {LatLng} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w Maps JavaScript API.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parametry: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
Tworzy obiekt LatLng reprezentujący punkt geograficzny. Szerokość geograficzna jest określana w stopniach w zakresie [-90, 90]. Długość geograficzna jest określana w stopniach w zakresie [-180, 180). Ustaw wartość noClampNoWrap na true, aby włączyć wartości spoza tego zakresu. Zwróć uwagę na kolejność szerokości i długości geograficznej.
equals
equals(other)
Parametry: 
Zwracana wartość:  boolean
Funkcja porównania.
lat
lat()
Parametry: brak
Zwracana wartość:  number
Zwraca szerokość geograficzną w stopniach.
lng
lng()
Parametry: brak
Zwracana wartość:  number
Zwraca długość geograficzną w stopniach.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  LatLngLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do używania za pomocą JSON.stringify.
toString
toString()
Parametry: brak
Zwracana wartość:  string
Konwertuje na reprezentację w postaci ciągu znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precisionnumber optional
Zwracana wartość:  string
Zwraca ciąg znaków w formacie „lat,lng” dla tego obiektu LatLng. Domyślnie zaokrąglamy wartości szerokości i długości geograficznej do 6 miejsc po przecinku.

LatLngLiteral interfejs

google.maps.LatLngLiteralinterfejs

W wielu miejscach zamiast obiektów LatLng można używać literałów obiektów. Gdy interfejs Maps API napotka te obiekty, zostaną one przekonwertowane na obiekty LatLng.

Przykłady:

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

Literały obiektów LatLng nie są obsługiwane w bibliotece Geometry.

lat
Typ:  number
Szerokość geograficzna w stopniach. Wartości zostaną ograniczone 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] zostaną zawinięte, aby mieściły się w tym zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Wynika to z faktu, że długości geograficzne obejmują cały glob.

LatLngBounds class

google.maps.LatLngBounds zajęcia

Instancja LatLngBounds reprezentuje prostokąt we współrzędnych geograficznych, w tym taki, który przecina południk 180 stopni.

Dostęp przez połączenie pod numer const {LatLngBounds} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w Maps JavaScript API.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametry: 
Tworzy prostokąt na podstawie punktów w południowo-zachodnim i północno-wschodnim rogu.
MAX_BOUNDS LatLngBounds dla maksymalnych granic Ziemi. Te granice obejmują cały świat.
contains
contains(latLng)
Parametry: 
Zwracana wartość:  boolean
Zwraca true, jeśli podane współrzędne geograficzne znajdują się w tym obszarze.
equals
equals(other)
Parametry: 
Zwracana wartość:  boolean
Zwraca true, jeśli te granice są w przybliżeniu równe podanym granicom.
extend
extend(point)
Parametry: 
Zwracana wartość:  LatLngBounds
Rozszerza ten obszar, aby zawierał podany punkt.
getCenter
getCenter()
Parametry: brak
Zwracana wartość:  LatLng
Oblicza środek tego obiektu LatLngBounds.
getNorthEast
getNorthEast()
Parametry: brak
Zwracana wartość:  LatLng
Zwraca północno-wschodni róg tego obszaru.
getSouthWest
getSouthWest()
Parametry: brak
Zwracana wartość:  LatLng
Zwraca południowo-zachodni róg tego obszaru.
intersects
intersects(other)
Parametry: 
Zwracana wartość:  boolean
Zwraca wartość true, jeśli ten zakres ma wspólne punkty z innym zakresem.
isEmpty
isEmpty()
Parametry: brak
Zwracana wartość:  boolean
Zwraca informację o tym, czy granice są puste.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  LatLngBoundsLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do używania za pomocą JSON.stringify.
toSpan
toSpan()
Parametry: brak
Zwracana wartość:  LatLng
Konwertuje podane granice mapy na zakres współrzędnych geograficznych.
toString
toString()
Parametry: brak
Zwracana wartość:  string
Konwertuje na ciąg znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precisionnumber optional
Zwracana wartość:  string
Zwraca ciąg znaków w formacie „lat_lo,lng_lo,lat_hi,lng_hi” dla tych granic, gdzie „lo” odpowiada południowo-zachodniemu rogowi ramki ograniczającej, a „hi” – północno-wschodniemu rogowi tej ramki.
union
union(other)
Parametry: 
Zwracana wartość:  LatLngBounds
Rozszerza te granice, aby obejmowały sumę tych granic i podanych granic.

LatLngBoundsLiteral interfejs

google.maps.LatLngBoundsLiteralinterfejs

W całym interfejsie API zamiast obiektów LatLngBounds można używać literałów obiektów. Są one automatycznie przekształcane w obiekty LatLngBounds. Wszystkie wartości south, west, northeast muszą być ustawione. W przeciwnym razie zostanie zgłoszony wyjątek.

east
Typ:  number
Długość geograficzna wschodnia w stopniach. Wartości spoza zakresu [-180, 180] zostaną przekształcone do zakresu [-180, 180). Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Wynika to z faktu, że długości geograficzne obejmują cały glob.
north
Typ:  number
Szerokość geograficzna północna w stopniach. Wartości zostaną ograniczone 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ą ograniczone 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ą przekształcone do zakresu [-180, 180). Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Wynika to z faktu, że długości geograficzne obejmują cały glob.

LatLngAltitude class

google.maps.LatLngAltitude zajęcia

LatLngAltitude to punkt 3D o współrzędnych geograficznych: szerokości, długości i wysokości nad poziomem morza.

  • Szerokość geograficzna mieści się w zakresie 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 mieści się w zakresie od -180 do 180 stopni włącznie. Wartości powyżej lub poniżej tego zakresu zostaną zawinięte, tak aby mieściły się w zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Wynika to z faktu, że długości geograficzne obejmują cały glob.
  • Wysokość jest mierzona w metrach. Wartości dodatnie oznaczają wysokość nad poziomem gruntu, a ujemne – wysokość pod powierzchnią gruntu.

Ta klasa implementuje interfejs LatLngAltitudeLiteral.

Ta klasa implementuje interfejs LatLngLiteral.

Dostęp przez połączenie pod numer const {LatLngAltitude} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w Maps JavaScript API.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametry: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral wartość inicjująca.
  • noClampNoWrapboolean optional czy zachować wartości inicjujące, nawet jeśli nie muszą to być prawidłowe wartości szerokości geograficznej z zakresu [-90, 90] ani prawidłowe wartości długości geograficznej z zakresu [-180, 180]. Domyślna wartość to false, która włącza ograniczenie szerokości geograficznej i zawijanie 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ść zwracana:  boolean informacja, czy 2 obiekty są równe.
Funkcja porównania.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  LatLngAltitudeLiteral reprezentacja JSON tego obiektu.

LatLngAltitudeLiteral interfejs

google.maps.LatLngAltitudeLiteralinterfejs

W wielu miejscach zamiast obiektów LatLngAltitude można używać literałów obiektów. Gdy interfejs Maps API napotka te obiekty, zostaną one przekonwertowane na obiekty LatLngAltitude.

Ten interfejs rozszerza interfejs LatLngLiteral.

altitude
Typ:  number
Domyślnie: 0
Odległość (w metrach) od powierzchni gruntu. Wartość ujemna oznacza, że obiekt znajduje się pod powierzchnią ziemi.
lat
Typ:  number
Szerokość geograficzna w stopniach. Wartości zostaną ograniczone 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] zostaną zawinięte, aby mieściły się w tym zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Wynika to z faktu, że długości geograficzne obejmują cały glob.

Klasa punktu

google.maps.Point zajęcia

Dostęp przez połączenie pod numer const {Point} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w Maps JavaScript API.

Point
Point(x, y)
Parametry: 
  • xnumber
  • ynumber
Punkt na płaszczyźnie dwuwymiarowej.
x
Typ:  number
Współrzędna X
y
Typ:  number
Współrzędna Y
equals
equals(other)
Parametry: 
  • otherPoint optional
Zwracana wartość:  boolean
Porównuje 2 punkty
toString
toString()
Parametry: brak
Zwracana wartość:  string
Zwraca ciąg znaków reprezentujący ten punkt.

Rozmiar klasa

google.maps.Size zajęcia

Dostęp przez połączenie pod numer const {Size} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w Maps JavaScript API.

Size
Size(width, height[, widthUnit, heightUnit])
Parametry: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
Rozmiar dwuwymiarowy, gdzie szerokość to odległość na osi x, a wysokość to odległość na osi y.
height
Typ:  number
Wysokość wzdłuż osi Y (w pikselach).
width
Typ:  number
Szerokość wzdłuż osi X w pikselach.
equals
equals(other)
Parametry: 
Zwracana wartość:  boolean
Porównuje 2 rozmiary.
toString
toString()
Parametry: brak
Zwracana wartość:  string
Zwraca ciąg znaków reprezentujący ten obiekt Size.

Interfejs Padding

google.maps.Paddinginterfejs

bottom optional
Typ:  number optional
Dopełnienie u dołu w pikselach.
left optional
Typ:  number optional
Dopełnienie z lewej strony w pikselach.
right optional
Typ:  number optional
Dopełnienie z prawej strony w pikselach.
top optional
Typ:  number optional
Dopełnienie u góry w pikselach.

CircleLiteral interfejs

google.maps.CircleLiteralinterfejs

Literał obiektu reprezentujący okrąg.

Ten interfejs rozszerza interfejs CircleOptions.

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

Orientation3D class

google.maps.Orientation3D zajęcia

Orientation3D to trójwymiarowy wektor używany do standardowych matematycznych przekształceń rotacyjnych wzdłuż kierunku, nachylenia i przechylenia.

  • Kierunek to kąt z zakresu [0, 360) stopni.
  • tilt to kąt z zakresu [0, 360) stopni.
  • roll to kąt z zakresu [0, 360) stopni.

Ta klasa implementuje interfejs Orientation3DLiteral.

Dostęp przez połączenie pod numer const {Orientation3D} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w Maps JavaScript API.

Orientation3D
Orientation3D(value)
Parametry: 
heading
Typ:  number
Domyślnie: 0
Obrót wokół osi z (prostopadłej do powierzchni Ziemi). Wartość 0 (domyślna) oznacza północ. Dodatni obrót jest wykonywany w kierunku zgodnym z ruchem wskazówek zegara wokół osi Z i jest określany w stopniach w zakresie od 0 do 360. Wartości powyżej lub poniżej tego zakresu zostaną zawinięte, tak aby mieściły się w zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 530 również zostanie przekonwertowana na 170.
roll
Typ:  number
Domyślnie: 0
Obrót wokół osi Y. Dodatni obrót jest wykonywany w kierunku zgodnym z ruchem wskazówek zegara wokół osi Y i jest określany w stopniach w zakresie od 0 do 360. Wartości powyżej lub poniżej tego zakresu zostaną zawinięte, tak aby mieściły się w zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 530 również zostanie przekonwertowana na 170.
tilt
Typ:  number
Domyślnie: 0
Obrót wokół osi X. Dodatni obrót jest wykonywany w kierunku zgodnym z ruchem wskazówek zegara wokół osi X i jest określany w stopniach w zakresie od 0 do 360. Wartości powyżej lub poniżej tego zakresu zostaną zawinięte, tak aby mieściły się w zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 530 również zostanie przekonwertowana na 170.
equals
equals(other)
Parametry: 
Wartość zwracana:  boolean informacja, czy 2 obiekty są równe.
Funkcja porównania.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  Orientation3DLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do używania za pomocą JSON.stringify.

Orientation3DLiteral interfejs

google.maps.Orientation3DLiteralinterfejs

W wielu miejscach zamiast obiektów Orientation3D można używać literałów obiektów. Gdy interfejs Maps API napotka te obiekty, zostaną one przekonwertowane na obiekty Orientation3D.

heading optional
Typ:  number optional
Obrót wokół osi z (prostopadłej do powierzchni Ziemi). Wartość 0 (domyślna) oznacza północ. Dodatni obrót jest wykonywany w kierunku zgodnym z ruchem wskazówek zegara wokół osi Z i jest określany w stopniach w zakresie od 0 do 360.
roll optional
Typ:  number optional
Obrót wokół osi Y. Dodatni obrót jest wykonywany w kierunku zgodnym z ruchem wskazówek zegara wokół osi Y i jest określany w stopniach w zakresie od 0 do 360.
tilt optional
Typ:  number optional
Obrót wokół osi X. Dodatni obrót jest wykonywany w kierunku zgodnym z ruchem wskazówek zegara wokół osi X i jest określany w stopniach w zakresie od 0 do 360.

Vector3D class

google.maps.Vector3D zajęcia

Vector3D to trójwymiarowy wektor używany do standardowych operacji matematycznych, takich jak skalowanie granic obiektu trójwymiarowego wzdłuż lokalnych osi X, Y i Z.

  • x jest liczbą rzeczywistą.
  • y jest liczbą rzeczywistą.
  • z jest liczbą rzeczywistą.

Ta klasa implementuje interfejs Vector3DLiteral.

Dostęp przez połączenie pod numer const {Vector3D} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w Maps JavaScript API.

Vector3D
Vector3D(value)
Parametry: 
x
Typ:  number
Składowa X wektora trójwymiarowego.
y
Typ:  number
Składowa Y wektora trójwymiarowego.
z
Typ:  number
Składnik Z wektora trójwymiarowego.
equals
equals(other)
Parametry: 
Zwracana wartość:  boolean
Funkcja porównania.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  Vector3DLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do używania za pomocą JSON.stringify.

Vector3DLiteral interface

google.maps.Vector3DLiteralinterfejs

W wielu miejscach zamiast obiektów Vector3D można używać literałów obiektów. Gdy interfejs Maps API napotka te obiekty, zostaną one przekonwertowane na obiekty Vector3D.

x
Typ:  number
Składowa X wektora trójwymiarowego.
y
Typ:  number
Składowa Y wektora trójwymiarowego.
z
Typ:  number
Składnik Z wektora trójwymiarowego.