Klasse ElevationService
google.maps.ElevationService
Klasse
Bibliothek "elevation"
Definiert eine Dienstklasse, die direkt mit Google-Servern kommuniziert, um Daten zur Höhe anzufordern.
const {ElevationService} = await google.maps.importLibrary("elevation");
Konstruktor | |
|---|---|
ElevationService |
ElevationService()Parameter: Keine
Erstellt eine neue Instanz von ElevationService, die 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
Schnittstelle google.maps.LocationElevationRequest
Eine Höhenanfrage, die von ElevationService gesendet wird und die Liste der einzelnen Koordinaten (LatLngs) enthält, für die Höhendaten zurückgegeben werden sollen.
Attribute | |
|---|---|
locations
optional |
Typ:
Array<LatLng|LatLngLiteral> optionalDie diskreten Standorte, für die Höhendaten abgerufen werden sollen. |
LocationElevationResponse-Schnittstelle
Schnittstelle google.maps.LocationElevationResponse
Eine Höhenantwort, die von der ElevationService zurückgegeben wird und die Liste der ElevationResults enthält, die den Standorten der LocationElevationRequest entsprechen.
Attribute | |
|---|---|
results |
Typ:
Array<ElevationResult>Die Liste der ElevationResults, die den Standorten der LocationElevationRequest entsprechen. |
PathElevationRequest-Schnittstelle
Schnittstelle google.maps.PathElevationRequest
Eine Höhenabfrage, die von der ElevationService gesendet wird und den Pfad enthält, entlang dessen erhobene Stichproben 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:
numberErforderlich. 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 (einschließlich) sein. |
path
optional |
Typ:
Array<LatLng|LatLngLiteral> optionalDer Pfad, entlang dessen Höhenwerte gesammelt werden sollen. |
PathElevationResponse-Schnittstelle
Schnittstelle google.maps.PathElevationResponse
Eine Höhenantwort, die von der ElevationService zurückgegeben wird und die Liste der ElevationResults enthält, die in gleichmäßigen Abständen entlang des Pfads der PathElevationRequest verteilt sind.
Attribute | |
|---|---|
results |
Typ:
Array<ElevationResult>Die Liste der ElevationResults, die den Beispielen des PathElevationRequest entsprechen. |
ElevationResult-Schnittstelle
Schnittstelle google.maps.ElevationResult
Das Ergebnis einer ElevationService-Anfrage, bestehend aus einer Reihe von Höhenkoordinaten und ihren Höhenwerten. Beachten Sie, dass eine einzelne Anfrage mehrere ElevationResults erzeugen kann.
Attribute | |
|---|---|
elevation |
Typ:
numberDie Höhe dieses Punktes der Erde in Metern über dem Meeresspiegel. |
resolution |
Typ:
numberDie Entfernung in Metern zwischen den Stichprobenpunkten, von denen aus die Höhe interpoliert wurde. Falls die Auflösung nicht bekannt ist, fehlt diese Eigenschaft. Beachten Sie, dass Höhendaten ungenauer werden und somit größere resolution-Werte haben, wenn mehrere Punkte übergeben werden. Um einen möglichst genauen Höhenwert für einen Punkt zu erhalten, sollte er einzeln abgefragt werden. |
location
optional |
Typ:
LatLng optionalDer Standort dieses Höhenergebnisses. |
ElevationStatus-Konstanten
google.maps.ElevationStatus
Konstanten
Bibliothek "elevation"
Der Status, der von der ElevationService nach Abschluss einer Anfrage zur Höhenbestimmung zurückgegeben wird. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'OK'oder google.maps.ElevationStatus.OK
Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ ElevationStatusString definiert.
const {ElevationStatus} = await google.maps.importLibrary("elevation");
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 ist nicht dazu berechtigt, den „Elevation“-Dienst zu verwenden. |
UNKNOWN_ERROR |
Die Höhenanfrage konnte nicht verarbeitet werden. Der genaue Grund für den Fehler ist nicht bekannt. |