Diese Seite wurde von der Cloud Translation API übersetzt.

Höhenanfragen und -antworten

Höhendaten anfragen

Elevation API-Anfragen werden als URL-String erstellt. Die API gibt Höhendaten für Standorte auf der Erde zurück. Sie können Standortdaten auf zwei Arten angeben:

Als ein oder mehrere locations
Als Reihe verbundener Punkte entlang einer path.

Bei beiden Ansätzen werden Breiten- und Längengrade verwendet, um die Standorte oder Pfadknoten zu identifizieren. In diesem Dokument wird das erforderliche Format von Elevation API-URLs und die verfügbaren Parameter beschrieben.

Die Elevation API gibt Daten für Abfragen an einzelnen Punkten mit der höchstmöglichen Genauigkeit zurück. Bei Batchabfragen mit mehreren Standorten werden möglicherweise weniger genaue Daten zurückgegeben, insbesondere wenn die Standorte weit voneinander entfernt sind, da die Daten geglättet werden.

Eine Elevation API-Anfrage hat folgendes Format:

https://maps.googleapis.com/maps/api/elevation/outputFormat?parameters

Dabei kann outputFormat einen der folgenden Werte haben:

json (empfohlen): Gibt die Ausgabe in JavaScript Object Notation (JSON) an.
xml: Gibt die Ausgabe in XML an, die in einem <ElevationResponse>-Knoten eingehüllt ist.

Hinweis: URLs müssen richtig codiert sein, um gültig zu sein. Außerdem sind sie für alle Webdienste auf 16.384 Zeichen beschränkt. Beachten Sie diese Einschränkung beim Erstellen Ihrer URLs. Beachten Sie auch, dass verschiedene Browser, Proxys und Server möglicherweise unterschiedliche URL-Zeichenbeschränkungen haben.

Bei Anfragen mit API-Schlüssel ist HTTPS erforderlich.

Anfrageparameter

Für Anfragen an die Elevation API werden unterschiedliche Parameter verwendet, je nachdem, ob es sich um einzelne Orte oder um einen sortierten Pfad handelt. Für einzelne Orte werden bei Anfragen zur Höhe Daten zu den in der Anfrage übergebenen Orten zurückgegeben. Bei Pfaden werden Höhenanfragen stattdessen entlang des angegebenen Pfads gemustert.

Wie in allen URLs üblich, werden Parameter mit dem Et-Zeichen (&) getrennt. Die Liste der Parameter und ihre möglichen Werte finden Sie unten.

Alle Anfragen

key – (erforderlich) Der API-Schlüssel Ihrer Anwendung. Dieser Schlüssel kennzeichnet Ihre Anwendung zum Zweck der Kontingentverwaltung. Weitere Informationen zum Abrufen eines Schlüssels

Standortanfragen

locations (erforderlich): definiert die Standorte auf der Erde, für die Höhendaten zurückgegeben werden sollen. Dieser Parameter kann entweder einen einzelnen Standort als kommagetrenntes Paar {latitude,longitude} (z.B. „40.714728,-73.998672“) oder mehrere Breiten-/Längengradpaare als Array oder als codierte Polylinie annehmen. Für diesen Parameter gilt ein Limit von 512 Punkten. Weitere Informationen finden Sie unten unter Standorte angeben.

Anfragen zu Stichproben entlang von Pfaden

path (erforderlich): definiert einen Pfad auf der Erde, für den Höhendaten zurückgegeben werden sollen. Dieser Parameter definiert einen Satz von zwei oder mehr geordneten Paaren aus Breiten- und Längengrad,die einen Pfad entlang der Erdoberfläche definieren. Dieser Parameter muss in Verbindung mit dem unten beschriebenen Parameter samples verwendet werden. Für diesen Parameter gilt eine Obergrenze von 512 Punkten. Weitere Informationen finden Sie unten unter Pfade angeben.
samples (erforderlich): gibt die Anzahl der Beispielpunkte entlang eines Pfades an, für die Höhendaten zurückgegeben werden sollen. Der samples-Parameter unterteilt den angegebenen path in einen geordneten Satz von Punkten, die sich in gleichen Abständen entlang des Pfades befinden.

Standorte angeben

Positionsabfragen werden mit dem Parameter locations angegeben. Dabei werden Höhenanfragen für die jeweiligen Standorte als Breiten-/Längengradwerte übergeben.

Der Parameter locations kann die folgenden Argumente annehmen:

Eine einzelne Koordinate: locations=40.714728,-73.998672
Ein Array von Koordinaten, die durch das Pipe-Zeichen (|) getrennt sind: locations=40.714728,-73.998672|-34.397,150.644
Eine Reihe von codierten Koordinaten mit dem Algorithmus für codierte Polylinien: locations=enc:gfo}EtohhU

Strings für Breiten- und Längengradkoordinaten werden mit Ziffern in einem kommagetrennten Textstring definiert. „40.714728,-73.998672“ ist beispielsweise ein gültiger locations-Wert. Die Werte für Breiten- und Längengrad müssen einem gültigen Ort auf der Erde entsprechen. Breitengrade können jeden Wert zwischen -90 und 90 haben, während Längengrade jeden Wert zwischen -180 und 180 haben können. Wenn Sie einen ungültigen Breiten- oder Längengrad angeben, wird Ihre Anfrage als fehlerhafte Anfrage abgelehnt.

Sie können bis zu 512 Koordinaten in einem Array oder einer codierten Polylinie übergeben und trotzdem eine gültige URL erstellen. Wenn Sie mehrere Koordinaten übergeben, ist die Genauigkeit der zurückgegebenen Daten möglicherweise geringer als bei der Anforderung von Daten für eine einzelne Koordinate. Wenn Sie in den Parametern „locations“ oder „path“ mehr als 512 Punkte oder Koordinaten angeben, wird eine INVALID_REQUEST-Antwort zurückgegeben.

Pfade angeben

Anfragen für Stichprobenpfade werden mit den Parametern path und samples angegeben. Sie geben an, dass in bestimmten Intervallen Höhendaten entlang eines Pfades angefordert werden sollen. Wie bei Positionsanfragen mit dem Parameter locations gibt der Parameter path eine Reihe von Breiten- und Längengradwerten an. Im Gegensatz zu einer Positionsanfrage gibt path jedoch eine geordnete Reihe von Eckpunkten an. Anstatt nur an den Knoten Höhendaten zurückzugeben, werden bei Pfad-Anfragen entlang des Pfads Stichproben erhoben. Dabei wird die Anzahl der angegebenen samples (einschließlich der Endpunkte) berücksichtigt.

Der Parameter path kann einen der folgenden Argumente haben:

Ein Array aus zwei oder mehr durch Kommas getrennten Textstrings mit Koordinaten, die durch den senkrechten Strich (|) getrennt sind: path=40.714728,-73.998672|-34.397,150.644
Codierte Koordinaten mit dem Algorithmus für codierte Polylinien: path=enc:gfo}EtohhUxD@bAxJmGF

Strings für Breiten- und Längengradkoordinaten werden mit Ziffern in einem durch Kommas getrennten Textstring definiert. „40.714728,-73.998672|-34.397, 150.644“ ist beispielsweise ein gültiger path-Wert. Die Breiten- und Längengradwerte müssen einem gültigen Ort auf der Erde entsprechen. Breitengrade können jeden Wert zwischen -90 und 90 haben, während Längengrade jeden Wert zwischen -180 und 180 haben können. Wenn Sie einen ungültigen Breiten- oder Längengrad angeben, wird Ihre Anfrage als fehlerhafte Anfrage abgelehnt.

Antworten auf Höhenanfragen

Für jede gültige Anfrage gibt der Elevation-Dienst eine Elevation-Antwort im Format zurück, das in der Anfrage-URL angegeben ist.

ElevationResponse

Field	Required	Type	Description
`results`	required	Array<ElevationResult>	See ElevationResult for more information.
`status`	required	ElevationStatus	See ElevationStatus for more information.
`error_message`	optional	string	When the service returns a status code other than `OK`, there may be an additional `error_message` field within the response object. This field contains more detailed information about thereasons behind the given status code. This field is not always returned, and its content is subject to change.

ElevationStatus

Status codes returned by service.

OK indicating the API request was successful.
DATA_NOT_AVAILABLE indicating that there's no available data for the input locations.
INVALID_REQUEST indicating the API request was malformed.
OVER_DAILY_LIMIT indicating any of the following:
- The API key is missing or invalid.
- Billing has not been enabled on your account.
- A self-imposed usage cap has been exceeded.
- The provided method of payment is no longer valid (for example, a credit card has expired).
OVER_QUERY_LIMIT indicating the requestor has exceeded quota.
REQUEST_DENIED indicating the API did not complete the request.
UNKNOWN_ERROR indicating an unknown error.

Wenn der Statuscode nicht OK ist, kann das Antwortobjekt „Elevation“ ein zusätzliches Feld error_message enthalten. Dieses Feld enthält detailliertere Informationen zu den Gründen für den angegebenen Statuscode.

Die Antwort enthält ein results-Array mit den folgenden Elementen:

ElevationResult

Field	Required	Type	Description
`elevation`	required	number	The elevation of the location in meters.
`location`	required	LatLngLiteral	A location element of the position for which elevation data is being computed. Note that for path requests, the set of location elements will contain the sampled points along the path. See LatLngLiteral for more information.
`resolution`	optional	number	The value indicating the maximum distance between data points from which the elevation was interpolated, in meters. This property will be missing if the resolution is not known. Note that elevation data becomes more coarse (larger resolution values) when multiple points are passed. To obtain the most accurate elevation value for a point, it should be queried independently.

Das location-Objekt hat die folgenden Elemente:

LatLngLiteral

An object describing a specific location with Latitude and Longitude in decimal degrees.

Field	Required	Type	Description
`lat`	required	number	Latitude in decimal degrees
`lng`	required	number	Longitude in decimal degrees

Beispiele für die Positionshöhe

Im folgenden Beispiel wird die Höhe von Denver, Colorado, der „Mile High City“, im JSON-Format angefordert:

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

Das folgende Beispiel zeigt mehrere Antworten (für Denver, Colorado und Death Valley, Kalifornien).

In dieser Anfrage wird das JSON-output-Flag verwendet:

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034%7C36.455556%2C-116.866667
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034%7C36.455556%2C-116.866667&key=YOUR_API_KEY'

In dieser Anfrage wird das XML-Flag output verwendet:

https://maps.googleapis.com/maps/api/elevation/xml?locations=39.7391536,-104.9847034|36.455556,-116.866667&key=YOUR_API_KEY

Wählen Sie die Tabs unten aus, um die Beispiel-JSON- und -XML-Antworten aufzurufen.

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
      {
        "elevation": -52.79492568969727,
        "location": { "lat": 36.455556, "lng": -116.866667 },
        "resolution": 19.08790397644043,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
 <result>
  <location>
   <lat>36.4555560</lat>
   <lng>-116.8666670</lng>
  </location>
  <elevation>-52.7949257</elevation>
  <resolution>19.0879040</resolution>
 </result>
</ElevationResponse>

In den folgenden Beispielen werden Höhendaten entlang einer geraden Liniepath von Mt. Whitney, Kalifornien, nach Badwater, Kalifornien, angefordert, dem höchsten und dem niedrigsten Punkt auf dem nordamerikanischen Festland. Wir benötigen drei samples, also die beiden Endpunkte und den Mittelpunkt.

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?path=36.578581%2C-118.291994%7C36.23998%2C-116.83171
  &samples=3
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?path=36.578581%2C-118.291994%7C36.23998%2C-116.83171&samples=3&key=YOUR_API_KEY'

JSON

{
  "results":
    [
      {
        "elevation": 4411.94189453125,
        "location": { "lat": 36.578581, "lng": -118.291994 },
        "resolution": 19.08790397644043,
      },
      {
        "elevation": 1372.8359375,
        "location": { "lat": 36.41150289067028, "lng": -117.5602607523847 },
        "resolution": 9.543951988220215,
      },
      {
        "elevation": -84.51690673828125,
        "location": { "lat": 36.23998, "lng": -116.83171 },
        "resolution": 9.543951988220215,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>36.5785810</lat>
   <lng>-118.2919940</lng>
  </location>
  <elevation>4411.9418945</elevation>
  <resolution>19.0879040</resolution>
 </result>
 <result>
  <location>
   <lat>36.4115029</lat>
   <lng>-117.5602608</lng>
  </location>
  <elevation>1372.8359375</elevation>
  <resolution>9.5439520</resolution>
 </result>
 <result>
  <location>
   <lat>36.2399800</lat>
   <lng>-116.8317100</lng>
  </location>
  <elevation>-84.5169067</elevation>
  <resolution>9.5439520</resolution>
 </result>
</ElevationResponse>

Höhenanfragen und -antworten

Höhendaten anfragen

Anfrageparameter

Alle Anfragen

Standortanfragen

Anfragen zu Stichproben entlang von Pfaden

Standorte angeben

Pfade angeben

Antworten auf Höhenanfragen

ElevationResponse

`results`

`status`

`error_message`

ElevationStatus

ElevationResult

`elevation`

`location`

`resolution`

LatLngLiteral

`lat`

`lng`

Beispiele für die Positionshöhe

URL

cURL

JSON

XML

URL

cURL

JSON

XML

URL

cURL

JSON

XML