Coordinates

LatLng-Klasse

google.maps.LatLng Klasse

Ein LatLng ist ein Punkt in geografischen Koordinaten: Breiten- und Längengrad.

  • Der Breitengrad kann zwischen -90 und 90 Grad liegen. Werte ober- oder unterhalb dieses Bereichs werden auf den Bereich [-90, 90] gesetzt. Wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Wenn der Wert größer als 90 ist, wird er auf 90 festgelegt.
  • Der Längengrad umfasst -180 bis 180 Grad. Werte ober- oder unterhalb dieses Bereichs werden so umgerechnet, dass sie in diesen Bereich fallen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Das liegt daran, dass sich die Längengrade um die Erde herum erstrecken.
 Bei der Standardkartenprojektion wird der Längengrad der X-Koordinate der Karte und der Breitengrad der Y-Koordinate zugeordnet. Der Breitengrad wird jedoch immer zuerst angegeben, gefolgt vom Längengrad.
 Die Koordinaten eines LatLng können nicht geändert werden. Wenn Sie einen anderen Punkt berechnen möchten, müssen Sie einen neuen erstellen.

Die meisten Methoden, die LatLng-Objekte akzeptieren, akzeptieren auch ein LatLngLiteral-Objekt. Die folgenden Beispiele sind also gleichwertig:

 map.setCenter(new google.maps.LatLng(-34, 151));
map.setCenter({lat: -34, lng: 151});

Der Konstruktor akzeptiert auch LatLngLiteral- und LatLng-Objekte. Wenn eine LatLng-Instanz an den Konstruktor übergeben wird, wird eine Kopie erstellt.

Die möglichen Aufrufe des Konstruktors sind unten aufgeführt:

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

Zugriff durch Anrufen von const {LatLng} = await google.maps.importLibrary("core").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parameter:
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
Erstellt ein LatLng-Objekt, das einen geografischen Punkt darstellt. Der Breitengrad wird in Grad im Bereich [-90, 90] angegeben. Der Längengrad wird in Grad im Bereich [-180, 180) angegeben. Legen Sie noClampNoWrap auf true fest, um Werte außerhalb dieses Bereichs zu aktivieren. Achten Sie auf die Reihenfolge von Breiten- und Längengrad.
equals
equals(other)
Parameter:
Rückgabewert:boolean
Vergleichsfunktion.
lat
lat()
Parameter:Keine
Rückgabewert:number
Gibt die geografische Breite in Grad zurück.
lng
lng()
Parameter:Keine
Rückgabewert:number
Gibt die geografische Länge in Grad zurück.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:LatLngLiteral
Konvertiert in die JSON-Darstellung. Diese Funktion ist für die Verwendung über JSON.stringify vorgesehen.
toString
toString()
Parameter:Keine
Rückgabewert:string
Konvertiert in die Zeichenfolgendarstellung.
toUrlValue
toUrlValue([precision])
Parameter:
  • precisionnumber optional
Rückgabewert:string
Gibt einen String der Form "lat,lng" für dieses LatLng-Objekt zurück. Die Werte der Längen- und Breitengrade werden standardmäßig auf sechs Dezimalstellen gerundet.

LatLngLiteral-Schnittstelle

google.maps.LatLngLiteral-Schnittstelle

An vielen Stellen werden Objektliterale anstelle von LatLng-Objekten akzeptiert. Diese werden in LatLng-Objekte konvertiert, wenn die Maps API auf sie trifft.

Beispiele:

 map.setCenter({lat: -34, lng: 151});
new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

LatLng-Objektliterale werden in der Geometry Library nicht unterstützt.

lat
Typ:number
Breitengrad in Grad Werte werden auf den Bereich [-90, 90] begrenzt. Wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Wenn der Wert größer als 90 ist, wird er auf 90 festgelegt.
lng
Typ:number
Längengrad in Grad Werte außerhalb des Bereichs [–180, 180] werden so umgerechnet, dass sie in diesen Bereich fallen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Das liegt daran, dass sich die Längengrade um die Erde herum erstrecken.

Klasse LatLngBounds

google.maps.LatLngBounds Klasse

Eine LatLngBounds-Instanz stellt ein Rechteck in geografischen Koordinaten dar, einschließlich eines Rechtecks, das den Längengrad von 180 Grad überschreitet.

Zugriff durch Anrufen von const {LatLngBounds} = await google.maps.importLibrary("core").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parameter:
Erstellt ein Rechteck aus den Punkten der südwestlichen und nordöstlichen Ecke.
MAX_BOUNDS LatLngBounds für die maximalen Grenzen der Erde. Diese Grenzen umfassen den gesamten Globus.
contains
contains(latLng)
Parameter:
Rückgabewert:boolean
Gibt true zurück, wenn die angegebene geografische Breite/Länge innerhalb dieser Grenzen liegt.
equals
equals(other)
Parameter:
Rückgabewert:boolean
Gibt true zurück, wenn diese Grenzen ungefähr den angegebenen Grenzen entsprechen.
extend
extend(point)
Parameter:
Rückgabewert:LatLngBounds
Erweitert diese Grenzen, sodass sie den angegebenen Punkt einschließen.
getCenter
getCenter()
Parameter:Keine
Rückgabewert:LatLng
Berechnet den Mittelpunkt dieses LatLngBounds-Objekts.
getNorthEast
getNorthEast()
Parameter:Keine
Rückgabewert:LatLng
Gibt die nordöstliche Ecke dieser Grenzen zurück.
getSouthWest
getSouthWest()
Parameter:Keine
Rückgabewert:LatLng
Gibt die südwestliche Ecke dieser Grenzen zurück.
intersects
intersects(other)
Parameter:
Rückgabewert:boolean
Gibt true zurück, wenn diese Begrenzungspunkte mit der anderen Begrenzungspunkte gemeinsam hat.
isEmpty
isEmpty()
Parameter:Keine
Rückgabewert:boolean
Wird zurückgegeben, wenn die Grenzen leer sind.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:LatLngBoundsLiteral
Konvertiert in die JSON-Darstellung. Diese Funktion ist für die Verwendung über JSON.stringify vorgesehen.
toSpan
toSpan()
Parameter:Keine
Rückgabewert:LatLng
Konvertiert die angegebenen Kartengrenzen in eine lat/lng-Spanne.
toString
toString()
Parameter:Keine
Rückgabewert:string
Konversion in Zeichenkette.
toUrlValue
toUrlValue([precision])
Parameter:
  • precisionnumber optional
Rückgabewert:string
Gibt für diesen Begrenzungsrahmen einen String im Format „lat_lo,lng_lo,lat_hi,lng_hi“ zurück, wobei „lo“ der Südwest- und „hi“ der Nordostecke des Begrenzungsrahmens entspricht.
union
union(other)
Parameter:
Rückgabewert:LatLngBounds
Erweitert diese Grenzen, sodass sie die Verbindung dieser und der angegebenen Grenzen enthalten.

LatLngBoundsLiteral-Schnittstelle

google.maps.LatLngBoundsLiteral-Schnittstelle

Objektliterale werden in der gesamten API anstelle von LatLngBounds-Objekten akzeptiert. Sie werden automatisch in LatLngBounds-Objekte konvertiert. Alle south, west, north und east müssen festgelegt sein, andernfalls wird eine Ausnahme ausgelöst.

east
Typ:number
Östlicher Längengrad in Grad. Werte außerhalb des Bereichs [-180, 180] werden in den Bereich [-180, 180) umgebrochen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Das liegt daran, dass sich die Längengrade um die Erde herum erstrecken.
north
Typ:number
Breitengrad nördlicher Breite in Grad. Werte werden auf den Bereich [-90, 90] begrenzt. Wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Wenn der Wert größer als 90 ist, wird er auf 90 festgelegt.
south
Typ:number
Breitengrad südlicher Breite in Grad. Werte werden auf den Bereich [-90, 90] begrenzt. Wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Wenn der Wert größer als 90 ist, wird er auf 90 festgelegt.
west
Typ:number
Längengrad westlicher Länge in Grad. Werte außerhalb des Bereichs [-180, 180] werden in den Bereich [-180, 180) umgebrochen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Das liegt daran, dass sich die Längengrade um die Erde herum erstrecken.

Klasse LatLngAltitude

google.maps.LatLngAltitude Klasse

Ein LatLngAltitude ist ein 3D-Punkt in geografischen Koordinaten: Breitengrad, Längengrad und Höhe.

  • Der Breitengrad kann zwischen -90 und 90 Grad liegen. Werte ober- oder unterhalb dieses Bereichs werden auf den Bereich [-90, 90] gesetzt. Wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Wenn der Wert größer als 90 ist, wird er auf 90 festgelegt.
  • Der Längengrad umfasst -180 bis 180 Grad. Werte ober- oder unterhalb dieses Bereichs werden so umgerechnet, dass sie in diesen Bereich fallen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Das liegt daran, dass sich die Längengrade um die Erde herum erstrecken.
  • Die Höhe wird in Metern gemessen. Positive Werte geben Höhen über dem Boden an, negative Werte Höhen unter der Erdoberfläche.

Diese Klasse implementiert LatLngAltitudeLiteral.

Diese Klasse implementiert LatLngLiteral.

Zugriff durch Anrufen von const {LatLngAltitude} = await google.maps.importLibrary("core").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parameter:
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Der Initialisierungswert.
  • noClampNoWrapboolean optional Gibt an, ob die Initialisierungswerte beibehalten werden sollen, auch wenn sie nicht unbedingt gültige Breitenwerte im Bereich von [-90, 90] oder gültige Längenwerte im Bereich von [-180, 180] sind. Der Standardwert ist false. Damit werden Breiten- und Längengrad begrenzt.
altitude
Typ:number
Gibt die Höhe zurück.
lat
Typ:number
Gibt den Breitengrad zurück.
lng
Typ:number
Gibt den Längengrad zurück.
equals
equals(other)
Parameter:
  • otherLatLngAltitude optional Ein weiteres LatLngAltitude-Objekt.
Rückgabewert:boolean Gibt an, ob die beiden Objekte gleich sind.
Vergleichsfunktion.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:LatLngAltitudeLiteral Eine JSON-Darstellung dieses Objekts.

LatLngAltitudeLiteral-Schnittstelle

google.maps.LatLngAltitudeLiteral-Schnittstelle

An vielen Stellen werden Objektliterale anstelle von LatLngAltitude-Objekten akzeptiert. Diese werden in LatLngAltitude-Objekte konvertiert, wenn die Maps API auf sie trifft.

Diese Schnittstelle erweitert LatLngLiteral.

altitude
Typ:number
Standard:0
Entfernung (in Metern) über der Erdoberfläche. Ein negativer Wert bedeutet unter der Erdoberfläche.
lat
Typ:number
Breitengrad in Grad Werte werden auf den Bereich [-90, 90] begrenzt. Wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Wenn der Wert größer als 90 ist, wird er auf 90 festgelegt.