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.

Zespół

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 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:  other:  LatLng 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:  precision:  number 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.

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:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional 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:  latLng:  LatLng|LatLngLiteral Zwracana wartość:  boolean Zwraca true, jeśli podana szerokość/długość mieści się w tych granicach.
equals	equals(other) Parametry:  other:  LatLngBounds|LatLngBoundsLiteral optional Zwracana wartość:  boolean Zwraca wartość true, jeśli ta granica jest w przybliżeniu równa podanych granicom.
extend	extend(point) Parametry:  point:  LatLng|LatLngLiteral 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:  other:  LatLngBounds|LatLngBoundsLiteral 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:  precision:  number 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:  other:  LatLngBounds|LatLngBoundsLiteral 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:  value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral wartość inicjująca. noClampNoWrap:  boolean 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.

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:  other:  LatLngAltitude optional inny obiekt LatLngAltitude. 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:  x:  number y:  number 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:  other:  Point 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:  width:  number height:  number widthUnit:  string optional heightUnit:  string optional 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:  other:  Size 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