Höhenanfragen
Elevation API-Anfragen werden als URL-String erstellt. Die API gibt Höhendaten für Standorte auf der Erde zurück. Sie geben Standortdaten an. haben Sie zwei Möglichkeiten:
- Als Satz aus einem oder mehreren
locations
. - als eine Reihe verbundener Punkte entlang eines
path
.
Bei beiden Ansätzen werden Breitengrad/Längengrad-Koordinaten zur Identifizierung des oder Pfadeckpunkte. In diesem Dokument wird das erforderliche Format Elevation API-URLs und die verfügbaren Parameter.
Das Elevation API gibt Daten für Einzelpunktabfragen zurück mit der höchstmöglichen Genauigkeit. Batchabfragen mit mehreren Standorten Die Daten werden möglicherweise mit einer geringeren Genauigkeit zurückgegeben, insbesondere wenn die Standorte verteilt sind. da eine gewisse Datenglättung auftritt.
Eine Elevation API-Anfrage weist die folgende Form auf:
https://maps.googleapis.com/maps/api/elevation/outputFormat?parameters
Dabei kann outputFormat
einer der folgenden Werte sein:
json
(empfohlen): gibt die Ausgabe an JavaScript Object Notation (JSON) oderxml
gibt eine Ausgabe in XML an, eingeschlossen in einem<ElevationResponse>
Knoten.
Hinweis: URLs müssen ordnungsgemäß codiert gültig und auf 16.384 Zeichen für alle Webdienste beschränkt. Berücksichtigen Sie diese Beschränkung beim Erstellen Ihrer URLs. Verschiedene Browser, Proxys und Server können auch andere Zeichenbeschränkungen für URLs haben.
Bei Anfragen mit API-Schlüssel ist HTTPS erforderlich.
Anfrageparameter
Anfragen an die Elevation API verwenden unterschiedliche Parameter je nachdem, ob die Anfrage für einzelne Standorte oder geordneten Pfads. Für einzelne Standorte geben Höhenanfragen Daten zu den spezifischen Standorten, die in der Anfrage übergeben wurden für Pfade, Für Höhenanfragen werden stattdessen Stichproben des angegebenen Pfads erfasst.
Wie bei allen URLs üblich, werden die Parameter
Verwenden Sie dazu das kaufmännische Und-Zeichen (&
). Die Liste der Parameter
und ihre möglichen Werte sind unten aufgeführt.
Alle Anfragen
key
: (erforderlich): Die API-Schlüssel. Dieser Schlüssel kennzeichnet Ihre Anwendung zum Zweck der Kontingentverwaltung. Weitere Informationen zum Abrufen eines Schlüssels
Positionsanfragen
locations
(erforderlich) definiert die Standorte auf der Erde, für die Höhendaten zurückgegeben werden sollen. Dieser Parameter nimmt entweder Einzelner Standort als kommagetrenntes {Breitengrad,Längengrad}-Paar (z.B. "40.714728,-73.998672") oder mehrere Breiten-/Längengradpaare werden als Array oder als codierte Polylinie übergeben. Es gibt ein Limit von 512 Punkten. für diesen Parameter. Weitere Informationen siehe Positionen angeben weiter unten.
Anfragen für Stichprobendaten entlang von Pfaden
path
(erforderlich) definiert einen Pfad auf der Erde für für die Höhendaten zurückgegeben werden sollen. Dieser Parameter definiert eine Gruppe von zwei oder mehr geordnete {Breitengrad,Längengrad}-Paare, die einen Pfad entlang der Oberfläche definieren der Erde. Dieser Parameter muss in Verbindung mit dem Parametersamples
verwendet werden. wie unten beschrieben. Hierfür gibt es ein Limit von 512 Punkten. Parameter. Weitere Informationen siehe Pfade angeben weiter unten.samples
(erforderlich) gibt die Anzahl der Stichproben an. Punkte entlang eines Pfads, für die Höhendaten zurückgegeben werden sollen. Die Der Parametersamples
dividiert den angegebenen Wert fürpath
. in einen geordneten Satz von abstandsgetreuen Punkten entlang des Pfads.
Standorte angeben
Positionsanfragen werden mithilfe der
locations
-Parameter, der Höhendatenanfragen angibt
für die spezifischen Standorte, die als
Breiten- und Längengradwerte.
Der Parameter locations
kann Folgendes annehmen:
Argumente:
- Eine einzelne Koordinate:
locations=40.714728,-73.998672
- Ein Array von Koordinaten, die durch ein Pipe-Zeichen (
|
) voneinander getrennt sind Zeichen:locations=40.714728,-73.998672|-34.397,150.644
- Ein Satz codierter Koordinaten unter Verwendung des
Verschlüsselt
Polylinienalgorithmus:
locations=enc:gfo}EtohhU
Breiten- und Längengradkoordinaten werden mithilfe von Ziffern definiert
innerhalb einer kommagetrennten Textzeichenfolge. Beispiel: „40.714728,-73.998672“
ist ein gültiger locations
-Wert. Breitengrad und
Werte für die Länge müssen einem gültigen Standort entsprechen.
auf der Erdoberfläche. Für Breitengrade kann jeder Wert zwischen
-90
und 90
, für Längengradwerte kann es jedoch
beliebiger Wert zwischen -180
und 180
. Wenn Sie
ungültiger Wert für den Breiten- oder Längengrad enthält, wird Ihre Anfrage abgelehnt.
schlechten Antrag stellen.
Sie können bis zu 512 Koordinaten in einem Array oder codierten
und gleichzeitig eine gültige URL erstellt wird.
Beachten Sie, dass bei der Übergabe mehrerer Koordinaten die Genauigkeit aller zurückgegebenen Daten
kann eine niedrigere Auflösung haben als bei der Anforderung von Daten für eine einzelne Koordinate.
Mehr als 512 Punkte oder Koordinaten in „locations“ oder 'path' Parameter gibt ein
Antwort von INVALID_REQUEST
.
Pfade angeben
Anfragen für Stichprobendaten werden mithilfe der path
angegeben.
und samples
, die eine Anfrage für Höhendaten angeben
in bestimmten Intervallen entlang eines Pfads. Wie bei Positionsanfragen mit der Methode
locations
, wird durch den path
-Parameter angegeben,
eine Reihe von Breitengrad- und Längengradwerten. Anders als bei Positionsanfragen
path
gibt einen geordneten Satz von Scheitelpunkten an. Anstatt zurückzukommen
Höhendaten werden nur an den Eckpunkten angezeigt. Pfadanfragen werden entlang der
Länge des Pfads, basierend auf der Anzahl der samples
angegeben ist (einschließlich der Endpunkte).
Der Parameter path
kann Folgendes annehmen:
Argumente:
- Ein Array von zwei oder mehr durch Kommas getrennten Koordinaten-Textstrings.
durch Pipe-Zeichen ('
|
') getrennt Zeichen:path=40.714728,-73.998672|-34.397,150.644
- Codierte Koordinaten unter Verwendung des
Verschlüsselt
Polylinienalgorithmus:
path=enc:gfo}EtohhUxD@bAxJmGF
Breiten- und Längengradkoordinaten werden mithilfe von Ziffern definiert
innerhalb einer kommagetrennten Textzeichenfolge. Beispiel:
„40.714728,-73.998672|-34.397, 150.644“ ist eine gültige
path
-Wert. Breiten- und Längengradwerte müssen übereinstimmen
an einem gültigen Ort auf der Erde platzieren. Für Breitengrade kann jeder Wert zwischen
-90
und 90
, für Längengradwerte kann es jedoch
beliebiger Wert zwischen -180
und 180
. Wenn Sie
ungültiger Wert für den Breiten- oder Längengrad enthält, wird Ihre Anfrage abgelehnt.
schlechten Antrag stellen.
Sie können bis zu 512 Koordinaten in einem Array oder codierten
und gleichzeitig eine gültige URL erstellt wird. Wenn Sie mehrere
Koordinaten haben, ist die Genauigkeit der zurückgegebenen Daten möglicherweise geringer als
wenn Daten für eine Koordinate angefordert werden. Mehr als 512 Punkte oder Koordinaten
in „locations“ oder 'path' Parameter gibt eine INVALID_REQUEST
-Antwort zurück.
Antworten für die Höhe
Für jede gültige Anfrage gibt der Elevation-Dienst eine in dem Format, das in der Anfrage-URL angegeben ist.
ElevationResponse
Field | Required | Type | Description |
---|---|---|---|
| required | Array<ElevationResult> | See ElevationResult for more information. |
| required | ElevationStatus | See ElevationStatus for more information. |
| optional | string |
When the service returns a status code other than |
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, sind möglicherweise zusätzliche
error_message
innerhalb des Elevation-Antwortobjekts. Dieses Feld enthält weitere
detaillierte Informationen zu den Gründen für den jeweiligen Statuscode.
Die Antwort enthält ein results
-Array mit den folgenden Elementen:
ElevationResult
Field | Required | Type | Description |
---|---|---|---|
| required | number | The elevation of the location in meters. |
| 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. |
| 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 |
---|---|---|---|
| required | number | Latitude in decimal degrees |
| required | number | Longitude in decimal degrees |
Beispiele für Positionshöhen
Im folgenden Beispiel wird die Höhe für Denver angefordert, Colorado, die „Mile High City“ im JSON-Format:
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, CO und für Death Valley, Kalifornien, USA).
In dieser Anfrage wird die Verwendung des JSON-Flags output
veranschaulicht:
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 die Verwendung des XML-Flags output
veranschaulicht:
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 sich die JSON- und XML-Beispielantworten anzusehen.
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 geradlinigen Linie angefordert
path
von Mt. Whitney, CA, nach Badwater, CA, USA, der höchsten und
Tiefstwerte auf dem US-amerikanischen Festland. Wir bitten Sie um drei
samples
. Dies umfasst die beiden Endpunkte und den
zur Hälfte geschafft.
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>