ElevationService-Klasse
google.maps.ElevationService
Klasse
Definiert eine Dienstklasse, die direkt mit Google-Servern kommuniziert, um Daten zur Höhe anzufordern.
Zugriff durch Anrufen von const {ElevationService} = await google.maps.importLibrary("elevation")
.
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
ElevationService |
ElevationService() Parameter:Keine
Erstellt eine neue Instanz von ElevationService , die Höhenanfragen 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 Höhendatenanfrage, die von der ElevationService
gesendet wird und 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 Höhenantwort, die von ElevationService
zurückgegeben wird und die Liste der ElevationResult
enthält, die den Standorten der LocationElevationRequest
entsprechen.
Attribute | |
---|---|
results |
Typ:
Array<ElevationResult> Die Liste der ElevationResult , die den Standorten der LocationElevationRequest entsprechen. |
PathElevationRequest-Schnittstelle
google.maps.PathElevationRequest
-Schnittstelle
Eine von ElevationService
gesendete Höhenabfrage, die den Pfad enthält, entlang dem Stichprobendaten 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 (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 von ElevationService
zurückgegebene Höhenantwort mit der Liste der ElevationResult
s, die gleichmäßig entlang des Pfads des PathElevationRequest
verteilt sind.
Attribute | |
---|---|
results |
Typ:
Array<ElevationResult> Die Liste der ElevationResult , die mit den Beispielen der PathElevationRequest übereinstimmen. |
ElevationResult-Schnittstelle
google.maps.ElevationResult
-Schnittstelle
Das Ergebnis einer ElevationService
-Anfrage, bestehend aus den Höhenkoordinaten und ihren Höhenwerten. Beachten Sie, dass eine einzelne Anfrage mehrere ElevationResult
-Elemente erzeugen kann.
Attribute | |
---|---|
elevation |
Typ:
number Die Höhe dieses Punktes der Erde in Metern über dem Meeresspiegel. |
resolution |
Typ:
number Die Entfernung in Metern zwischen den Stichprobenpunkten, aus denen 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 optional Der Standort dieses Höhenergebnisses. |
ElevationStatus-Konstanten
google.maps.ElevationStatus
Konstanten
Der Status, der von ElevationService
zurückgegeben wird, wenn eine Anfrage zur Erhöhung der Berechtigungen abgeschlossen ist. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'OK'
oder google.maps.ElevationStatus.OK
Zugriff durch Anrufen von const {ElevationStatus} = await google.maps.importLibrary("elevation")
.
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 nicht bekannt. |