Die Nutzung Ihres Schlüssels überwachen, bevor Sie an ein Limit stoßen
Wenn Sie Ihre Kontingent-Header laufend beobachten, wissen Sie, wann ein Limit näher rückt, lange bevor eine Anfrage tatsächlich abgelehnt wird.
Der gesamte Höhengewinn ist eine einzige Zahl, die einem Wanderer oder Radfahrer mehr über die Schwierigkeit einer Route verrät, als die Distanz allein es je könnte. Außerdem lässt er sich einfach berechnen, sobald Sie Höhendaten für genügend Punkte entlang der Route haben.
Senden Sie die Koordinaten der Route der Reihe nach an /v1/elevation, entweder mit dem Parameter points oder als Array in einem Sammel-POST.
GET /v1/elevation?points=45.8326,6.8652|45.8400,6.8700|45.8475,6.8750|45.8300,6.8800{
"status": "ok",
"results": [
{"lat": 45.8326, "lon": 6.8652, "elevation_m": 1035},
{"lat": 45.8400, "lon": 6.8700, "elevation_m": 1210},
{"lat": 45.8475, "lon": 6.8750, "elevation_m": 1390},
{"lat": 45.8300, "lon": 6.8800, "elevation_m": 1180}
]
}Gehen Sie die Ergebnisse der Reihe nach durch und addieren Sie für jedes aufeinanderfolgende Paar die Differenz nur dann zu Ihrer laufenden Summe, wenn die Höhe gestiegen ist. In diesem Beispiel fügt 1035 auf 1210 den Wert 175 hinzu, 1210 auf 1390 fügt 180 hinzu, und 1390 auf 1180 fügt nichts hinzu, da dieser Abschnitt abfällt. Der gesamte Höhengewinn für dieses kurze Stück beträgt 355 Meter.
gain = 0
for i in 1..n:
diff = elevation[i] - elevation[i-1]
if diff > 0: gain += diffDieselbe Schleife mit umgekehrtem Vergleich liefert stattdessen den gesamten Abstieg, der für eine Route, die tiefer endet, als sie beginnt, etwa eine Fahrt von A nach B einen Berg hinunter, genauso wichtig ist wie der Anstieg.
loss = 0
for i in 1..n:
diff = elevation[i] - elevation[i-1]
if diff < 0: loss += -diffFür die vier Punkte oben beträgt der gesamte Höhenverlust 210 Meter, alles aus dem letzten, abfallenden Abschnitt. Eine Routenübersicht, die nur den Höhengewinn angibt und den Höhenverlust weglässt, erzählt bei allem, was keine einfache Hin- und Rückstrecke ist, nur die halbe Geschichte.
Der Höhengewinn reagiert empfindlich darauf, wie viele Punkte Sie abfragen. Zu wenige Punkte glätten echte Anstiege und Abfahrten zu einer zu niedrigen Summe. Zu viele Punkte auf einem verrauschten GPS-Track können die Zahl durch kleine Auf- und Ab-Schwankungen aufblähen, die nie ein echter Anstieg waren. Ein Abstand von zehn bis dreißig Metern entlang eines Wanderwegs, oder eine Neuabtastung in gleichmäßigen Distanzintervallen, ist ein vernünftiger Ausgangspunkt.
Die Berechnung des Höhengewinns direkt auf einem rohen GPS-Track ohne vorherige Neuabtastung auszuführen, führt häufig zu einer überhöhten Zahl, da GPS-Tracks von Endgeräten zwischen aufeinanderfolgenden Punkten oft um einige Meter auf und ab schwanken, selbst auf wirklich flachem Boden. Tasten Sie den Track in gleichmäßigen Distanzintervallen neu ab, bevor Sie Höhendaten dafür anfordern, statt Höhendaten für jeden rohen Punkt anzufordern, den das Gerät aufgezeichnet hat.
Jeder Punkt ist eine Anfrage, ob über den Parameter points oder ein Sammel-Array gesendet. Eine Route mit 300 abgefragten Punkten kostet 300 Anfragen, was immer noch ein kleiner Teil der 2.500 kostenlosen Anfragen pro Tag ist, die zu jedem Schlüssel gehören.
Ein auf diese Weise berechneter Höhengewinn ist nur so gut wie die Punktauswahl dahinter, daher lohnt es sich, einige Abstände an einer bekannten Route zu testen, bevor Sie sich festlegen. Alle Anfrageoptionen finden Sie auf der Seite Dokumentation zur Höhenabfrage.