Coordinates

LatLng-Klasse

google.maps.LatLng Kurs

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

  • Der Breitengrad kann zwischen -90 und 90 Grad liegen. Werte außerhalb dieses Bereichs werden auf den Bereich [−90, 90] begrenzt. Wenn der angegebene Wert also unter -90 liegt, 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 diesen Bereich fallen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass die Längengrade den Globus umrunden.
In der Standardkartenprojektion wird der Längengrad der X-Koordinate der Karte und der Breitengrad der Y-Koordinate zugeordnet. Die Breitengradkoordinate wird jedoch immer zuerst geschrieben, gefolgt vom Längengrad.
 Die Koordinaten eines 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. Daher sind die folgenden Anweisungen äquivalent:

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

Der Konstruktor akzeptiert auch LatLngLiteral- und LatLng-Objekte. Wenn dem Konstruktor eine LatLng-Instanz ü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);

Rufe const {LatLng} = await google.maps.importLibrary("core") auf, um auf die Daten zuzugreifen. 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 zuzulassen. 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
Wandelt in eine JSON-Darstellung um. 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 Benutzeroberfläche

Objektliterale werden an vielen Stellen anstelle von LatLng-Objekten akzeptiert. Diese werden in LatLng-Objekte umgewandelt, wenn sie in der Maps API gefunden werden.

Beispiele:

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

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

lat
Typ:number
Breitengrad in Grad Die Werte werden auf den Bereich [-90, 90] begrenzt. Wenn der angegebene Wert also unter -90 liegt, 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 diesen Längengrad-Bereich fallen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass die Längengrade den Globus umrunden.

Klasse LatLngBounds

google.maps.LatLngBounds Kurs

Eine LatLngBounds-Instanz stellt ein Rechteck in geografischen Koordinaten dar, auch wenn es den Längengrad 180 schneidet.

Rufe const {LatLngBounds} = await google.maps.importLibrary("core") auf, um auf die Daten zuzugreifen. 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 in diesem Bereich 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 Begrenzung Punkte mit den anderen Begrenzungen gemeinsam hat.
isEmpty
isEmpty()
Parameter:Keine
Rückgabewert:boolean
Wird zurückgegeben, wenn die Grenzen leer sind.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:LatLngBoundsLiteral
Wandelt in eine JSON-Darstellung um. 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 diese Grenzen einen String vom Typ „lat_lo,lng_lo,lat_hi,lng_hi“ zurück, wobei „lo“ der Südwestecke des Begrenzungsrahmens und „hi“ der Nordostecke 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 Benutzeroberfläche

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

east
Typ:number
Längengrad östlicher Länge in Grad. Werte außerhalb des Bereichs [−180, 180] werden auf den Bereich [−180, 180] umgeschlagen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass die Längengrade den Globus umrunden.
north
Typ:number
Breitengrad nördlicher Breite in Grad. Die Werte werden auf den Bereich [-90, 90] begrenzt. Wenn der angegebene Wert also unter -90 liegt, 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] begrenzt. Wenn der angegebene Wert also unter -90 liegt, 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 auf den Bereich [−180, 180] umgeschlagen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass die Längengrade den Globus umrunden.

Klasse LatLngAltitude

google.maps.LatLngAltitude Kurs

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

  • Der Breitengrad kann zwischen -90 und 90 Grad liegen. Werte außerhalb dieses Bereichs werden auf den Bereich [−90, 90] begrenzt. Wenn der angegebene Wert also unter -90 liegt, 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 diesen Bereich fallen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass die Längengrade den Globus umrunden.
  • Die Höhe wird in Metern gemessen. Positive Werte geben Höhen über dem Meeresspiegel an, negative Werte Höhen unter der Erdoberfläche.

Diese Klasse implementiert LatLngAltitudeLiteral.

Diese Klasse implementiert LatLngLiteral.

Rufe const {LatLngAltitude} = await google.maps.importLibrary("core") auf, um auf die Daten zuzugreifen. 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 Breiten- oder Längengrade im Bereich [-90, 90] bzw. [-180, 180] sind. Standardmäßig ist false festgelegt, wodurch die Begrenzung des Breitengrads und das Überspringen des Längengrads aktiviert werden.
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 JSON-Darstellung dieses Objekts.

Schnittstelle LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral Benutzeroberfläche

Objektliterale werden an vielen Stellen anstelle von LatLngAltitude-Objekten akzeptiert. Diese werden in LatLngAltitude-Objekte umgewandelt, wenn sie in der Maps API gefunden werden.

Diese Schnittstelle erweitert LatLngLiteral.

altitude
Typ:number
Standard:0
Abstand (in Metern) über der Bodenoberfläche. Ein negativer Wert bedeutet, dass sich die Position unter der Erdoberfläche befindet.
lat
Typ:number
Breitengrad in Grad Die Werte werden auf den Bereich [-90, 90] begrenzt. Wenn der angegebene Wert also unter -90 liegt, 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 diesen Längengrad-Bereich fallen. Ein Wert von -190 wird beispielsweise in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass die Längengrade den Globus umrunden.

Punkt klasse

google.maps.Point Kurs

Rufe const {Point} = await google.maps.importLibrary("core") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Point
Point(x, y)
Parameter: 
  • xnumber
  • ynumber
Ein Punkt auf einer zweidimensionale Ebene.
x
Typ:number
Die X-Koordinate.
y
Typ:number
Die Y-Koordinate.
equals
equals(other)
Parameter: 
  • otherPoint optional
Rückgabewert:boolean
Vergleicht zwei Punkte.
toString
toString()
Parameter:Keine
Rückgabewert:string
Gibt eine Darstellung dieses Punkts als Zeichenfolge zurück.

Größenklasse

google.maps.Size Kurs

Rufe const {Size} = await google.maps.importLibrary("core") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Size
Size(width, height[, widthUnit, heightUnit])
Parameter: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring 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.

Abstand

google.maps.Padding Benutzeroberfläche

bottom optional
Typ:number optional
Abstand nach unten in Pixeln.
left optional
Typ:number optional
Abstand links in Pixeln.
right optional
Typ:number optional
Abstand nach rechts in Pixeln.
top optional
Typ:number optional
Abstand oben in Pixeln.

CircleLiteral-Schnittstelle

google.maps.CircleLiteral Benutzeroberfläche

Objektliteral, das einen Kreis darstellt.

Diese Schnittstelle erweitert CircleOptions.

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

Klasse Orientation3D

google.maps.Orientation3D Kurs

Ein Orientation3D ist ein dreidimensionaler Vektor, der für standardmäßige mathematische Drehtransformationen entlang von Kurs, Neigung und Roll verwendet wird.

  • „heading“ ist ein Winkel im Bereich [0, 360] Grad.
  • „tilt“ ist ein Winkel im Bereich [0, 360] Grad.
  • „Roll“ ist ein Winkel im Bereich [0, 360] Grad.

Diese Klasse implementiert Orientation3DLiteral.

Rufe const {Orientation3D} = await google.maps.importLibrary("core") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Orientation3D
Orientation3D(value)
Parameter: 
heading
Typ:number
Standard:0
Drehung um die Z‑Achse (senkrecht zur Erdoberfläche). Der Wert „0“ (Standard) entspricht dem Norden. Eine positive Drehung erfolgt im Uhrzeigersinn um die Z‑Achse und wird in Grad von 0 bis 360 angegeben. 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 530 wird ebenfalls in 170 umgewandelt.
roll
Typ:number
Standard:0
Drehung um die y-Achse. Eine positive Drehung erfolgt im Uhrzeigersinn um die Y-Achse und wird in Grad von 0 bis 360 angegeben. 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 530 wird ebenfalls in 170 umgewandelt.
tilt
Typ:number
Standard:0
Drehung um die X-Achse. Eine positive Drehung erfolgt im Uhrzeigersinn um die X-Achse und wird in Grad von 0 bis 360 angegeben. 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 530 wird ebenfalls in 170 umgewandelt.
equals
equals(other)
Parameter: 
Rückgabewert:boolean Gibt an, ob die beiden Objekte gleich sind.
Vergleichsfunktion.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:Orientation3DLiteral
Wandelt in eine JSON-Darstellung um. Diese Funktion ist für die Verwendung über JSON.stringify vorgesehen.

Orientation3DLiteral-Schnittstelle

google.maps.Orientation3DLiteral Benutzeroberfläche

Objektliterale werden an vielen Stellen anstelle von Orientation3D-Objekten akzeptiert. Diese werden in Orientation3D-Objekte umgewandelt, wenn sie in der Maps API gefunden werden.

heading optional
Typ:number optional
Drehung um die Z‑Achse (senkrecht zur Erdoberfläche). Der Wert „0“ (Standard) entspricht dem Norden. Eine positive Drehung erfolgt im Uhrzeigersinn um die Z‑Achse und wird in Grad von 0 bis 360 angegeben.
roll optional
Typ:number optional
Drehung um die y-Achse. Eine positive Drehung erfolgt im Uhrzeigersinn um die Y-Achse und wird in Grad von 0 bis 360 angegeben.
tilt optional
Typ:number optional
Drehung um die X-Achse. Eine positive Drehung erfolgt im Uhrzeigersinn um die X-Achse und wird in Grad von 0 bis 360 angegeben.

Vector3D-Klasse

google.maps.Vector3D Kurs

Ein Vector3D ist ein dreidimensionaler Vektor, der für standardmäßige mathematische Operationen verwendet wird, z. B. zum Skalieren der Grenzen dreidimensionaler Objekte entlang der lokalen X-, Y- und Z-Achsen.

  • x ist eine reelle Zahl.
  • y ist eine reelle Zahl.
  • z ist eine reelle Zahl.

Diese Klasse implementiert Vector3DLiteral.

Rufe const {Vector3D} = await google.maps.importLibrary("core") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

Vector3D
Vector3D(value)
Parameter: 
x
Typ:number
X-Komponente des dreidimensionalen Vektors.
y
Typ:number
Y-Komponente des dreidimensionalen Vektors.
z
Typ:number
Z‑Komponente des dreidimensionalen Vektors.
equals
equals(other)
Parameter: 
Rückgabewert:boolean
Vergleichsfunktion.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:Vector3DLiteral
Wandelt in eine JSON-Darstellung um. Diese Funktion ist für die Verwendung über JSON.stringify vorgesehen.

Vector3DLiteral-Schnittstelle

google.maps.Vector3DLiteral Benutzeroberfläche

Objektliterale werden an vielen Stellen anstelle von Vector3D-Objekten akzeptiert. Diese werden in Vector3D-Objekte umgewandelt, wenn sie in der Maps API gefunden werden.

x
Typ:number
X-Komponente des dreidimensionalen Vektors.
y
Typ:number
Y-Komponente des dreidimensionalen Vektors.
z
Typ:number
Z‑Komponente des dreidimensionalen Vektors.