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ść:
booleanFunkcja porównania. |
lat |
lat()Parametry: brak
Zwracana wartość:
numberZwraca szerokość geograficzną w stopniach. |
lng |
lng()Parametry: brak
Zwracana wartość:
numberZwraca długość geograficzną w stopniach. |
toJSON |
toJSON()Parametry: brak
Zwracana wartość:
LatLngLiteralKonwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do używania za pomocą JSON.stringify. |
toString |
toString()Parametry: brak
Zwracana wartość:
stringKonwertuje na reprezentację w postaci ciągu znaków. |
toUrlValue |
toUrlValue([precision])Parametry:
Zwracana wartość:
stringZwraca 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.
Właściwości | |
|---|---|
lat |
Typ:
numberSzerokość 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:
numberDł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ść:
booleanZwraca true, jeśli podane współrzędne geograficzne znajdują się w tym obszarze. |
equals |
equals(other)Parametry:
Zwracana wartość:
booleanZwraca true, jeśli te granice są w przybliżeniu równe podanym granicom. |
extend |
extend(point)Parametry:
Zwracana wartość:
LatLngBoundsRozszerza ten obszar, aby zawierał podany punkt. |
getCenter |
getCenter()Parametry: brak
Zwracana wartość:
LatLngOblicza środek tego obiektu LatLngBounds. |
getNorthEast |
getNorthEast()Parametry: brak
Zwracana wartość:
LatLngZwraca północno-wschodni róg tego obszaru. |
getSouthWest |
getSouthWest()Parametry: brak
Zwracana wartość:
LatLngZwraca południowo-zachodni róg tego obszaru. |
intersects |
intersects(other)Parametry:
Zwracana wartość:
booleanZwraca wartość true, jeśli ten zakres ma wspólne punkty z innym zakresem. |
isEmpty |
isEmpty()Parametry: brak
Zwracana wartość:
booleanZwraca informację o tym, czy granice są puste. |
toJSON |
toJSON()Parametry: brak
Zwracana wartość:
LatLngBoundsLiteralKonwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do używania za pomocą JSON.stringify. |
toSpan |
toSpan()Parametry: brak
Zwracana wartość:
LatLngKonwertuje podane granice mapy na zakres współrzędnych geograficznych. |
toString |
toString()Parametry: brak
Zwracana wartość:
stringKonwertuje na ciąg znaków. |
toUrlValue |
toUrlValue([precision])Parametry:
Zwracana wartość:
stringZwraca 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ść:
LatLngBoundsRozszerza 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, north i east muszą być ustawione. W przeciwnym razie zostanie zgłoszony wyjątek.
Właściwości | |
|---|---|
east |
Typ:
numberDł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:
numberSzerokość 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:
numberSzerokość 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:
numberDł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:
numberZwraca wysokość. |
lat |
Typ:
numberZwraca szerokość geograficzną. |
lng |
Typ:
numberZwraca 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.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.
Właściwości | |
|---|---|
altitude |
Typ:
numberDomyślnie:
0Odległość (w metrach) od powierzchni gruntu. Wartość ujemna oznacza, że obiekt znajduje się pod powierzchnią ziemi. |
lat |
Typ:
numberSzerokość 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:
numberDł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:
numberWspółrzędna X |
y |
Typ:
numberWspółrzędna Y |
Metody | |
|---|---|
equals |
equals(other)Parametry:
Zwracana wartość:
booleanPorównuje 2 punkty |
toString |
toString()Parametry: brak
Zwracana wartość:
stringZwraca 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:
numberWysokość wzdłuż osi Y (w pikselach). |
width |
Typ:
numberSzerokość wzdłuż osi X w pikselach. |
Metody | |
|---|---|
equals |
equals(other)Parametry:
Zwracana wartość:
booleanPorównuje 2 rozmiary. |
toString |
toString()Parametry: brak
Zwracana wartość:
stringZwraca ciąg znaków reprezentujący ten obiekt Size. |
Interfejs Padding
google.maps.Paddinginterfejs
Właściwości | |
|---|---|
bottom optional |
Typ:
number optionalDopełnienie u dołu w pikselach. |
left optional |
Typ:
number optionalDopełnienie z lewej strony w pikselach. |
right optional |
Typ:
number optionalDopełnienie z prawej strony w pikselach. |
top optional |
Typ:
number optionalDopełnienie u góry w pikselach. |
CircleLiteral interfejs
google.maps.CircleLiteralinterfejs
Literał obiektu reprezentujący okrąg.
Ten interfejs rozszerza interfejs CircleOptions.
Właściwości | |
|---|---|
center |
Typ:
LatLng|LatLngLiteralśrodek okręgu, |
radius |
Typ:
numberPromień 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:
numberDomyślnie:
0Obró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:
numberDomyślnie:
0Obró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:
numberDomyślnie:
0Obró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ść:
Orientation3DLiteralKonwertuje 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.
Właściwości | |
|---|---|
heading optional |
Typ:
number optionalObró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 optionalObró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 optionalObró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:
numberSkładowa X wektora trójwymiarowego. |
y |
Typ:
numberSkładowa Y wektora trójwymiarowego. |
z |
Typ:
numberSkładnik Z wektora trójwymiarowego. |
Metody | |
|---|---|
equals |
equals(other)Parametry:
Zwracana wartość:
booleanFunkcja porównania. |
toJSON |
toJSON()Parametry: brak
Zwracana wartość:
Vector3DLiteralKonwertuje 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.
Właściwości | |
|---|---|
x |
Typ:
numberSkładowa X wektora trójwymiarowego. |
y |
Typ:
numberSkładowa Y wektora trójwymiarowego. |
z |
Typ:
numberSkładnik Z wektora trójwymiarowego. |