Coordinates

Klasa LatLng

klasa google.maps.LatLng
biblioteka "core"

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

• Szerokość geograficzna mieści się w zakresie od –90 do 90 stopni. Wartości spoza tego zakresu są zmieniane na wartości graniczne [-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 spoza tego zakresu są zmieniane tak, aby mieściły się w nim. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.

Chociaż domyślne odwzorowanie mapy wiąże długość geograficzną ze współrzędną X, a szerokość geograficzną ze współrzędną Y, szerokość geograficzna jest zawsze zapisywana jako pierwsza, a po niej długość geograficzna.
Zauważ, że nie możesz zmienić współrzędnych elementu 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 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 przekazana instancja LatLng, zostanie utworzona 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);
 

const {LatLng} = await google.maps.importLibrary("core");

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 włączyć 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|LatLngLiteral optional Wartość zwracana: boolean Funkcja porównywania 2 obiektów LatLng. Zwraca wartość „true”, jeśli współrzędne są w odległości 1e-9 od siebie, a w przeciwnym razie – „false”.
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 reprezentację JSON. Ta funkcja jest przeznaczona do używania w ramach 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 znaków w formacie „lat,lng” dla tego obiektu LatLng. Domyślnie zaokrąglamy wartości szerokości i długości geograficznej do 6 miejsc po przecinku.

Interfejs LatLngLiteral

interfejs google.maps.LatLngLiteral
rozszerzony przez: DirectionalLocationLiteral, LatLngAltitudeLiteral
implementowany przez: DirectionalLocation, LatLngAltitude

W wielu miejscach zamiast obiektów LatLng akceptowane są literały obiektów. Gdy interfejs API Map Google napotka te obiekty, zostaną one przekonwertowane 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 LatLng nie są obsługiwane w bibliotece Geometry.

Właściwości
lat	Typ: number Szerokość geograficzna w stopniach. Wartości zostaną ograniczone 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ą zawinięte, aby mieściły się w tym zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.

Klasa LatLngBounds

klasa google.maps.LatLngBounds
biblioteka "core"

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

const {LatLngBounds} = await google.maps.importLibrary("core");

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

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 dany punkt.
getCenter	getCenter() Parametry: brak Wartość zwracana: LatLng Oblicza środek tego obiektu LatLngBounds
getNorthEast	getNorthEast() Parametry: brak Wartość zwracana: LatLng Zwraca północno-wschodni róg tych granic.
getSouthWest	getSouthWest() Parametry: brak Wartość zwracana: LatLng Zwraca południowo-zachodni róg tych granic.
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 informację o tym, czy granice są puste.
toJSON	toJSON() Parametry: brak Wartość zwracana: LatLngBoundsLiteral Konwertuje na reprezentację JSON. Ta funkcja jest przeznaczona do używania w ramach JSON.stringify.
toSpan	toSpan() Parametry: brak Wartość zwracana: LatLng Konwertuje podane granice mapy na zakres szerokości i długości geograficznej.
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 znaków w formacie „lat_lo,lng_lo,lat_hi,lng_hi” dla tych granic, gdzie „lo” odpowiada południowo-zachodniemu narożnikowi ramki ograniczającej, a „hi” – północno-wschodniemu.
union	union(other) Parametry: other: LatLngBounds|LatLngBoundsLiteral Wartość zwracana: LatLngBounds Rozszerza te granice, aby zawierały sumę tych i podanych granic.

Interfejs LatLngBoundsLiteral

interfejs google.maps.LatLngBoundsLiteral

W całym interfejsie API literały obiektów są akceptowane 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 zgłoszony wyjątek.

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

Klasa LatLngAltitude

klasa google.maps.LatLngAltitude implementuje LatLngAltitudeLiteral, LatLngLiteral
rozszerzona przez DirectionalLocation
biblioteka "core"

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

• Szerokość geograficzna mieści się w zakresie od –90 do 90 stopni. Wartości spoza tego zakresu są zmieniane na wartości graniczne [-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 spoza tego zakresu są zmieniane tak, aby mieściły się w nim. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.
• Wysokość jest mierzona w metrach. Wartości dodatnie oznaczają wysokości nad poziomem gruntu, a wartości ujemne – wysokości pod powierzchnią gruntu.

const {LatLngAltitude} = await google.maps.importLibrary("core");

Zespół

LatLngAltitude

LatLngAltitude(value[, noClampNoWrap]) Parametry: value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Wartość inicjująca. noClampNoWrap: boolean optional Określa, czy zachować wartości inicjalizacji, nawet jeśli nie są to prawidłowe wartości szerokości geograficznej z zakresu [-90, 90] lub długości geograficznej z zakresu [-180, 180]. Wartość domyślna to false, co umożliwia ograniczenie szerokości geograficznej i zawijanie długości geograficznej.

Właściwości
altitude readonly	Typ: number Zwraca wysokość.
lat readonly	Typ: number Zwraca szerokość geograficzną.
lng readonly	Typ: number Zwraca długość geograficzną.

Metody
equals	equals(other) Parametry: other: LatLngAltitude|LatLngAltitudeLiteral optional Inny obiekt LatLngAltitude. Zwracana wartość: boolean, czyli informacja, czy 2 obiekty są równe. Funkcja porównywania 2 obiektów LatLngAltitude. Zwraca wartość „true”, jeśli współrzędne są w odległości 1e-9 od siebie, a w przeciwnym razie – „false”.
toJSON	toJSON([key]) Parametry: key: string optional Wartość zwracana: LatLngAltitudeLiteral Konwertuje na zwykły obiekt.

Interfejs LatLngAltitudeLiteral

interfejs google.maps.LatLngAltitudeLiteral rozszerza LatLngLiteral
rozszerzony przez DirectionalLocationLiteral
implementowany przez DirectionalLocation, LatLngAltitude

W wielu miejscach zamiast obiektów LatLngAltitude akceptowane są literały obiektów. Gdy interfejs API Map Google napotka te obiekty, zostaną one przekonwertowane na obiekty LatLngAltitude.

Właściwości
altitude	Typ: number Odległość (w metrach) nad powierzchnią gruntu. Wartość ujemna oznacza, że punkt znajduje się pod powierzchnią ziemi.
lat	Typ: number Szerokość geograficzna w stopniach. Wartości zostaną ograniczone 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ą zawinięte, aby mieściły się w tym zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Odzwierciedla to fakt, że długości geograficzne otaczają kulę ziemską.

Klasa Point

klasa google.maps.Point
biblioteka "core"

const {Point} = await google.maps.importLibrary("core");

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 optional Wartość zwracana: boolean Porównuje 2 punkty
toString	toString() Parametry: brak Wartość zwracana: string Zwraca ciąg znaków reprezentujący ten punkt.

Size class

klasa google.maps.Size
biblioteka "core"

const {Size} = await google.maps.importLibrary("core");

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ść 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 optional Wartość zwracana: boolean Porównuje 2 rozmiary.
toString	toString() Parametry: brak Wartość zwracana: string Zwraca ciąg znaków reprezentujący ten rozmiar.

Interfejs Padding

interfejs google.maps.Padding

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

CircleLiteral interface

interface google.maps.CircleLiteral extends CircleOptions

Literał obiektu reprezentujący okrąg.

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

Klasa Orientation3D

klasa google.maps.Orientation3D implementuje Orientation3DLiteral
biblioteka "core"

Orientation3D to trójwymiarowy wektor używany do standardowych matematycznych przekształceń obrotu wzdłuż kierunku, nachylenia i obrotu.

• Kierunek to kąt z zakresu [0, 360) stopni.
• tilt to kąt z zakresu [0, 360) stopni.
• Przechylenie to kąt z zakresu [0, 360) stopni.

const {Orientation3D} = await google.maps.importLibrary("core");

Zespół
Orientation3D	Orientation3D(value) Parametry: value: Orientation3D|Orientation3DLiteral Wartość inicjująca.

Właściwości
heading readonly	Typ: number Domyślnie: 0 Obrót wokół osi Z (prostopadłej do powierzchni Ziemi). Wartość 0 (domyślna) oznacza północ. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi Z i jest określany w stopniach od 0 do 360. Wartości spoza tego zakresu są zmieniane tak, aby mieściły się w nim. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 530 również zostanie przekonwertowana na 170.
roll readonly	Typ: number Domyślnie: 0 Obrót wokół osi Y. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi Y i jest określany w stopniach od 0 do 360. Wartości spoza tego zakresu są zmieniane tak, aby mieściły się w nim. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 530 również zostanie przekonwertowana na 170.
tilt readonly	Typ: number Domyślnie: 0 Obrót wokół osi X. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi X i jest określany w stopniach od 0 do 360. Wartości spoza tego zakresu są zmieniane tak, aby mieściły się w nim. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 530 również zostanie przekonwertowana na 170.

Metody
equals	equals(other) Parametry: other: Orientation3D|Orientation3DLiteral optional Inny obiekt Orientation3D. Zwracana wartość: boolean, czyli informacja, czy 2 obiekty są równe. Funkcja porównania.
toJSON	toJSON([key]) Parametry: key: string optional Wartość zwracana: Orientation3DLiteral Konwertuje na zwykły obiekt.

Interfejs Orientation3DLiteral

interfejs google.maps.Orientation3DLiteral
zaimplementowany przez Orientation3D

W wielu miejscach zamiast obiektów Orientation3D akceptowane są literały obiektów. Gdy interfejs API Map Google napotka te obiekty, zostaną one przekonwertowane na obiekty Orientation3D.

Właściwości
heading opcjonalne	Typ: number optional Obrót wokół osi Z (prostopadłej do powierzchni Ziemi). Wartość 0 (domyślna) oznacza północ. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi Z i jest określany w stopniach od 0 do 360.
roll opcjonalne	Typ: number optional Obrót wokół osi Y. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi Y i jest określany w stopniach od 0 do 360.
tilt opcjonalne	Typ: number optional Obrót wokół osi X. Obrót dodatni jest zgodny z ruchem wskazówek zegara wokół osi X i jest określany w stopniach od 0 do 360.

Klasa Vector3D

klasa google.maps.Vector3D implementuje Vector3DLiteral
biblioteka "core"

Vector3D to trójwymiarowy wektor używany do standardowych operacji matematycznych, takich jak skalowanie granic trójwymiarowego obiektu wzdłuż lokalnych osi X, Y i Z.

• x jest liczbą rzeczywistą.
• y jest liczbą rzeczywistą.
• z jest liczbą rzeczywistą.

const {Vector3D} = await google.maps.importLibrary("core");

Zespół
Vector3D	Vector3D(value) Parametry: value: Vector3D|Vector3DLiteral Wartość inicjująca.

Właściwości
x readonly	Typ: number Składowa X wektora trójwymiarowego.
y readonly	Typ: number Składowa Y wektora trójwymiarowego.
z readonly	Typ: number Składowa Z wektora trójwymiarowego.

Metody
equals	equals(other) Parametry: other: Vector3D|Vector3DLiteral optional Inny obiekt Vector3D lub Vector3DLiteral. Wartość zwracana: boolean Funkcja porównania.
toJSON	toJSON([key]) Parametry: key: string optional Wartość zwracana: Vector3DLiteral Konwertuje na zwykły obiekt.

Interfejs Vector3DLiteral

interfejs google.maps.Vector3DLiteral
zaimplementowany przez Vector3D

W wielu miejscach zamiast obiektów Vector3D akceptowane są literały obiektów. Gdy interfejs API Map Google napotka te obiekty, zostaną one przekonwertowane na obiekty Vector3D.

Właściwości
x	Typ: number Składowa X wektora trójwymiarowego.
y	Typ: number Składowa Y wektora trójwymiarowego.
z	Typ: number Składowa Z wektora trójwymiarowego.