Migration

Migrer depuis Open-Elevation

Open-Elevation est un projet open source construit autour d'une idée simple : envoyer un tableau de paires de latitude et longitude, et recevoir un tableau de valeurs d'altitude en mètres. Il est souvent auto-hébergé, soit en s'appuyant sur l'instance de démonstration publique du projet pour un usage léger, soit sur une infrastructure privée chargée avec un jeu de données d'altitude choisi pour tout usage plus sérieux. Cette simplicité du format de requête est réellement l'un de ses points forts, et toute migration digne de ce nom devrait la conserver.

L'auto-hébergement entraîne de réels coûts de maintenance, faciles à sous-estimer au départ : les jeux de données d'altitude occupent un espace disque important, le serveur doit rester disponible, et les mises à jour des données sous-jacentes sont un projet manuel plutôt que quelque chose qui se fait automatiquement. Une équipe qui a mis cela en place tôt dans la vie d'un projet constate parfois, un ou deux ans plus tard, que la charge de maintenance l'emporte sur la raison pour laquelle elle avait choisi l'auto-hébergement au départ.

My Geocode propose la recherche d'altitude comme un endpoint pleinement fonctionnel, et non comme une simple couche de compatibilité de forme, car c'est l'une des recherches pour lesquelles de vrais résultats peuvent être montrés directement. Une requête pour une paire de coordonnées renvoie l'altitude du sol en ce point, en mètres, tirée de nos propres données d'altitude, sans que vous ayez à trouver, charger et maintenir vous-même un jeu de données. Les détails se trouvent sur /docs/elevation-lookup/.

Pour les équipes qui migrent spécifiquement depuis le style de requête et de réponse par tableaux d'Open-Elevation, les différences pratiques sont les suivantes :

  • Authentification : Open-Elevation n'en exige généralement aucune pour son instance publique, tandis que My Geocode utilise une clé envoyée via un en-tête X-API-Key, Authorization: Bearer, l'authentification HTTP Basic ou un paramètre de requête (2 500 requêtes par jour fonctionnent sans aucune clé)
  • Aucun serveur à faire tourner, aucun jeu de données à télécharger ou à actualiser, et aucun espace disque à provisionner
  • Un quota quotidien prévisible et une tarification claire au-delà, plutôt que le risque de disponibilité d'une infrastructure gérée par vos soins

Au-delà des 2 500 requêtes gratuites par jour sans clé, et de 2 500 autres gratuites par clé et par jour, comptées par réseau, la recherche d'altitude est facturée au même prix que tous les autres endpoints : crédit prépayé à 0,0001 € par requête ou clé Unlimited à 50 € par mois.

Pour les applications qui appellent l'altitude comme une étape d'un flux de travail plus large (profils d'itinéraires de randonnée ou de vélo, planification de vols de drone ou outils de relevé topographique), la forme de la requête reste suffisamment proche de ce qu'Open-Elevation attend déjà pour que ce soit généralement un travail réduit et bien délimité : remplacer l'endpoint et l'authentification, garder le reste.

Si l'auto-hébergement a été choisi à l'origine pour éviter entièrement les coûts récurrents plutôt que pour garder le contrôle des données, il vaut la peine de faire le calcul réel de votre volume d'appels par rapport au quota gratuit et au tarif par requête avant de décider, car en pratique beaucoup de recherches d'altitude restent largement dans ce que couvre le seul niveau gratuit.