ElevationService-Klasse
google.maps.ElevationService
Klasse
Definiert eine Dienstklasse, die direkt mit Google-Servern kommuniziert, um Daten zur Höhe anzufordern.
Zugriff über const {ElevationService} = await google.maps.importLibrary("elevation")
aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
ElevationService |
ElevationService() Parameter:Keine
Erstellt eine neue Instanz eines ElevationService -Objekts, das Höhenabfragen an Google-Server sendet. |
Methoden | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) Parameter:
Rückgabewert:
Promise<PathElevationResponse> Sendet eine Anfrage für Höhenangaben entlang des Pfades; es werden in gleichmäßigen Abständen entlang des Pfades Beispiele mit Höhendaten zurückgegeben. |
getElevationForLocations |
getElevationForLocations(request[, callback]) Parameter:
Rückgabewert:
Promise<LocationElevationResponse> Sendet eine Höhenanfrage für eine Liste diskreter Standorte. |
LocationElevationRequest-Schnittstelle.
google.maps.LocationElevationRequest
-Schnittstelle
Eine vom ElevationService
gesendete Höhenanfrage, die die Liste der diskreten Koordinaten (LatLng
s) enthält, für die Höhendaten zurückgegeben werden sollen.
Attribute | |
---|---|
locations optional |
Typ:
Array<LatLng|LatLngLiteral> optional Die diskreten Standorte, für die Höhendaten abgerufen werden sollen. |
LocationElevationResponse-Schnittstelle
google.maps.LocationElevationResponse
-Schnittstelle
Eine vom ElevationService
zurückgegebene Höhenantwort mit der Liste der ElevationResult
s, die den Standorten von LocationElevationRequest
entsprechen.
Attribute | |
---|---|
results |
Typ:
Array<ElevationResult> Die Liste der ElevationResult , die den Standorten von LocationElevationRequest entsprechen. |
PathElevationRequest-Schnittstelle
google.maps.PathElevationRequest
-Schnittstelle
Eine von ElevationService
gesendete Höhenabfrage mit dem Pfad, entlang dessen Beispieldaten zurückgegeben werden sollen. In dieser Anfrage wird ein kontinuierlicher Pfad entlang der Erde definiert, entlang dessen in gleichmäßigen Abständen Beispieldaten ermittelt werden sollen. Bei allen Pfaden werden von Scheitelpunkt zu Scheitelpunkt Segmente des Großkreises zwischen zwei Entfernungspunkten verwendet.
Attribute | |
---|---|
samples |
Typ:
number Erforderlich. Die Anzahl der gleich weit voneinander entfernten Punkte entlang des Pfades, für die Höhendaten abgerufen werden sollen, einschließlich der Endpunkte. Die Anzahl der Stichproben muss ein Wert zwischen 2 und 512 (jeweils einschließlich) sein. |
path optional |
Typ:
Array<LatLng|LatLngLiteral> optional Der Pfad, entlang dessen Höhenwerte gesammelt werden sollen. |
PathElevationResponse-Schnittstelle
google.maps.PathElevationResponse
-Schnittstelle
Eine vom ElevationService
zurückgegebene Höhenantwort mit der Liste der ElevationResult
s, die entlang des Pfades von PathElevationRequest
gleichmäßig verteilt sind.
Attribute | |
---|---|
results |
Typ:
Array<ElevationResult> Die Liste der ElevationResult , die mit den Stichproben von PathElevationRequest übereinstimmen. |
ElevationResult-Schnittstelle
google.maps.ElevationResult
-Schnittstelle
Das Ergebnis einer ElevationService
-Anfrage, bestehend aus einer Reihe von Höhenkoordinaten und deren zugehörigen Höhenwerten. Eine einzelne Anfrage kann zu mehreren ElevationResult
s führen.
Attribute | |
---|---|
elevation |
Typ:
number Die Höhe dieses Punktes der Erde in Metern über dem Meeresspiegel. |
resolution |
Typ:
number Die Entfernung in Metern zwischen Beispielpunkten, aus denen die Höhe interpoliert wurde. Falls die Auflösung nicht bekannt ist, fehlt diese Eigenschaft. Beachten Sie, dass Höhendaten ungenauer werden (größere resolution -Werte), wenn mehrere Punkte übergeben werden. Ein Punkt sollte einzeln abgefragt werden, um den präzisesten Höhenwert zu erhalten. |
location optional |
Typ:
LatLng optional Der Standort dieses Höhenergebnisses. |
ElevationStatus-Konstanten
google.maps.ElevationStatus
-Konstanten
Der Status, der von ElevationService
nach Abschluss einer Höhenanfrage zurückgegeben wird. Geben Sie diese mit dem Wert oder dem Namen der Konstante an. Beispiel: 'OK'
oder google.maps.ElevationStatus.OK
Zugriff über const {ElevationStatus} = await google.maps.importLibrary("elevation")
aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
INVALID_REQUEST |
Die Anfrage war ungültig. |
OK |
Die Anforderung hat keine Fehler hervorgerufen. |
OVER_QUERY_LIMIT |
Die Anfragebeschränkungen wurden von der Webseite in einem zu geringen Zeitraum überschritten. |
REQUEST_DENIED |
Die Webseite darf den Höhendienst nicht verwenden. |
UNKNOWN_ERROR |
Die Höhenanfrage konnte nicht erfolgreich verarbeitet werden. Der genaue Grund für den Fehler ist jedoch nicht bekannt. |