Coordinates

Klasse LatLng

google.maps.LatLng Klasse
Bibliothek "core"

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 gesetzt.
  • Der Längengrad umfasst -180 bis 180 Grad. Werte ober- oder unterhalb dieses Bereichs werden so umgerechnet, dass sie in diesen Längengrad-Bereich fallen. Beispiel: Der Wert -190 wird in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass Längengrade den Globus umspannen.
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.
Beachten Sie, dass Sie die Koordinaten eines LatLng nicht ändern können. 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 ä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.

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

const {LatLng} = await google.maps.importLibrary("core");
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 im Bereich [-90, 90] angegeben. Der Längengrad wird in Grad im Bereich [-180, 180) angegeben. Setzen Sie noClampNoWrap auf true, 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 für zwei LatLng-Objekte. Gibt „true“ zurück, wenn die Koordinaten innerhalb von 1e-9 voneinander liegen, andernfalls „false“.
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

Schnittstelle google.maps.LatLngLiteral

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

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] beschränkt. 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 gesetzt.
lng
Typ: number
Längengrad in Grad Werte außerhalb des Bereichs [-180, 180] werden so umgerechnet, dass sie in diesen Bereich fallen. Beispiel: Der Wert -190 wird in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass Längengrade den Globus umspannen.

Klasse LatLngBounds

google.maps.LatLngBounds Klasse
Bibliothek "core"

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

const {LatLngBounds} = await google.maps.importLibrary("core");
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 sich der angegebene Breiten-/Längengrad innerhalb dieser Grenzen befindet.
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)
Rückgabewert: boolean
Gibt true zurück, wenn diese Grenzen gemeinsame Punkte mit den anderen Grenzen haben.
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 im Format „lat_lo,lng_lo,lat_hi,lng_hi“ für diese Grenzen zurück, wobei „lo“ der südwestlichen Ecke des Begrenzungsrahmens und „hi“ der nordöstlichen Ecke entspricht.
union
union(other)
Rückgabewert: LatLngBounds
Erweitert diese Grenzen, sodass sie die Verbindung dieser und der angegebenen Grenzen enthalten.

LatLngBoundsLiteral-Schnittstelle

Schnittstelle google.maps.LatLngBoundsLiteral

In der gesamten API werden Objektliterale 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
Östlicher Längengrad in Grad. Werte außerhalb des Bereichs [-180, 180] werden in den Bereich [-180, 180) umgerechnet. Beispiel: Der Wert -190 wird in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass Längengrade den Globus umspannen.
north
Typ: number
Breitengrad nördlicher Breite in Grad. Die Werte werden auf den Bereich [-90, 90] beschränkt. 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 gesetzt.
south
Typ: number
Südlicher Breitengrad in Grad. Die Werte werden auf den Bereich [-90, 90] beschränkt. 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 gesetzt.
west
Typ: number
Längengrad westlicher Länge in Grad. Werte außerhalb des Bereichs [-180, 180] werden in den Bereich [-180, 180) umgerechnet. Beispiel: Der Wert -190 wird in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass Längengrade den Globus umspannen.

LatLngAltitude-Klasse

google.maps.LatLngAltitude Klasse
implementiert LatLngAltitudeLiteral, LatLngLiteral
Bibliothek "core"

Ein LatLngAltitude ist ein 3D-Punkt in geografischen Koordinaten: Breiten-, 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 gesetzt.
  • Der Längengrad umfasst -180 bis 180 Grad. Werte ober- oder unterhalb dieses Bereichs werden so umgerechnet, dass sie in diesen Längengrad-Bereich fallen. Beispiel: Der Wert -190 wird in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass Längengrade den Globus umspannen.
  • Die Höhe wird in Metern gemessen. Positive Werte geben Höhen über dem Boden an, negative Werte Höhen unter der Erdoberfläche.

const {LatLngAltitude} = await google.maps.importLibrary("core");
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parameter:
  • value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Der Initialisierungswert.
  • noClampNoWrap: boolean optional Gibt an, ob die Initialisierungswerte beibehalten werden sollen, auch wenn sie nicht unbedingt gültige Breitengradwerte im Bereich [-90, 90] oder gültige Längengradwerte im Bereich [-180, 180] sind. Der Standardwert ist false, wodurch die Begrenzung des Breitengrads und der Umbruch des Längengrads aktiviert werden.
altitude
readonly
Typ: number
Gibt die Höhe zurück.
lat
readonly
Typ: number
Gibt den Breitengrad zurück.
lng
readonly
Typ: number
Gibt den Längengrad zurück.
equals
equals(other)
Parameter:
Rückgabewert: boolean Gibt an, ob die beiden Objekte gleich sind.
Vergleichsfunktion für zwei LatLngAltitude-Objekte. Gibt „true“ zurück, wenn die Koordinaten innerhalb von 1e-9 voneinander liegen, andernfalls „false“.
toJSON
toJSON([key])
Parameter:
  • key: string optional
Rückgabewert: LatLngAltitudeLiteral
Wird in ein einfaches Objekt konvertiert.

LatLngAltitudeLiteral-Schnittstelle

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

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

altitude
Typ: number
Abstand (in Metern) über der Bodenoberfläche. Ein negativer Wert bedeutet, dass sich der Punkt unter der Erdoberfläche befindet.
lat
Typ: number
Breitengrad in Grad Die Werte werden auf den Bereich [-90, 90] beschränkt. 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 gesetzt.
lng
Typ: number
Längengrad in Grad Werte außerhalb des Bereichs [-180, 180] werden so umgerechnet, dass sie in diesen Bereich fallen. Beispiel: Der Wert -190 wird in 170 umgewandelt. Ein Wert von 190 wird in -170 umgewandelt. Dies spiegelt die Tatsache wider, dass Längengrade den Globus umspannen.

Point-Klasse

google.maps.Point Klasse
Bibliothek "core"

const {Point} = await google.maps.importLibrary("core");
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.

Klasse Size

google.maps.Size Klasse
Bibliothek "core"

const {Size} = await google.maps.importLibrary("core");
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:
  • other: Size optional
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-Schnittstelle

Schnittstelle google.maps.Padding

bottom
optional
Typ: number optional
Abstand für den unteren Rand in Pixeln.
left
optional
Typ: number optional
Abstand links in Pixeln.
right
optional
Typ: number optional
Abstand rechts in Pixeln.
top
optional
Typ: number optional
Abstand oben in Pixeln.

CircleLiteral-Schnittstelle

google.maps.CircleLiteral interface
extends CircleOptions

Objektliteral, das einen Kreis darstellt.

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

Orientation3D-Klasse

google.maps.Orientation3D Klasse
implementiert Orientation3DLiteral
Bibliothek "core"

Ein Orientation3D ist ein dreidimensionaler Vektor, der für standardmäßige mathematische Rotationstransformationen entlang der Richtung, Neigung und Rollbewegung verwendet wird.

  • Der Kurs 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.

const {Orientation3D} = await google.maps.importLibrary("core");
Orientation3D
Orientation3D(value)
Parameter:
heading
readonly
Typ: number
Standard: 0
Drehung um die Z-Achse (senkrecht zur Erdoberfläche). Der Wert 0 (Standardwert) entspricht 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 Längengrad-Bereich fallen. Beispiel: Der Wert -190 wird in 170 umgewandelt. Ein Wert von 530 wird ebenfalls in 170 umgewandelt.
roll
readonly
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 Längengrad-Bereich fallen. Beispiel: Der Wert -190 wird in 170 umgewandelt. Ein Wert von 530 wird ebenfalls in 170 umgewandelt.
tilt
readonly
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 Längengrad-Bereich fallen. Beispiel: Der Wert -190 wird 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([key])
Parameter:
  • key: string optional
Rückgabewert: Orientation3DLiteral
Wird in ein einfaches Objekt konvertiert.

Orientation3DLiteral-Schnittstelle

Schnittstelle google.maps.Orientation3DLiteral

An vielen Stellen werden Objektliterale anstelle von Orientation3D-Objekten akzeptiert. Diese werden in Orientation3D-Objekte konvertiert, wenn die Google Maps-API sie erkennt.

heading
optional
Typ: number optional
Drehung um die Z-Achse (senkrecht zur Erdoberfläche). Der Wert 0 (Standardwert) entspricht 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 Klasse
implementiert Vector3DLiteral
Bibliothek "core"

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

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

const {Vector3D} = await google.maps.importLibrary("core");
Vector3D
Vector3D(value)
Parameter:
x
readonly
Typ: number
X-Komponente des dreidimensionalen Vektors.
y
readonly
Typ: number
Y-Komponente des dreidimensionalen Vektors.
z
readonly
Typ: number
Z-Komponente des dreidimensionalen Vektors.
equals
equals(other)
Parameter:
Rückgabewert: boolean
Vergleichsfunktion.
toJSON
toJSON([key])
Parameter:
  • key: string optional
Rückgabewert: Vector3DLiteral
Wird in ein einfaches Objekt konvertiert.

Vector3DLiteral-Schnittstelle

Schnittstelle google.maps.Vector3DLiteral

An vielen Stellen werden Objektliterale anstelle von Vector3D-Objekten akzeptiert. Diese werden in Vector3D-Objekte konvertiert, wenn die Google Maps-API sie erkennt.

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