Coordinates

Klasa LatLng

google.maps.LatLng zajęcia

LatLng to punkt we współrzędnych geograficznych: szerokość i długość geograficzna.

  • Zakres szerokości geograficznej mieści się w zakresie od -90 do 90 stopni włącznie. Wartości powyżej lub poniżej tego zakresu zostaną ograniczone 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 zostaną zawijane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.
Domyślne rzutowanie mapy wiąże długość geograficzną ze współrzędną x, a szerokość geograficzną ze współrzędną Y, jednak szerokość geograficzna jest zawsze zapisywana pierwsza, a po niej długość geograficzna.
Zwróć uwagę, że nie można zmienić współrzędnych obiektu LatLng. Jeśli chcesz obliczyć kolejny punkt, musisz utworzyć nowy.

Większość metod, które akceptują obiekty LatLng, akceptuje również obiekt LatLngLiteral, więc metoda jest równoważna: 

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

Konstruktor akceptuje też obiekty LatLngLiteral i LatLng. Jeśli instancja LatLng zostanie przekazana do konstruktora, tworzona jest 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);

Aby uzyskać dostęp, zadzwoń pod numer const {LatLng} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parametry: 
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean optional
Tworzy obiekt LatLng reprezentujący punkt geograficzny. Szerokość geograficzna jest podawana w stopniach z zakresu [-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ść długości i szerokości geograficznej.
equals
equals(other)
Parametry: 
Wartość zwrotu:  boolean
Funkcja porównania.
lat
lat()
Parametry: brak
Wartość zwrotu:  number
Zwraca szerokość geograficzną w stopniach.
lng
lng()
Parametry: brak
Wartość zwrotu:  number
Zwraca długość geograficzną w stopniach.
toJSON
toJSON()
Parametry: brak
Wartość zwrotu:  LatLngLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do korzystania z JSON.stringify.
toString
toString()
Parametry: brak
Wartość zwrotu:  string
Konwertuje na reprezentację ciągu znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precision:  number optional
Wartość zwrotu:  string
Zwraca ciąg w formie „lat,lng” dla tej szerokości geograficznej. Domyślnie zaokrąglamy wartości szerokości i długości geograficznej do 6 miejsc po przecinku.

Interfejs LatLngLiteral

google.maps.LatLngLiteral interfejs

Literały obiektów są w wielu miejscach akceptowane zamiast obiektów LatLng ze względu na wygodę. 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});

Biblioteka Geometry nie obsługuje literałów obiektów o współrzędnych geograficznych.
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 przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.

Klasa LatLngBounds

google.maps.LatLngBounds zajęcia

Instancja LatLngBounds reprezentuje prostokąt we współrzędnych geograficznych, w tym taki, który przecina południk długości 180 stopni.

Aby uzyskać dostęp, zadzwoń pod numer const {LatLngBounds} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametry: 
Konstruuje prostokąt z punktów znajdujących się w jego południowo-zachodnim i północno-wschodnim narożniku.
MAX_BOUNDS Zakres współrzędnych geograficznych dla maksymalnych granic Ziemi. Te granice obejmą całą kulę ziemską.
contains
contains(latLng)
Parametry: 
Wartość zwrotu:  boolean
Zwraca wartość true, jeśli podana szerokość/długość geograficzna znajduje się w tych granicach.
equals
equals(other)
Parametry: 
Wartość zwrotu:  boolean
Zwraca wartość true, jeśli ta wartość progowa jest w przybliżeniu równa podanej wartości progowej.
extend
extend(point)
Parametry: 
Wartość zwrotu:  LatLngBounds
Rozszerza te granice tak, aby obejmował podany punkt.
getCenter
getCenter()
Parametry: brak
Wartość zwrotu:  LatLng
Oblicza środek tego obiektu LatLngBound
getNorthEast
getNorthEast()
Parametry: brak
Wartość zwrotu:  LatLng
Zwraca północno-wschodni róg tego obszaru.
getSouthWest
getSouthWest()
Parametry: brak
Wartość zwrotu:  LatLng
Zwraca południowo-zachodni róg tego zakresu.
intersects
intersects(other)
Parametry: 
Wartość zwrotu:  boolean
Zwraca wartość true, jeśli ta wartość granica dzieli dowolny punkt z pozostałymi granicami.
isEmpty
isEmpty()
Parametry: brak
Wartość zwrotu:  boolean
Zwraca, jeśli granice są puste.
toJSON
toJSON()
Parametry: brak
Wartość zwrotu:  LatLngBoundsLiteral
Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do korzystania z JSON.stringify.
toSpan
toSpan()
Parametry: brak
Wartość zwrotu:  LatLng
Konwertuje podane granice mapy na rozpiętość szerokości/długości geograficznej.
toString
toString()
Parametry: brak
Wartość zwrotu:  string
Konwertuje na ciąg znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precision:  number optional
Wartość zwrotu:  string
Zwraca ciąg w postaci „lat_lo,lng_lo,lat_hi,lng_hi” dla tych granic, gdzie „lo” odpowiada południowo-zachodnim rogom ramki ograniczającej, a „hi” – północno-wschodniemu narożnikowi tej ramki.
union
union(other)
Parametry: 
Wartość zwrotu:  LatLngBounds
Rozszerza te granice tak, aby obejmowały sumę tej wartości i podanej wartości progowej.

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. Musisz ustawić 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 przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długość geograficzna okrąża 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 przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.

Klasa LatLngAltitude

google.maps.LatLngAltitude zajęcia

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

  • Zakres szerokości geograficznej mieści się w zakresie od -90 do 90 stopni włącznie. Wartości powyżej lub poniżej tego zakresu zostaną ograniczone 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 zostaną zawijane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długość geograficzna okrąża 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.

Aby uzyskać dostęp, zadzwoń pod numer const {LatLngAltitude} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametry: 
  • value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral wartość inicjująca.
  • noClampNoWrap:  boolean optional określa, czy należy zachować wartości inicjowania, nawet jeśli nie muszą być one prawidłowymi wartościami szerokości geograficznej z zakresu [-90, 90] lub prawidłowymi wartościami długości geograficznej z zakresu [-180, 180]. Wartość domyślna to false, która umożliwia ograniczanie szerokości geograficznej i zawijanie 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ównania.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  LatLngAltitudeLiteral Reprezentacja tego obiektu w formacie JSON.

Interfejs LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interfejs

Literały obiektów są w wielu miejscach akceptowane zamiast obiektów LatLngAltitude ze względu na wygodę. 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 przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość -170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.

Klasa Point

google.maps.Point zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {Point} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
Point
Point(x, y)
Parametry: 
  • x:  number
  • y:  number
Punkt na płaszczyźnie dwuwymiarowej.
x
Typ:  number
Współrzędna X
y
Typ:  number
Współrzędna Y
equals
equals(other)
Parametry: 
Wartość zwrotu:  boolean
Porównanie dwóch punktów
toString
toString()
Parametry: brak
Wartość zwrotu:  string
Zwraca ciąg znaków reprezentujący ten punkt.

Rozmiar class

google.maps.Size zajęcia

Aby uzyskać dostęp, zadzwoń pod numer const {Size} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
Size
Size(width, height[, widthUnit, heightUnit])
Parametry: 
  • width:  number
  • height:  number
  • widthUnit:  string optional
  • heightUnit:  string optional
Rozmiar dwuwymiarowy, gdzie szerokość to odległość na osi X, a wysokość – odległość na osi Y.
height
Typ:  number
Wysokość wzdłuż osi Y wyrażona w pikselach.
width
Typ:  number
Szerokość wzdłuż osi x wyrażona w pikselach.
equals
equals(other)
Parametry: 
Wartość zwrotu:  boolean
Porównuje 2 rozmiary.
toString
toString()
Parametry: brak
Wartość zwrotu:  string
Zwraca ciąg znaków reprezentujący ten rozmiar.

Interfejs dopełnienia

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

Literał obiektu reprezentujący koło.

Ten interfejs rozszerza zakres CircleOptions.

center
Środek kręgu.
radius
Typ:  number
Promień na powierzchni Ziemi w metrach.
Dziedziczone: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex