Coordinates

LatLng class

google.maps.LatLng zajęcia

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 włącznie. Wartości powyżej lub poniżej tego zakresu 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.
  • 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ą zawinięte, tak aby mieściły się w zakresie. Na przykład wartość –190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na -170. Wynika to z faktu, że długości geograficzne obejmują cały glob.
Chociaż domyślna projekcja mapy wiąże długość geograficzną ze współrzędną x mapy, a szerokość geograficzną ze współrzędną y, współrzędna szerokości geograficznej jest zawsze zapisywana jako pierwsza, a po niej następuje długość geograficzna.
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 zapisy 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 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 pod numer const {LatLng} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w 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 określana w stopniach w zakresie [-90, 90]. Długość geograficzna jest określana w stopniach w zakresie [-180, 180). Ustaw wartość noClampNoWrap na true, aby włączyć wartości spoza tego zakresu. Zwróć uwagę na kolejność szerokości i długości geograficznej.
equals
equals(other)
Parametry: 
Zwracana wartość:  boolean
Funkcja porównania.
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 jest przeznaczona do używania za pomocą JSON.stringify.
toString
toString()
Parametry: brak
Zwracana wartość:  string
Konwertuje na reprezentację w postaci ciągu znaków.
toUrlValue
toUrlValue([precision])
Parametry: 
  • precision:  number optional
Zwracana wartość:  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.

LatLngLiteral interfejs

google.maps.LatLngLiteralinterfejs

W wielu miejscach zamiast obiektów LatLng można używać literałów obiektów. Gdy interfejs Maps API 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.
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. Wynika to z faktu, że długości geograficzne obejmują cały glob.

LatLngBounds class

google.maps.LatLngBounds zajęcia

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

Dostęp przez połączenie pod numer const {LatLngBounds} = await google.maps.importLibrary("core").
 Zobacz Biblioteki w Maps JavaScript API.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametry: