Coordinates

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Klasa LatLng

Klasa google.maps.LatLng

LatLng to punkt na 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ą zmieniane na wartości z 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ą opakowane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość –170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.
Chociaż domyślna projekcja mapy wiąże się z długością geograficzną na osi X, a szerokość geograficzną – współrzędną Y, współrzędne są zawsze zapisywane jako pierwsza, a potem długość geograficzna.
Pamiętaj, że nie możesz zmodyfikować współrzędnych LatLng. Jeśli chcesz obliczyć inny punkt, musisz utworzyć nowy.

Większość metod akceptujących obiekty LatLng akceptuje też obiekt LatLngLiteral, więc te wartości 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({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);

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 w zakresie [-90, 90]. Długość geograficzna jest określona w stopniach od [-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.
equals
equals(other)
Parametry:
Wartość zwrotu: boolean
Funkcja porównania.
lat
lat()
Parametry: brak
Wartość zwrotu: number
Zwraca szerokość geograficzną w stopniach.
lng
lng()
Parametry: brak
Wartość zwrotu: number
Zwraca długość geograficzną w stopniach.
toJSON
toJSON()
Parametry: brak
Wartość zwrotu: LatLngLiteral
Przekształca obraz w reprezentację JSON. Ta funkcja jest przeznaczona do użytku w środowisku JSON.stringify.
toString
toString()
Parametry: brak
Wartość zwrotu: string
Konwertuje wartość na ciąg znaków.
toUrlValue
toUrlValue([precision])
Parametry:
  • precision: number optional
Wartość zwrotu: string
Zwraca ciąg znaków w formacie "lat,lng" dla tego LatLng. Domyślnie zaokrąglamy wartości długości i długości do 6 miejsc po przecinku.

Interfejs LatLngLiteral

google.maps.LatLngLiteral interfejs

W wielu miejscach dosłowne obiekty są akceptowane zamiast obiektów LatLng. Są one konwertowane na obiekty LatLng, gdy napotka je interfejs API Map Google.

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

lat
Typ: number
Szerokość geograficzna w stopniach Wartości zostaną zmienione na zakres z 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] są spakowane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość –170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.

Klasa LatLngBound

Klasa google.maps.LatLngBounds

W przypadku współrzędnych geograficznych instancja LatLngBounds ma postać prostokąta, w tym poprzecinany południkiem 180°.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametry:
Tworzy prostokąt z punktów na rogach południowo-zachodnim i północno-wschodnim.
contains
contains(latLng)
Parametry:
Wartość zwrotu: boolean
Zwraca wartość true, jeśli w tych granicach znajduje się dana wartość długości i szerokości geograficznej.
equals
equals(other)
Parametry:
Wartość zwrotu: boolean
Zwraca true, jeśli to ograniczenie równa się określonym danym.
extend
extend(point)
Parametry:
Wartość zwrotu: LatLngBounds
Rozszerza te granice o określony punkt.
getCenter
getCenter()
Parametry: brak
Wartość zwrotu: LatLng
Oblicza środek tego lataLngBound
getNorthEast
getNorthEast()
Parametry: brak
Wartość zwrotu: LatLng
Zwraca północno-wschodni narożnik tych granic.
getSouthWest
getSouthWest()
Parametry: brak
Wartość zwrotu: LatLng
Zwraca południowo-zachodni obszar tego granicy.
intersects
intersects(other)
Wartość zwrotu: boolean
Zwraca wartość true, jeśli ta granica dzieli jakiekolwiek punkty z innymi.
isEmpty
isEmpty()
Parametry: brak
Wartość zwrotu: boolean
Zwraca wartości, jeśli granice są puste.
toJSON
toJSON()
Parametry: brak
Wartość zwrotu: LatLngBoundsLiteral
Przekształca obraz w reprezentację JSON. Ta funkcja jest przeznaczona do użytku w środowisku JSON.stringify.
toSpan
toSpan()
Parametry: brak
Wartość zwrotu: LatLng
Konwertuje granice określonych map na szerokość i szerokość geograficzną.
toString
toString()
Parametry: brak
Wartość zwrotu: string
Zmienia w ciąg.
toUrlValue
toUrlValue([precision])
Parametry:
  • precisionnumber optional
Wartość zwrotu: string
Zwraca ciąg znaków "lat_lo,lng_lo,lat_hi,lng_hi" w przypadku tych granic, gdzie &&tt;lo" odpowiada południowo-zachodnim rogu ramki granicznej, a "hi" odpowiada północno-wschodnim rogu tego pola.
union
union(other)
Parametry:
Wartość zwrotu: LatLngBounds
Rozwija te granice tak, aby obejmowały ten suma.
MAX_BOUNDS Maksymalne granice granic ziemi. Te granice obejmują całą kulę ziemską.

Interfejs LatLngBoundsLiteral

google.maps.LatLngBoundsLiteral interfejs

Literały obiektów są akceptowane zamiast obiektów LatLngBounds w interfejsie API. Są one automatycznie konwertowane na obiekty LatLngBounds. Wszystkie south, west, north i east muszą zostać ustawione. W przeciwnym razie zostanie wyświetlony wyjątek.

east
Typ: number
Długość geograficzna wschodnia w stopniach. Wartości spoza zakresu [-180, 180] zostaną spakowane w zakresie [-180, 180]. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość –170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.
north
Typ: number
Szerokość geograficzna północna w stopniach. Wartości zostaną zmienione na zakres z 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ą zmienione na zakres z 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ą spakowane w zakresie [-180, 180]. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość –170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.

Klasa LatLngAltitude

Klasa google.maps.LatLngAltitude

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

  • Szerokość geograficzna wynosi od -90 do 90 stopni (włącznie). Wartości powyżej lub poniżej tego zakresu są zmieniane na wartości z 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ą opakowane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość –170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.
  • Wysokość jest mierzona w metrach. Wartości dodatnie oznaczają wysokość nad poziomem gruntu, a wartości ujemne oznaczają wysokość powierzchni ziemi.

Ta klasa implementuje właściwość LatLngAltitudeLiteral.

Ta klasa implementuje właściwość LatLngLiteral.

altitude
Typ: number
Zwraca wysokość.
lat
Typ: number
Zwraca szerokość geograficzną.
lng
Typ: number
Zwraca długość geograficzną.
equals
equals(other)
Parametry:
Wartość zwracana: boolean określa, czy oba obiekty są równe.
Funkcja porównania.
toJSON
toJSON()
Parametry: brak
Wartość zwracana: LatLngAltitudeLiteral reprezentacja tego obiektu w formacie JSON.

Interfejs LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interfejs

W wielu miejscach dosłowne obiekty są akceptowane zamiast obiektów LatLngAltitude. Są one konwertowane na obiekty LatLngAltitude, gdy napotka je interfejs API Map Google.

Ten interfejs obejmuje rozszerzenie LatLngLiteral.

altitude
Typ: number
Wartość domyślna: 0
Odległość (w metrach) nad powierzchnią ziemi. Wartość ujemna oznacza, że znajduje się pod powierzchnią ziemi.
lat
Typ: number
Szerokość geograficzna w stopniach Wartości zostaną zmienione na zakres z 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] są spakowane, aby mieściły się w zakresie. Na przykład wartość -190 zostanie przekonwertowana na 170. Wartość 190 zostanie przekonwertowana na wartość –170. Odzwierciedla to fakt, że długość geograficzna okrąża kulę ziemską.

Klasa Point

Klasa google.maps.Point

Point
Point(x, y)
Parametry:
  • xnumber
  • y: number
Punkt na płaszczyźnie dwuwymiarowej.
x
Typ: number
Współrzędna X
y
Typ: number
Współrzędna Y
equals
equals(other)
Parametry:
Wartość zwrotu: boolean
Porównanie 2 punktów
toString
toString()
Parametry: brak
Wartość zwrotu: string
Zwraca ciąg znaków reprezentujący ten punkt.

Klasa Size

Klasa google.maps.Size

Size
Size(width, height[, widthUnit, heightUnit])
Parametry:
  • width: number
  • heightnumber
  • widthUnit: string optional
  • heightUnitstring optional
Rozmiar dwuwymiarowy, gdzie szerokość to odległość na osi X, a wysokość na osi Y.
height
Typ: number
Wysokość na osi Y (w pikselach).
width
Typ: number
Szerokość na osi X (w pikselach).
equals
equals(other)
Parametry:
Wartość zwrotu: boolean
Porównanie 2 rozmiarów.
toString
toString()
Parametry: brak
Wartość zwrotu: string
Zwraca ciąg znaków w tym rozmiarze.

Dopełnienie interfejs

google.maps.Padding interfejs

bottom optional
Typ: number optional
Dopełnienie na dole 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 na górze (w pikselach).

Interfejs CircleLiteral

google.maps.CircleLiteral interfejs

Literał obiektu symbolizujący okrąg.

Ten interfejs obejmuje rozszerzenie CircleOptions.

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