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.
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 LatLngLiteral
i LatLng
. 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.
Zespół | |
---|---|
LatLng |
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) Parametry:
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. |
Metody | |
---|---|
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:
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.LatLngLiteral
interfejs
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.
Właściwości | |
---|---|
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.
Zespół | |
---|---|
LatLngBounds |
LatLngBounds([swOrLatLngBounds, ne]) Parametry:
Tworzy prostokąt na podstawie punktów w południowo-zachodnim i północno-wschodnim rogu. |
Stałe | |
---|---|
MAX_BOUNDS |
LatLngBounds dla maksymalnych granic Ziemi. Te granice obejmują cały świat. |
Metody | |
---|---|
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:
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.LatLngBoundsLiteral
interfejs
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
, north
i east
muszą być ustawione. W przeciwnym razie zostanie zgłoszony wyjątek.
Właściwości | |
---|---|
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.
Zespół | |
---|---|
LatLngAltitude |
LatLngAltitude(value[, noClampNoWrap]) Parametry:
|
Właściwości | |
---|---|
altitude |
Typ:
number Zwraca wysokość. |
lat |
Typ:
number Zwraca szerokość geograficzną. |
lng |
Typ:
number Zwraca długość geograficzną. |
Metody | |
---|---|
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.LatLngAltitudeLiteral
interfejs
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
.
Właściwości | |
---|---|
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.
Zespół | |
---|---|
Point |
Point(x, y) Parametry:
Punkt na płaszczyźnie dwuwymiarowej. |
Właściwości | |
---|---|
x |
Typ:
number Współrzędna X |
y |
Typ:
number Współrzędna Y |
Metody | |
---|---|
equals |
equals(other) Parametry:
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.
Zespół | |
---|---|
Size |
Size(width, height[, widthUnit, heightUnit]) Parametry:
Rozmiar dwuwymiarowy, gdzie szerokość to odległość na osi x, a wysokość to odległość na osi y. |
Właściwości | |
---|---|
height |
Typ:
number Wysokość wzdłuż osi Y (w pikselach). |
width |
Typ:
number Szerokość wzdłuż osi X w pikselach. |
Metody | |
---|---|
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.Padding
interfejs
Właściwości | |
---|---|
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.CircleLiteral
interfejs
Literał obiektu reprezentujący okrąg.
Ten interfejs rozszerza interfejs CircleOptions
.
Właściwości | |
---|---|
center |
Typ:
LatLng|LatLngLiteral ś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.
Zespół | |
---|---|
Orientation3D |
Orientation3D(value) Parametry:
|
Właściwości | |
---|---|
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. |
Metody | |
---|---|
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.Orientation3DLiteral
interfejs
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
.
Właściwości | |
---|---|
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.
Zespół | |
---|---|
Vector3D |
Vector3D(value) Parametry:
|
Właściwości | |
---|---|
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. |
Metody | |
---|---|
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.Vector3DLiteral
interfejs
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
.
Właściwości | |
---|---|
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. |