Coordinates

Klasa LatLng

google.maps.LatLng class

LatLng to punkt o współrzędnych geograficznych: szerokości i długości geograficznej.

• Szerokość geograficzna mieści się w zakresie od -90 do 90 stopni. Wartości powyżej lub poniżej tego zakresu zostaną przycięte do zakresu [-90, 90]. Oznacza to, ż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. Wartości powyżej lub poniżej tego zakresu zostaną zaokrąglone, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie zamieniona na -170. Odzwierciedla to fakt, że długości geograficzne okaleczają kulę ziemską.

Chociaż domyślna projekcja mapy łączy długość geograficzną z współrzędną X mapy, a szerokość geograficzną z współrzędną Y, współrzędna szerokości jest zawsze zapisywana najpierw, a dopiero potem długość.
Pamiętaj, że nie możesz modyfikować współrzędnych LatLng. Jeśli chcesz obliczyć inny punkt, musisz utworzyć nowy.

Większość metod, które akceptują obiekty LatLng, akceptuje też obiekt LatLngLiteral, więc te 2 wyrażenia 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 konstruktorowi przekazana jest instancja LatLng, tworzona jest jej kopia.

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

Dostęp przez połączenie telefoniczne const {LatLng} = await google.maps.importLibrary("core"). Zobacz Biblioteki w 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 w zakresie [-180, 180]. Aby umożliwić wartości spoza tego zakresu, ustaw noClampNoWrap na true. Zwróć uwagę na kolejność szerokości i długości geograficznej.

Metody
equals	equals(other) Parametry:  other:  LatLng Wartość zwracana:  boolean Funkcja porównywania.
lat	lat() Parametry: brak Wartość zwracana:  number Zwraca szerokość geograficzną w stopniach.
lng	lng() Parametry: brak Wartość zwracana:  number Zwraca długość geograficzną w stopniach.
toJSON	toJSON() Parametry: brak Wartość zwracana:  LatLngLiteral Konwertuje na format JSON. Ta funkcja jest przeznaczona do użycia za pomocą JSON.stringify.
toString	toString() Parametry: brak Wartość zwracana:  string Konwertuje na ciąg znaków.
toUrlValue	toUrlValue([precision]) Parametry:  precision:  number optional Wartość zwracana:  string Zwraca ciąg tekstowy w formie „szerokość_geograficzna,długość_geograficzna” dla tego obiektu LatLng. Domyślnie zaokrąglamy wartości lat/lng do 6 miejsc po przecinku.

Interfejs LatLngLiteral

google.maps.LatLngLiteralinterfejs

Dla wygody w wielu miejscach dozwolone są literały obiektów zamiast obiektów LatLng. Gdy interfejs Maps API je wykryje, 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}); 

W bibliotece Geometry nie są obsługiwane literalne obiekty LatLng.

Właściwości
lat	Typ:  number Szerokość geograficzna w stopniach. Wartości są ograniczane do zakresu [-90, 90]. Oznacza to, ż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] zostaną zaokrąglone, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie zamieniona na -170. Odzwierciedla to fakt, że długości geograficzne okaleczają kulę ziemską.

Klasa LatLngBounds

google.maps.LatLngBounds class

Przykład LatLngBounds reprezentuje prostokąt w układzie współrzędnych geograficznych, w tym ten, który przecina południk długości geograficznej 180°.

Dostęp przez połączenie telefoniczne const {LatLngBounds} = await google.maps.importLibrary("core"). Zobacz Biblioteki w Maps JavaScript API.

Zespół
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) Parametry:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional Tworzy prostokąt z punktów w rogu południowo-zachodnim i północno-wschodnim.

Stałe
MAX_BOUNDS	LatLngBounds dla maksymalnych granic Ziemi. Te granice obejmują całą kulę ziemską.

Metody
contains	contains(latLng) Parametry:  latLng:  LatLng|LatLngLiteral Wartość zwracana:  boolean Zwraca true, jeśli podana szerokość/długość geograficzna mieści się w tych granicach.
equals	equals(other) Parametry:  other:  LatLngBounds|LatLngBoundsLiteral optional Wartość zwracana:  boolean Zwraca true, jeśli te granice są w przybliżeniu równe podanym granicom.
extend	extend(point) Parametry:  point:  LatLng|LatLngLiteral Wartość zwracana:  LatLngBounds Rozszerza te granice, aby zawierały podany punkt.
getCenter	getCenter() Parametry: brak Wartość zwracana:  LatLng Oblicza środek tego obiektu LatLngBounds.
getNorthEast	getNorthEast() Parametry: brak Wartość zwracana:  LatLng Zwraca wierzchołek północno-wschodni tych granic.
getSouthWest	getSouthWest() Parametry: brak Wartość zwracana:  LatLng Zwraca południowo-zachodni róg tego zakresu.
intersects	intersects(other) Parametry:  other:  LatLngBounds|LatLngBoundsLiteral Wartość zwracana:  boolean Zwraca true, jeśli te granice mają wspólne punkty z innymi granicami.
isEmpty	isEmpty() Parametry: brak Wartość zwracana:  boolean Zwraca, czy granice są puste.
toJSON	toJSON() Parametry: brak Wartość zwracana:  LatLngBoundsLiteral Konwertuje na format JSON. Ta funkcja jest przeznaczona do użycia za pomocą JSON.stringify.
toSpan	toSpan() Parametry: brak Wartość zwracana:  LatLng Konwertuje podane granice mapy na zakres współrzędnych lat/dług.
toString	toString() Parametry: brak Wartość zwracana:  string Konwertuje na ciąg znaków.
toUrlValue	toUrlValue([precision]) Parametry:  precision:  number optional Wartość zwracana:  string Zwraca ciąg tekstowy w formie „szerokość_min,długość_min,szerokość_max,długość_max” dla tych granic, gdzie „min” odpowiada skrajnemu prawemu górnemu rogowi ograniczonego obszaru, a „max” odpowiada skrajnemu lewemu dołem rogowi tego obszaru.
union	union(other) Parametry:  other:  LatLngBounds|LatLngBoundsLiteral Wartość zwracana:  LatLngBounds Rozszerza te granice, aby zawierały zjednoczenie tych i podanych granic.

LatLngBoundsLiteral interfejs

google.maps.LatLngBoundsLiteralinterfejs

W interfejsie API dozwolone są literały obiektów zamiast obiektów LatLngBounds. Są one automatycznie konwertowane na obiekty LatLngBounds. Wszystkie parametry south, west, north i east muszą być ustawione, w przeciwnym razie zostanie rzucony wyjątek.

Właściwości
east	Typ:  number Długość geograficzna wschodnia w stopniach. Wartości spoza zakresu [-180, 180] zostaną zaokrąglone do zakresu [-180, 180]. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie zamieniona na -170. Odzwierciedla to fakt, że długości geograficzne okaleczają kulę ziemską.
north	Typ:  number Szerokość geograficzna północna w stopniach. Wartości są ograniczane do zakresu [-90, 90]. Oznacza to, ż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 są ograniczane do zakresu [-90, 90]. Oznacza to, ż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ą zaokrąglone do zakresu [-180, 180]. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie zamieniona na -170. Odzwierciedla to fakt, że długości geograficzne okaleczają kulę ziemską.

Klasa LatLngAltitude

google.maps.LatLngAltitude class

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

• Szerokość geograficzna mieści się w zakresie od -90 do 90 stopni. Wartości powyżej lub poniżej tego zakresu zostaną przycięte do zakresu [-90, 90]. Oznacza to, ż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. Wartości powyżej lub poniżej tego zakresu zostaną zaokrąglone, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie zamieniona na -170. Odzwierciedla to fakt, że długości geograficzne okaleczają 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.

Dostęp przez połączenie telefoniczne const {LatLngAltitude} = await google.maps.importLibrary("core"). Zobacz Biblioteki w Maps JavaScript API.

Zespół

LatLngAltitude

LatLngAltitude(value[, noClampNoWrap]) Parametry:  value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral wartość początkowa. noClampNoWrap:  boolean optional Określa, czy zachować wartości inicjalizacji, nawet jeśli nie są to koniecznie prawidłowe wartości szerokości geograficznej w zakresie [-90, 90] lub prawidłowe wartości długości geograficznej w zakresie [-180, 180]. Wartość domyślna to false, która umożliwia ograniczenie szerokości geograficznej i zawijanie 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 Kolejny obiekt LatLngAltitude. Wartość zwracana:  boolean czy 2 obiekty są równe. Funkcja porównywania.
toJSON	toJSON() Parametry: brak Wartość zwracana:  LatLngAltitudeLiteral reprezentacja obiektu w formacie JSON.

Interfejs LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteralinterfejs

Dla wygody w wielu miejscach dozwolone są literały obiektów zamiast obiektów LatLngAltitude. Gdy interfejs Maps API je wykryje, są one konwertowane na obiekty LatLngAltitude.

Ten interfejs rozszerza LatLngLiteral.

Właściwości
altitude	Typ:  number Domyślnie: 0 Odległość (w metrach) nad powierzchnią ziemi. Wartość ujemna oznacza, że obiekt znajduje się pod powierzchnią ziemi.
lat	Typ:  number Szerokość geograficzna w stopniach. Wartości są ograniczane do zakresu [-90, 90]. Oznacza to, ż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] zostaną zaokrąglone, aby mieściły się w tym zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie zamieniona na -170. Odzwierciedla to fakt, że długości geograficzne okaleczają kulę ziemską.

Klasa punkt

google.maps.Point class

Dostęp przez połączenie telefoniczne const {Point} = await google.maps.importLibrary("core"). Zobacz Biblioteki w 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 Wartość zwracana:  boolean Porównuje 2 punkty
toString	toString() Parametry: brak Wartość zwracana:  string Zwraca ciąg znaków reprezentujący ten punkt.

Rozmiar klasa

google.maps.Size class

Dostęp przez połączenie telefoniczne const {Size} = await google.maps.importLibrary("core"). Zobacz Biblioteki w Maps JavaScript API.

Zespół
Size	Size(width, height[, widthUnit, heightUnit]) Parametry:  width:  number height:  number widthUnit:  string optional heightUnit:  string optional Rozmiar dwuwymiarowy, w którym szerokość to odległość na osi X, a wysokość to odległość 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 Wartość zwracana:  boolean Porównuje 2 rozmiary.
toString	toString() Parametry: brak Wartość zwracana:  string Zwraca ciąg znaków reprezentujący ten rozmiar.

Dopełnienieinterfejsu

google.maps.Paddinginterfejs

Właściwości
bottom optional	Typ:  number optional Dopełnienie u dołu w pikselach.
left optional	Typ:  number optional Dopełnienie z lewej strony (w pikselach).
right optional	Typ:  number optional Dopełnienie z prawej strony w pikselach.
top optional	Typ:  number optional Odstęp od góry w pikselach.

Interfejs CircleLiteral

google.maps.CircleLiteralinterfejs

Obiekt dosłowny reprezentujący okrąg.

Ten interfejs rozszerza CircleOptions.

Właściwości
center	Typ:  LatLng|LatLngLiteral środek okręgu;
radius	Typ:  number Promień w metrach na powierzchni Ziemi.
Uzyskane: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex