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.

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

Metody
equals	equals(other) Parametry:  other:  LatLng 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:  precision:  number 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.

Właściwości
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.

Zespół
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) Parametry:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional Powoduje utworzenie prostokąta na podstawie punktów znajdujących się w jego północno-wschodnim narożniku.

Metody
contains	contains(latLng) Parametry:  latLng:  LatLng|LatLngLiteral Zwrócona wartość:  boolean Zwraca wartość true, jeśli dana długość/długość geograficzna jest w tych granicach.
equals	equals(other) Parametry:  other:  LatLngBounds|LatLngBoundsLiteral optional Zwrócona wartość:  boolean Zwraca wartość true, jeśli to ograniczenie równa się określonym granicom.
extend	extend(point) Parametry:  point:  LatLng|LatLngLiteral 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:  other:  LatLngBounds|LatLngBoundsLiteral 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:  precision:  number 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:  other:  LatLngBounds|LatLngBoundsLiteral Zwrócona wartość:  LatLngBounds Rozszerza te granice, tak aby obejmowały sumę tego obszaru i podanych granic.

Stałe
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.

Właściwości
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.

Zespół

LatLngAltitude

LatLngAltitude(value[, noClampNoWrap]) Parametry:  value:  LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral|LatLng Wartość inicjująca. noClampNoWrap:  boolean 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.

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

Właściwości
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.

Zespół
Point	Point(x, y) Parametry:  x:  number y:  number Punkt na dwuwymiarowej płaszczyźnie.

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

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

Właściwości
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.

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