Coordinates

zajęcia LatLng

google.maps.LatLng klasa

LatLng jest punktem we współrzędnych geograficznych: szerokości i długości geograficznej.

  • Szerokość geograficzna może wynosić od -90 do 90 stopni (włącznie). Wartości powyżej lub poniżej tego zakresu zostaną ograniczone do zakresu [-90, 90]. To oznacza, ż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ą opakowane, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na wartość 170. Wartość 190 zostanie przekonwertowana na –170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.
Mimo że domyślne odwzorowanie mapy kojarzy długość geograficzną ze współrzędną x, a szerokość ze współrzędną y – szerokość geograficzna jest zawsze zapisywana jako pierwsza, a po niej następuje długość geograficzna.
Zwróć uwagę, że nie można modyfikować współrzędnych elementu LatLng. Jeśli chcesz obliczyć inny punkt, musisz utworzyć nowy.

Większość metod akceptujących obiekty LatLng akceptuje też obiekt LatLngLiteral, więc te, które 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.

Możliwe wywołania konstruktora poniżej:

 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({lat: -34, lng: 151}, null, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151), null, true);

Zadzwoń pod numer const {LatLng} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie 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ślona w stopniach [-90, 90]. Długość geograficzna jest określona w stopniach [-180, 180). Aby włączyć wartości spoza tego zakresu, ustaw noClampNoWrap na true. Zwróć uwagę na kolejność współrzędnych geograficznych.
equals
equals(other)
Parametry: 
Zwrócona wartość:  boolean
Funkcja porównywania.
lat
lat()
Parametry: brak
Zwrócona wartość:  number
Zwraca szerokość geograficzną w stopniach.
lng
lng()
Parametry: brak
Zwrócona wartość:  number
Zwraca długość geograficzną w stopniach.
toJSON
toJSON()
Parametry: brak
Zwrócona wartość:  LatLngLiteral
Konwertuje dane na format JSON. Ta funkcja jest przeznaczona do użytku w: JSON.stringify.
toString
toString()
Parametry: brak
Zwrócona wartość:  string
Przekształca wartość w ciąg znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precisionnumber optional
Zwrócona wartość:  string
Zwraca ciąg znaków w formacie „lat,lng” w przypadku tej długości. Domyślnie zaokrąglamy wartości szerokości i długości geograficznej do 6 miejsc po przecinku.

Interfejs LatLngLiteral

google.maps.LatLngLiteral interfejs

W wielu miejscach dosłowne opisy obiektów są obsługiwane zamiast obiektów LatLng. Podczas konwersji za pomocą interfejsu API Map Google obiekty te są konwertowane na obiekty LatLng.

Przykłady:

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

Litery obiektu LatLng nie są obsługiwane w bibliotece Geometria.

lat
Typ:  number
Szerokość geograficzna w stopniach. Wartości zostaną ograniczone do zakresu [-90, 90]. To oznacza, ż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] są spakowane, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na wartość 170. Wartość 190 zostanie przekonwertowana na –170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.

LatLngBounds.

google.maps.LatLngBounds klasa

Wystąpienie LatLngBounds reprezentuje prostokąt w miejscu współrzędnych geograficznych, w tym przecinający południk 180 stopni.

Zadzwoń pod numer const {LatLngBounds} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametry: 
Powoduje utworzenie prostokąta na podstawie punktów znajdujących się w jego północno-wschodnim narożniku.
contains
contains(latLng)
Parametry: 
Zwrócona wartość:  boolean
Zwraca wartość true, jeśli dana długość/długość geograficzna jest w tych granicach.
equals
equals(other)
Parametry: 
Zwrócona wartość:  boolean
Zwraca wartość true, jeśli to ograniczenie równa się określonym granicom.
extend
extend(point)
Parametry: 
Zwrócona wartość:  LatLngBounds
Rozszerza te granice, by uwzględnić podany punkt.
getCenter
getCenter()
Parametry: brak
Zwrócona wartość:  LatLng
Oblicza środek tego LatLngBounds
getNorthEast
getNorthEast()
Parametry: brak
Zwrócona wartość:  LatLng
Zwraca północno-wschodni róg tych granic.
getSouthWest
getSouthWest()
Parametry: brak
Zwrócona wartość:  LatLng
Zwraca południowo-zachodni narożnik tych granic.
intersects
intersects(other)
Parametry: 
Zwrócona wartość:  boolean
Zwraca wartość true, jeśli ta granica udostępnia jakiekolwiek punkty innym granicom.
isEmpty
isEmpty()
Parametry: brak
Zwrócona wartość:  boolean
Zwraca, jeśli granice są puste.
toJSON
toJSON()
Parametry: brak
Zwrócona wartość:  LatLngBoundsLiteral
Konwertuje dane na format JSON. Ta funkcja jest przeznaczona do użytku w: JSON.stringify.
toSpan
toSpan()
Parametry: brak
Zwrócona wartość:  LatLng
Konwertuje granicy mapy na szerokość i długość geograficzną.
toString
toString()
Parametry: brak
Zwrócona wartość:  string
Przekształca w ciąg znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precisionnumber optional
Zwrócona wartość:  string
Na potrzeby takich granic zwracany jest ciąg w postaci „lat_lo,lng_lo,lat_hi,lng_hi”, gdzie „lo” odpowiada północno-wschodnim narożnikowi ramki ograniczającej, a „hi” odpowiada północno-wschodnim narożnikowi tego pola.
union
union(other)
Parametry: 
Zwrócona wartość:  LatLngBounds
Rozszerza te granice, tak aby obejmowały sumę tego obszaru i podanych granic.
MAX_BOUNDS Wymiary LatLngBounds dla maksymalnej granicy Ziemi. Te granice obejmują całą kulę ziemską.

LatLngBoundsLiteral Interfejs

google.maps.LatLngBoundsLiteral interfejs

Literały obiektów są akceptowane zamiast obiektów LatLngBounds w całym interfejsie API. Są one automatycznie konwertowane do obiektów LatLngBounds. Wszystkie south, west, north i east muszą być ustawione. W przeciwnym razie zostanie podany wyjątek.

east
Typ:  number
Długość geograficzna wschodnia w stopniach. Wartości spoza zakresu [-180, 180] zostaną umieszczone w zakresie [-180, 180]. Na przykład wartość -190 zostanie przekonwertowana na wartość 170. Wartość 190 zostanie przekonwertowana na –170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.
north
Typ:  number
Szerokość geograficzna północna podana w stopniach. Wartości zostaną ograniczone do zakresu [-90, 90]. To oznacza, ż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]. To oznacza, ż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ą umieszczone w zakresie [-180, 180]. Na przykład wartość -190 zostanie przekonwertowana na wartość 170. Wartość 190 zostanie przekonwertowana na –170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.

zajęcia LatLngAltitude

google.maps.LatLngAltitude klasa

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

  • Szerokość geograficzna może wynosić od -90 do 90 stopni (włącznie). Wartości powyżej lub poniżej tego zakresu zostaną ograniczone do zakresu [-90, 90]. To oznacza, ż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ą opakowane, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na wartość 170. Wartość 190 zostanie przekonwertowana na –170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.
  • Wysokość jest mierzona w metrach. Wartości dodatnie oznaczają wysokości ponad poziomem gruntu, a wartości ujemne oznaczają wysokość gruntu.

Ta klasa obsługuje LatLngAltitudeLiteral.

Ta klasa obsługuje LatLngLiteral.

Zadzwoń pod numer const {LatLngAltitude} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametry: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral|LatLng Wartość inicjująca.
  • noClampNoWrapboolean optional pozwala zachować wartości inicjowania, nawet jeśli nie są to prawidłowe wartości szerokości geograficznej w zakresie [-90, 90] lub prawidłowe wartości długości geograficznej w zakresie [-180, 180]. Ustawienie domyślne to false, które umożliwia ograniczanie i ograniczanie 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 wskazuje, czy oba obiekty są takie same.
Funkcja porównywania.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  LatLngAltitudeLiteral to reprezentacja obiektu JSON w formacie JSON.

Interfejs LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interfejs

W wielu miejscach dosłowne opisy obiektów są obsługiwane zamiast obiektów LatLngAltitude. Podczas konwersji za pomocą interfejsu API Map Google obiekty te są konwertowane na obiekty LatLngAltitude.

Ten interfejs rozszerza się do LatLngLiteral.

altitude
Typ:  number
Domyślne: 0
Odległość (w metrach) nad powierzchnią powierzchni ziemi. Wartość ujemna oznacza obszar pod powierzchnią ziemi.
lat
Typ:  number
Szerokość geograficzna w stopniach. Wartości zostaną ograniczone do zakresu [-90, 90]. To oznacza, ż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] są spakowane, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na wartość 170. Wartość 190 zostanie przekonwertowana na –170. Odzwierciedla to fakt, że długości geograficzne okrążają kulę ziemską.

Klasa Point

google.maps.Point klasa

Zadzwoń pod numer const {Point} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

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

Klasa Size

google.maps.Size klasa

Zadzwoń pod numer const {Size} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie 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ść 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: 
Zwrócona wartość:  boolean
Porównaj dwa rozmiary.
toString
toString()
Parametry: brak
Zwrócona wartość:  string
Zwraca ciąg znaków reprezentujący ten rozmiar.

Dopełnienie interfejs

google.maps.Padding interfejs

bottom optional
Typ:  number optional
Wypełnienie na dole w pikselach.
left optional
Typ:  number optional
Wypełnienie po lewej stronie (w pikselach).
right optional
Typ:  number optional
Wypełnienie po prawej stronie w pikselach.
top optional
Typ:  number optional
Wypełnienie u góry w pikselach.

Interfejs CircleLiteral

google.maps.CircleLiteral interfejs

Literał obiektu reprezentujący koło.

Ten interfejs rozszerza się do CircleOptions.

center
Ś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