Coordinates

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ą.
Domyślne rzutowanie mapy wiąże długość geograficzną ze współrzędną x, a szerokości – szerokość – ze współrzędną Y, jednak szerokość geograficzna jest zawsze zapisywana pierwszą, a po niej długość geograficzna.
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.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parametry: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean 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 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.
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: 
  • precisionnumber optional
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.

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.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametry: 
Tworzy prostokąt od punktów na jego południowo-zachodnim i północno-wschodnim narożniku.
MAX_BOUNDS Wartości wskazywane przez współrzędne geograficzne maksymalnych granic Ziemi. Te granice będą obejmować całą kulę ziemską.
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: 
  • precisionnumber optional
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.

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.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametry: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral wartość inicjująca.
  • noClampNoWrapboolean optional określa, czy należy zachować wartości inicjujące, nawet jeśli nie muszą być to prawidłowe wartości szerokości geograficznej z zakresu [-90, 90] lub prawidłowe wartości z zakresu [-180, 180]. Wartość domyślna to false, która umożliwia ograniczanie szerokości i zawijania 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 – 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.

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.

Point
Point(x, y)
Parametry: 
  • xnumber
  • ynumber
Punkt na płaszczyźnie dwuwymiarowej.
x
Typ:  number
Współrzędna X
y
Typ:  number
Współrzędna Y
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.

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: 
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

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.

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