Migration

Eine Höhenintegration der Google Maps Platform ablösen

Höhenabfragen sind meist eine unauffällige Abhängigkeit: aufgerufen von der Routenprofil-Funktion einer Wander-App, von einem Drohnenflugplaner, der den Geländeabstand prüft, oder von einem Werkzeug für die Landvermessung, und selten der Grund, warum es überhaupt ein Konto bei der Google Maps Platform gibt. Das macht sie zu einem guten Kandidaten für einen Umzug unabhängig vom Rest einer umfassenderen Google-Integration, da der aufrufende Code in der Regel auf eine oder zwei Funktionen beschränkt ist.

Die Elevation API von Google akzeptiert ein oder mehrere Koordinatenpaare und liefert einen elevation-Wert in Metern zusammen mit einem resolution-Wert, der die Genauigkeit der zugrunde liegenden Datenstichprobe beschreibt. Es ist eine kompakte Antwort mit wenig zu parsen, wodurch der Umfang der Migration selbst recht klein bleibt, auch wenn sich die zugrunde liegende Datenquelle ändert.

My Geocode betreibt Höhenabfragen als voll funktionsfähigen Endpunkt mit einer einfachen Anfrage- und Antwortstruktur: Sie senden eine Koordinate und erhalten die Geländehöhe in Metern zurück. Da dies eine der Abfragen ist, bei denen sich echte Antworten direkt beschreiben lassen und nicht nur die Antwortstruktur, ist es ein vernünftiger Weg, diese Migration anhand bekannter Referenzpunkte zu testen, etwa eines bestimmten Berggipfels oder eines Küstenorts auf Meereshöhe, um Vertrauen aufzubauen, bevor Sie den Produktionstraffic umstellen. Details finden Sie unter /docs/elevation-lookup/.

Einige Punkte, die Sie speziell bei diesem Umstieg prüfen sollten:

  • Ob Ihr Code das Feld resolution von Google für mehr als die Anzeige nutzt, da ein Auflösungswert die Stichprobengenauigkeit je nach Höhendatenquelle unterschiedlich beschreibt und jede nachgelagerte Logik, die von einem bestimmten Auflösungswert abhängt, eine Überprüfung verdient
  • Ob Höhenabfragen im Batch (viele Koordinaten in einem Aufruf) oder einzeln erfolgen, da sich die Struktur von Batch-Anfragen zwischen Anbietern unterscheidet und es sich lohnt, sie mit den Batch-Größen zu testen, die Ihre Anwendung tatsächlich verwendet
  • Ob Höhendaten direkt aus clientseitigem Code abgerufen werden. Das ist ein guter Moment, den Aufruf auf die Serverseite zu verlagern, unabhängig vom Zielanbieter

Die Authentifizierung verwendet einen Schlüssel, der als X-API-Key, per Authorization: Bearer, HTTP Basic Auth oder als Query-Parameter gesendet wird. Es gibt 2.500 kostenlose Anfragen pro Tag ganz ohne Schlüssel und 2.500 weitere kostenlos pro Schlüssel und Tag, gezählt pro Netzwerk, darüber hinaus Prepaid-Guthaben zu 0,0001 € pro Anfrage oder einen Unlimited-Schlüssel zu 50 € pro Monat, zum selben Preis wie jeder andere Endpunkt der Plattform.

Optionale Extras über die Höhe hinaus, etwa Details zu IP-Bedrohungen und Netzwerkinformationen, die für andere Teile einer Anwendung relevant sind, stehen auf Kompatibilitäts-Hosts über mg_extras=1 zur Verfügung. Für eine reine Höhenmigration wie diese ist der eigenständige Endpunkt jedoch meist die einfachere und direktere Lösung. Die Höhendaten für sich allein umzuziehen, noch vor einer größeren Geokodierungsmigration, ist ein risikoarmer Weg, die Abhängigkeit von einem einzigen Konto zu verringern, ohne sich sofort auf ein größeres Projekt festzulegen.