Klasa LatLng
google.maps.LatLng
zajęcia
LatLng
to punkt we współrzędnych geograficznych: szerokość i długość geograficzna.
- Szerokość geograficzna 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 określona wartość jest mniejsza niż -90, zostanie ustawiona na -90. Jeśli wartość jest większa niż 90, zostanie ustawiona na 90.
- Długość geograficzna to zakres od -180 do 180 stopni włącznie. Wartości powyżej lub poniżej tego zakresu będą zawijane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie zamieniona na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długość geograficzna otacza kulę ziemską.
Zwróć uwagę, że nie można zmieniać współrzędnych obiektu
LatLng
. Jeśli chcesz obliczyć kolejny punkt, musisz utworzyć nowy. Większość metod, które akceptują obiekty LatLng
, akceptuje też obiekt LatLngLiteral
, więc poniższe 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 przekazane wystąpienie LatLng
, zostanie utworzona jego 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);
Uzyskaj dostęp, dzwoniąc pod numer const {LatLng} = await google.maps.importLibrary("core")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
LatLng |
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) Parametry:
Tworzy obiekt LatLng reprezentujący punkt geograficzny. Szerokość geograficzna jest podawana w stopniach w zakresie [-90, 90]. Długość geograficzna jest podawana w stopniach z zakresu [-180, 180). Ustaw 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ównywania. |
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 powinna być używana za pośrednictwem JSON.stringify . |
toString |
toString() Parametry: brak
Zwracana wartość:
string Przekształca na reprezentację ciągu znaków. |
toUrlValue |
toUrlValue([precision]) Parametry:
Zwracana wartość:
string Zwraca ciąg znaków w postaci „lat,lng” dla tej lokalizacji. Domyślnie zaokrąglamy wartości do 6 miejsc po przecinku. |
Interfejs LatLngLiteral
google.maps.LatLngLiteral
interfejs
Dla wygody w wielu miejscach zamiast obiektów LatLng
są akceptowane literały obiektów. Po napotkaniu ich przez interfejs API Map Google są one konwertowane 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 położenia geograficznego nie są obsługiwane w bibliotece Geometry.
Właściwości | |
---|---|
lat |
Typ:
number Szerokość geograficzna w stopniach. Wartości są ograniczane do zakresu [-90, 90]. Oznacza to, że jeśli określona 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ą zawijane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie zamieniona na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długość geograficzna otacza kulę ziemską. |
Klasa LatLngBounds
google.maps.LatLngBounds
zajęcia
Wystąpienie LatLngBounds
reprezentuje prostokąt we współrzędnych geograficznych, w tym taki, który przecina południk 180 stopni.
Uzyskaj dostęp, dzwoniąc pod numer const {LatLngBounds} = await google.maps.importLibrary("core")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
LatLngBounds |
LatLngBounds([swOrLatLngBounds, ne]) Parametry:
Tworzy prostokąt od punktów na jego południowo-zachodnim i północno-wschodnim narożniku. |
Stałe | |
---|---|
MAX_BOUNDS |
Wartości wskazywane przez współrzędne geograficzne maksymalnych granic Ziemi. Te granice będą obejmować całą kulę ziemską. |
Metody | |
---|---|
contains |
contains(latLng) Parametry:
Zwracana wartość:
boolean Zwraca true , jeśli podana szerokość/długość mieści się w tych granicach. |
equals |
equals(other) Parametry:
Zwracana wartość:
boolean Zwraca wartość true , jeśli ta granica jest w przybliżeniu równa podanych granicom. |
extend |
extend(point) Parametry:
Zwracana wartość:
LatLngBounds Rozszerza te granice na podany punkt. |
getCenter |
getCenter() Parametry: brak
Zwracana wartość:
LatLng Oblicza środek tej granicy szerokości geograficznej |
getNorthEast |
getNorthEast() Parametry: brak
Zwracana wartość:
LatLng Zwraca północno-wschodni róg tego granicy. |
getSouthWest |
getSouthWest() Parametry: brak
Zwracana wartość:
LatLng Zwraca południowo-zachodni narożnik tych granic. |
intersects |
intersects(other) Parametry:
Zwracana wartość:
boolean Zwraca wartość true , jeśli ta granica ma wspólne punkty z pozostałymi granicami. |
isEmpty |
isEmpty() Parametry: brak
Zwracana wartość:
boolean Zwraca, jeśli granice są puste. |
toJSON |
toJSON() Parametry: brak
Zwracana wartość:
LatLngBoundsLiteral Konwertuje na reprezentację JSON. Ta funkcja powinna być używana za pośrednictwem JSON.stringify . |
toSpan |
toSpan() Parametry: brak
Zwracana wartość:
LatLng Konwertuje granice mapy na rozpiętość szerokości/długości. |
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-zachodnim rogom ramki ograniczającej, a "hi" oznacza północno-wschodni róg tej ramki. |
union |
union(other) Parametry:
Zwracana wartość:
LatLngBounds Rozszerza te granice w taki sposób, aby obejmowała wynik tej sumy i podaną granicę. |
Interfejs LatLngBoundsLiteral
google.maps.LatLngBoundsLiteral
interfejs
Literały obiektów są akceptowane zamiast obiektów LatLngBounds
w całym interfejsie API. Są one automatycznie konwertowane na obiekty LatLngBounds
. Muszą być ustawione wszystkie wartości south
, west
, north
i east
. 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ą zawijane do zakresu [-180, 180). Na przykład wartość -190 zostanie zamieniona na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długość geograficzna otacza kulę ziemską. |
north |
Typ:
number Szerokość geograficzna północna w stopniach. Wartości są ograniczane do zakresu [-90, 90]. Oznacza to, że jeśli określona 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 są ograniczane do zakresu [-90, 90]. Oznacza to, że jeśli określona 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ą zawijane do zakresu [-180, 180). Na przykład wartość -190 zostanie zamieniona na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długość geograficzna otacza kulę ziemską. |
Klasa LatLngAltitude
google.maps.LatLngAltitude
zajęcia
LatLngAltitude
to punkt 3D we współrzędnych geograficznych: szerokość, długość i wysokość.
- Szerokość geograficzna 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 określona wartość jest mniejsza niż -90, zostanie ustawiona na -90. Jeśli wartość jest większa niż 90, zostanie ustawiona na 90.
- Długość geograficzna to zakres od -180 do 180 stopni włącznie. Wartości powyżej lub poniżej tego zakresu będą zawijane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie zamieniona na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długość geograficzna otacza kulę ziemską.
- Wysokość jest mierzona w metrach. Wartości dodatnie oznaczają wysokości nad poziomem gruntu, a ujemne – wysokości pod powierzchnią gruntu.
Ta klasa implementuje LatLngAltitudeLiteral
.
Ta klasa implementuje LatLngLiteral
.
Uzyskaj dostęp, dzwoniąc pod numer const {LatLngAltitude} = await google.maps.importLibrary("core")
. Zobacz Biblioteki w interfejsie 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:
Zwracana wartość:
boolean – określa, czy oba obiekty są równe.Funkcja porównywania. |
toJSON |
toJSON() Parametry: brak
Zwracana wartość:
LatLngAltitudeLiteral Reprezentacja obiektu w formacie JSON. |
Interfejs LatLngAltitudeLiteral
google.maps.LatLngAltitudeLiteral
interfejs
Dla wygody w wielu miejscach zamiast obiektów LatLngAltitude
są akceptowane literały obiektów. Po napotkaniu ich przez interfejs API Map Google są one konwertowane na obiekty LatLngAltitude
.
Ten interfejs rozszerza zakres LatLngLiteral
.
Właściwości | |
---|---|
altitude |
Typ:
number Wartość domyślna:
0 Odległość (w metrach) nad powierzchnią gruntu. Wartość ujemna oznacza, że znajduje się pod powierzchnią gruntu. |
lat |
Typ:
number Szerokość geograficzna w stopniach. Wartości są ograniczane do zakresu [-90, 90]. Oznacza to, że jeśli określona 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ą zawijane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie zamieniona na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długość geograficzna otacza kulę ziemską. |
Klasa Point
google.maps.Point
zajęcia
Uzyskaj dostęp, dzwoniąc pod numer const {Point} = await google.maps.importLibrary("core")
. Zobacz Biblioteki w interfejsie 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ównaj 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
Uzyskaj dostęp, dzwoniąc pod numer const {Size} = await google.maps.importLibrary("core")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
Size |
Size(width, height[, widthUnit, heightUnit]) Parametry:
Rozmiar dwuwymiarowy, gdzie szerokość to odległość na osi x, a wysokość 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 rozmiar. |
Interfejs Dopełnienie
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 po lewej stronie, w pikselach. |
right optional |
Typ:
number optional Dopełnienie po prawej stronie, w pikselach. |
top optional |
Typ:
number optional Dopełnienie u góry w pikselach. |
Interfejs CircleLiteral
google.maps.CircleLiteral
interfejs
Dosłowny obiekt reprezentujący okrąg.
Ten interfejs rozszerza zakres CircleOptions
.
Właściwości | |
---|---|
center |
Typ:
LatLng|LatLngLiteral Środek koła. |
radius |
Typ:
number Promień w metrach na powierzchni Ziemi. |
Dziedziczone:
clickable ,
draggable ,
editable ,
fillColor ,
fillOpacity ,
map ,
strokeColor ,
strokeOpacity ,
strokePosition ,
strokeWeight ,
visible ,
zIndex
|