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 (einschließlich) liegen. Werte ober- oder unterhalb dieses Bereichs werden auf den Bereich [-90, 90] gesetzt. Das heißt, wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Ist der Wert größer als 90, wird er auf 90 gesetzt.
  • Der Längengrad umfasst -180 bis 180 Grad. Werte ober- oder unterhalb dieses Bereichs werden so umgerechnet, dass sie in den Bereich fallen. So wird beispielsweise ein Wert von -190 in 170 umgerechnet. Ein Wert von 190 wird in -170 umgerechnet. Dies spiegelt die Tatsache wider, dass sich die Längengrade um den Globus schlängeln.
Obwohl bei der Standardkartenprojektion der Längengrad der X-Koordinate der Karte und der Breitengrad der Y-Koordinate zugeordnet ist, wird die Breitengradkoordinate immer zuerst gefolgt von dem Längengrad geschrieben.
Die Koordinaten von LatLng können nicht geändert werden. Wenn Sie einen weiteren Punkt berechnen möchten, müssen Sie einen neuen erstellen.

Die meisten Methoden, die LatLng-Objekte akzeptieren, akzeptieren auch ein LatLngLiteral-Objekt. Folgendes ist also äquivalent: 

 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.

Hier die möglichen Aufrufe des Konstruktors: 

 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 über const {LatLng} = await google.maps.importLibrary("core") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parameter:
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean optional
Erstellt ein LatLng-Objekt, das einen geografischen Punkt darstellt. Der Breitengrad wird in Grad innerhalb des Bereichs [-90, 90] angegeben. Der Längengrad wird in Grad innerhalb des Bereichs [-180, 180) angegeben. Legen Sie für noClampNoWrap den Wert true fest, um Werte außerhalb dieses Bereichs zu aktivieren. Beachten Sie die Reihenfolge von Breitengrad 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 eine 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:
  • precision:  number 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

Der Einfachheit halber werden an vielen Orten anstelle von LatLng-Objekten Objektliterale akzeptiert. Sie werden in LatLng-Objekte konvertiert, wenn sie von der Google Maps API erkannt werden.

Beispiele: 

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

LatLng-Objektliterale werden in der Geometriebibliothek nicht unterstützt.
lat
Typ:number
Breitengrad in Grad Die Werte werden auf den Bereich [-90, 90] gesetzt. Das heißt, wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Ist der Wert größer als 90, wird er auf 90 gesetzt.
lng
Typ:number
Längengrad in Grad Werte außerhalb des Bereichs [-180, 180] werden so umgerechnet, dass sie in den Bereich fallen. So wird beispielsweise ein Wert von -190 in 170 umgerechnet. Ein Wert von 190 wird in -170 umgerechnet. Dies spiegelt die Tatsache wider, dass sich die Längengrade um den Globus schlängeln.

LatLngBounds-Klasse

google.maps.LatLngBounds Klasse

Eine LatLngBounds-Instanz stellt ein Rechteck in geografischen Koordinaten dar, einschließlich einer Koordinate, die über dem 180-Grad-Meridian liegt.

Zugriff über const {LatLngBounds} = await google.maps.importLibrary("core") aufrufen. 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 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 Grenzen Punkte mit den anderen Grenzen teilen.
isEmpty
isEmpty()
Parameter:Keine
Rückgabewert:  boolean
Wird zurückgegeben, wenn die Grenzen leer sind.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:  LatLngBoundsLiteral
Konvertiert in eine 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:
  • precision:  number optional
Rückgabewert:  string
Gibt einen String der Form "lat_lo,lng_lo,lat_hi,lng_hi" für diese Grenzen zurück, wobei "lo" der südwestlichen Ecke des Markierungsrahmens und "hi" der nordöstlichen Ecke dieses Rahmens 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

In der gesamten API werden Objektliterale anstelle von LatLngBounds-Objekten akzeptiert. Sie werden automatisch in LatLngBounds-Objekte konvertiert. south, west, north und east müssen festgelegt sein. Andernfalls wird eine Ausnahme ausgelöst.
east
Typ:number
Östliche Länge in Grad Werte außerhalb des Bereichs [-180, 180] werden in den Bereich [-180, 180] umgewandelt. So wird beispielsweise ein Wert von -190 in 170 umgerechnet. Ein Wert von 190 wird in -170 umgerechnet. Dies spiegelt die Tatsache wider, dass sich die Längengrade um den Globus schlängeln.
north
Typ:number
Nördliche Breite in Grad. Die Werte werden auf den Bereich [-90, 90] gesetzt. Das heißt, wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Ist der Wert größer als 90, wird er auf 90 gesetzt.
south
Typ:number
Breitengrad südlicher Breite in Grad. Die Werte werden auf den Bereich [-90, 90] gesetzt. Das heißt, wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Ist der Wert größer als 90, wird er auf 90 gesetzt.
west
Typ:number
Längengrad westlicher Länge in Grad. Werte außerhalb des Bereichs [-180, 180] werden in den Bereich [-180, 180] umgewandelt. So wird beispielsweise ein Wert von -190 in 170 umgerechnet. Ein Wert von 190 wird in -170 umgerechnet. Dies spiegelt die Tatsache wider, dass sich die Längengrade um den Globus schlängeln.

LatLngAltitude-Klasse

google.maps.LatLngAltitude Klasse

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

  • Der Breitengrad kann zwischen -90 und 90 Grad (einschließlich) liegen. Werte ober- oder unterhalb dieses Bereichs werden auf den Bereich [-90, 90] gesetzt. Das heißt, wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Ist der Wert größer als 90, wird er auf 90 gesetzt.
  • Der Längengrad umfasst -180 bis 180 Grad. Werte ober- oder unterhalb dieses Bereichs werden so umgerechnet, dass sie in den Bereich fallen. So wird beispielsweise ein Wert von -190 in 170 umgerechnet. Ein Wert von 190 wird in -170 umgerechnet. Dies spiegelt die Tatsache wider, dass sich die Längengrade um den Globus schlängeln.
  • Die Höhe wird in Metern angegeben. Positive Werte geben Höhen über Bodenhöhe an, negative Werte die Höhen unter der Bodenoberfläche an.

Mit dieser Klasse wird LatLngAltitudeLiteral implementiert.

Mit dieser Klasse wird LatLngLiteral implementiert.

Zugriff über const {LatLngAltitude} = await google.maps.importLibrary("core") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parameter:
  • value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Der Wert, der initialisiert wird.
  • noClampNoWrap:  boolean optional Gibt an, ob die Initialisierungswerte beibehalten werden sollen, auch wenn es sich nicht unbedingt um gültige Breitengradwerte im Bereich [-90, 90] oder gültige Längengradwerte im Bereich von [-180, 180] handelt. Der Standardwert ist false. Damit werden die Breitengradbeschränkungen und der Längengradumbruch aktiviert.
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:
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

Der Einfachheit halber werden an vielen Orten anstelle von LatLngAltitude-Objekten Objektliterale akzeptiert. Sie werden in LatLngAltitude-Objekte konvertiert, wenn sie von der Google Maps API erkannt werden.

Diese Schnittstelle erweitert LatLngLiteral.

altitude
Typ:number
Standardwert: 0
Entfernung (in Metern) über dem Boden. Ein negativer Wert bedeutet, dass der Wert unterhalb der Bodenoberfläche liegt.
lat
Typ:number
Breitengrad in Grad Die Werte werden auf den Bereich [-90, 90] gesetzt. Das heißt, wenn der angegebene Wert kleiner als -90 ist, wird er auf -90 gesetzt. Ist der Wert größer als 90, wird er auf 90 gesetzt.
lng
Typ:number
Längengrad in Grad Werte außerhalb des Bereichs [-180, 180] werden so umgerechnet, dass sie in den Bereich fallen. So wird beispielsweise ein Wert von -190 in 170 umgerechnet. Ein Wert von 190 wird in -170 umgerechnet. Dies spiegelt die Tatsache wider, dass sich die Längengrade um den Globus schlängeln.

Point-Klasse

google.maps.Point Klasse

Zugriff über const {Point} = await google.maps.importLibrary("core") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Point
Point(x, y)
Parameter:
  • x:  number
  • y:  number
Ein Punkt auf einer zweidimensionale Ebene.
x
Typ:number
Die X-Koordinate.
y
Typ:number
Die Y-Koordinate.
equals
equals(other)
Parameter:
Rückgabewert:  boolean
Vergleicht zwei Punkte.
toString
toString()
Parameter:Keine
Rückgabewert:  string
Gibt eine Darstellung dieses Punkts als Zeichenfolge zurück.

Size-Klasse

google.maps.Size Klasse

Zugriff über const {Size} = await google.maps.importLibrary("core") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Size
Size(width, height[, widthUnit, heightUnit])
Parameter:
  • width:  number
  • height:  number
  • widthUnit:  string optional
  • heightUnit:  string optional
Zweidimensionale Größe, wobei die Breite der Abstand auf der x-Achse und die Höhe der Abstand auf der y-Achse ist.
height
Typ:number
Die Höhe entlang der Y-Achse in Pixeln.
width
Typ:number
Die Breite entlang der X-Achse in Pixeln.
equals
equals(other)
Parameter:
Rückgabewert:  boolean
Vergleicht zwei Größen.
toString
toString()
Parameter:Keine
Rückgabewert:  string
Gibt eine Darstellung dieser Größe als Zeichenfolge zurück.

Padding-Oberfläche

google.maps.Padding-Schnittstelle

bottom optional
Typ:number optional
Abstand für den unteren Rand in Pixeln.
left optional
Typ:number optional
Abstand für den linken Rand in Pixeln.
right optional
Typ:number optional
Abstand für den rechten Rand in Pixeln.
top optional
Typ:number optional
Abstand für den oberen Rand in Pixeln

CircleLiteral-Oberfläche

google.maps.CircleLiteral-Schnittstelle

Objektliteral, das einen Kreis darstellt.

Diese Schnittstelle erweitert CircleOptions.

center
In der Mitte des Kreises
radius
Typ:number
Der Radius auf der Erdoberfläche in Metern.
Übernommen: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex