Coordinates

Klasa LatLng

google.maps.LatLng zajęcia

LatLng to punkt we współrzędnych geograficznych: szerokość i długość geograficzna.

  • Szerokość geograficzna mieści się w zakresie od –90 do 90 stopni. Wartości spoza tego zakresu są zmieniane na wartości graniczne [-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. Wartości spoza tego zakresu są zmieniane tak, aby mieściły się w nim. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.
Chociaż domyślne odwzorowanie mapy wiąże długość geograficzną ze współrzędną X, a szerokość geograficzną ze współrzędną Y, szerokość geograficzna jest zawsze zapisywana jako pierwsza, a po niej długość geograficzna.
Zauważ, że nie możesz zmienić współrzędnych elementu 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 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.

Poniżej znajdziesz 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);

Aby uzyskać dostęp, zadzwoń pod numer const {LatLng} = await google.maps.importLibrary("core").
Zobacz Biblioteki w 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 podawana w stopniach w zakresie [-90, 90]. Długość geograficzna jest podawana w stopniach w zakresie [-180, 180). Aby włączyć wartości spoza tego zakresu, ustaw noClampNoWrap na true. Zwróć uwagę na kolejność szerokości i długości geograficznej.
equals
equals(other)
Parametry: 
Wartość zwracana:  boolean
Funkcja porównania.
lat
lat()
Parametry: brak
Wartość zwracana:  number
Zwraca szerokość geograficzną w stopniach.
lng
lng()
Parametry: brak
Wartość zwracana:  number
Zwraca długość geograficzną w stopniach.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  LatLngLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do używania w ramach JSON.stringify.
toString
toString()
Parametry: brak
Wartość zwracana:  string
Konwertuje na ciąg znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precision:  number optional
Wartość zwracana:  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.

Interfejs LatLngLiteral

Interfejs google.maps.LatLngLiteral

W wielu miejscach zamiast obiektów LatLng akceptowane są literały obiektów. Gdy interfejs API Map Google 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. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.

Klasa LatLngBounds

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.

Aby uzyskać dostęp, zadzwoń 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 jego południowo-zachodnim i północno-wschodnim rogu.
MAX_BOUNDS LatLngBounds dla maksymalnych granic Ziemi. Te granice obejmują całą kulę ziemską.
contains
contains(latLng)
Parametry: 
Wartość zwracana:  boolean
Zwraca true, jeśli podana szerokość/długość geograficzna mieści się w tych granicach.
equals
equals(other)
Parametry: 
Wartość zwracana:  boolean
Zwraca true, jeśli te granice są w przybliżeniu równe podanym granicom.
extend
extend(point)
Parametry: 
Wartość zwracana:  LatLngBounds
Rozszerza te granice, aby zawierały dany punkt.
getCenter
getCenter()
Parametry: brak
Wartość zwracana:  LatLng
Oblicza środek tego obiektu LatLngBounds
getNorthEast
getNorthEast()
Parametry: brak
Wartość zwracana:  LatLng
Zwraca północno-wschodni róg tych granic.
getSouthWest
getSouthWest()
Parametry: brak
Wartość zwracana:  LatLng
Zwraca południowo-zachodni róg tych granic.
intersects
intersects(other)
Parametry: 
Wartość zwracana:  boolean
Zwraca true, jeśli te granice mają wspólne punkty z innymi granicami.
isEmpty
isEmpty()
Parametry: brak
Wartość zwracana:  boolean
Zwraca informację o tym, czy granice są puste.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  LatLngBoundsLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do używania w ramach JSON.stringify.
toSpan
toSpan()
Parametry: brak
Wartość zwracana:  LatLng
Konwertuje podane granice mapy na zakres szerokości i długości geograficznej.
toString
toString()
Parametry: brak
Wartość zwracana:  string
Konwertuje na ciąg znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precision:  number optional
Wartość zwracana:  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 narożnikowi ramki ograniczającej, a „hi” – północno-wschodniemu.
union
union(other)
Parametry: 
Wartość zwracana:  LatLngBounds
Rozszerza te granice, aby zawierały sumę tych i podanych granic.

Interfejs LatLngBoundsLiteral

Interfejs google.maps.LatLngBoundsLiteral

W całym interfejsie API literały obiektów są akceptowane zamiast obiektów LatLngBounds. Są one automatycznie konwertowane na obiekty LatLngBounds. Wszystkie parametry south, west, north i east 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ą zawinięte do zakresu [-180, 180). Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.
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ą zawinięte do zakresu [-180, 180). Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.

Klasa LatLngAltitude

google.maps.LatLngAltitude zajęcia

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

  • Szerokość geograficzna mieści się w zakresie od –90 do 90 stopni. Wartości spoza tego zakresu są zmieniane na wartości graniczne [-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. Wartości spoza tego zakresu są zmieniane tak, aby mieściły się w nim. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.
  • Wysokość jest mierzona w metrach. Wartości dodatnie oznaczają wysokości nad poziomem gruntu, a wartości ujemne – wysokości pod powierzchnią gruntu.

Ta klasa implementuje interfejs LatLngAltitudeLiteral.

Ta klasa implementuje interfejs LatLngLiteral.

Aby uzyskać dostęp, zadzwoń pod numer const {LatLngAltitude} = await google.maps.importLibrary("core").
Zobacz Biblioteki w Maps JavaScript API.
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametry: 
  • value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Wartość inicjująca.
  • noClampNoWrap:  boolean optional określa, czy zachować wartości inicjalizacji, nawet jeśli nie muszą być prawidłowymi wartościami szerokości geograficznej w zakresie [-90, 90] ani prawidłowymi wartościami długości geograficznej w zakresie [-180, 180]. Wartość domyślna to false, co umożliwia 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: 
Zwracana wartość:  boolean informacja o tym, czy 2 obiekty są równe.
Funkcja porównania.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  LatLngAltitudeLiteral reprezentacja tego obiektu w formacie JSON.

Interfejs LatLngAltitudeLiteral

Interfejs google.maps.LatLngAltitudeLiteral

W wielu miejscach zamiast obiektów LatLngAltitude akceptowane są literały obiektów. Gdy interfejs API Map Google napotka te obiekty, zostaną one przekonwertowane na obiekty LatLngAltitude.

Ten interfejs rozszerza LatLngLiteral.

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. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.
altitude optional
Typ:  number optional
Domyślnie: 0
Odległość (w metrach) nad powierzchnią gruntu. Wartość ujemna oznacza, że punkt znajduje się pod powierzchnią ziemi.

Klasa Point

google.maps.Point zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {Point} = await google.maps.importLibrary("core").
Zobacz Biblioteki w 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: 
  • other:  Point optional
Wartość zwracana:  boolean
Porównuje 2 punkty
toString
toString()
Parametry: brak
Wartość zwracana:  string
Zwraca ciąg znaków reprezentujący ten punkt.

Size class

google.maps.Size zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {Size} = await google.maps.importLibrary("core").
Zobacz Biblioteki w Maps JavaScript API.
Size
Size(width, height[, widthUnit, heightUnit])
Parametry: 
  • width:  number
  • height:  number
  • widthUnit:  string optional
  • heightUnit:  string 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: 
  • other:  Size optional
Wartość zwracana:  boolean
Porównuje 2 rozmiary.
toString
toString()
Parametry: brak
Wartość zwracana:  string
Zwraca ciąg znaków reprezentujący ten rozmiar.

Interfejs Padding

Interfejs google.maps.Padding

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 interface

Interfejs google.maps.CircleLiteral

Literał obiektu reprezentujący okrąg.

Ten interfejs rozszerza 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

Klasa Orientation3D

google.maps.Orientation3D zajęcia

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

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

Ta klasa implementuje interfejs Orientation3DLiteral.

Aby uzyskać dostęp, zadzwoń 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. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi Z i jest określany w stopniach od 0 do 360. Wartości spoza tego zakresu są zmieniane tak, aby mieściły się w nim. 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. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi Y i jest określany w stopniach od 0 do 360. Wartości spoza tego zakresu są zmieniane tak, aby mieściły się w nim. 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. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi X i jest określany w stopniach od 0 do 360. Wartości spoza tego zakresu są zmieniane tak, aby mieściły się w nim. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 530 również zostanie przekonwertowana na 170.
equals
equals(other)
Parametry: 
Zwracana wartość:  boolean informacja o tym, czy 2 obiekty są równe.
Funkcja porównania.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  Orientation3DLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do użycia za pomocą JSON.stringify.

Interfejs Orientation3DLiteral

Interfejs google.maps.Orientation3DLiteral

W wielu miejscach zamiast obiektów Orientation3D akceptowane są literały obiektów. Gdy interfejs API Map Google 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. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi Z i jest określany w stopniach od 0 do 360.
roll optional
Typ:  number optional
Obrót wokół osi Y. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi Y i jest określany w stopniach od 0 do 360.
tilt optional
Typ:  number optional
Obrót wokół osi X. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi X i jest określany w stopniach od 0 do 360.

Klasa Vector3D

google.maps.Vector3D zajęcia

Vector3D to trójwymiarowy wektor używany do standardowych operacji matematycznych, takich jak skalowanie granic trójwymiarowego obiektu 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.

Aby uzyskać dostęp, zadzwoń 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ładowa Z wektora trójwymiarowego.
equals
equals(other)
Parametry: 
Wartość zwracana:  boolean
Funkcja porównania.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  Vector3DLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do użycia za pomocą JSON.stringify.

Interfejs Vector3DLiteral

Interfejs google.maps.Vector3DLiteral

W wielu miejscach zamiast obiektów Vector3D akceptowane są literały obiektów. Gdy interfejs API Map Google 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ładowa Z wektora trójwymiarowego.