FR:OpenRailwayMap/API
Conditions d'utilisation
OpenRailwayMap est un projet non commercial, financé par des dons et géré par des bénévoles. Notre infrastructure a une capacité limitée, c'est pourquoi nous autorisons l'utilisation de l'API et des tuiles dans les conditions suivantes :
- Les applications à petite échelle avec peu de demandes ou des demandes relativement petites sont autorisées à utiliser l'API et les tuiles gratuitement et sans frais.
- En règle générale, il n'y a pas de différence entre les applications commerciales et non commerciales; toutefois, le soutien financier est très apprécié. Vous pouvez faire un don ici.
- Les applications doivent envoyer un User-Agent unique (nom et URL du site web) avec leurs requêtes afin de pouvoir contacter les responsables en cas de problème. Si les tuiles sont intégrées dans un site web, il n'est techniquement pas possible d'envoyer un User-Agent. Dans ce cas d'utilisation, il n'est pas nécessaire d'envoyer un User-Agent car le navigateur envoie automatiquement un référent lors du chargement des images et cette chaîne de référence est suffisante pour l'identification.
- Les utilisateurs qui envoient des requêtes API ou des demandes de tuiles à grande échelle seront bloqués et - s'ils sont identifiables - contactés.
- Si votre demande a été bloquée, nous vous donnons des conseils sur la manière dont la fonctionnalité requise peut être mise en place sur votre propre serveur, ou nous vous permettons de continuer à utiliser nos services en échange d'un soutien financier.
- La plupart des demandes d'API ne devraient normalement pas prendre plus de 3 secondes. Dans tous les cas, vous devez concevoir votre application de manière à ce qu'elle interrompe les demandes au bout d'environ 5 secondes. Si plusieurs demandes échouent d'affilée, votre application doit supposer que le service n'est pas disponible et ralentir le rythme des tentatives.
- L'API limite le nombre de demandes à un niveau raisonnable. Les limites sont conçues pour protéger l'API d'une charge trop importante et pour protéger le contenu de la base de données contre le piratage. Si votre application atteint les limites et que vous souhaitez disposer d'un quota plus important, veuillez nous contacter et décrire en détail les besoins de votre application.
- L'application ne peut demander des données ou des tuiles que lorsque l'utilisateur final en a véritablement besoin. Si vous souhaitez effectuer des requêtes en masse, ajoutez des délais pour permettre à votre requête en masse de se comporter comme un utilisateur humain. De manière générale, essayez d'utiliser le plus possible la mise en cache pour réduire la charge.
- La disponibilité du service est généralement très bonne, mais il n'y a pas de garantie. Rappelez-vous qu'il s'agit d'un service gratuit offert par un projet communautaire non commercial. Si vous avez besoin d'un service entièrement fiable, vous devez mettre en place votre propre instance de cette API ou de ce serveur de tuiles.
Les données d'OpenRailwayMap, qui proviennent de la base de données OpenStreetMap, sont disponibles sous la licence ODbL (Open Data Commons Open Database License). Les tuiles OpenRailwayMap sont disponibles sous la licence Creative-Commons Attribution-ShareAlike 2.0.(CC-BY-SA 2.0)
L'utilisation des tuiles OpenRailwayMap nécessite d'être créditée :
Data <a href="https://www.openstreetmap.org/copyright">© OpenStreetMap contributors</a>, Style: <a href="http://creativecommons.org/licenses/by-sa/2.0/">CC-BY-SA 2.0</a> <a href="http://www.openrailwaymap.org/">OpenRailwayMap</a>
L'utilisation de tuiles OpenStreetMap standards comme fond de carte, ce qui est le cas si vous incluez la carte par défaut OpenRailwayMap dans votre site web, nécessite cette attribution :
Data <a href="https://www.openstreetmap.org/copyright">© OpenStreetMap contributors</a>, Style: <a href="http://creativecommons.org/licenses/by-sa/2.0/">CC-BY-SA 2.0</a> <a href="http://www.openrailwaymap.org/">OpenRailwayMap</a> and OpenStreetMap
Si les données sont requêtées par l'intermédiaire de notre API, l'attribution suivante est requise :
Data <a href="https://www.openstreetmap.org/copyright">© OpenStreetMap contributors</a>, Service by <a href="http://www.openrailwaymap.org/">OpenRailwayMap</a>
Les attributions dont la couleur du texte est égale à celle de l'arrière-plan, les polices de très petite taille, le texte entièrement ou partiellement masqué et les liens désactivés ne sont pas pris en compte.
Tuiles de carte
Cette section est en cours de rédaction, en attendant vous pouvez la retrouver en anglais à cette adresse : OpenRailwayMap/API#Tiles
API
OpenRailwayMap fournit une API RESTful HTTP qui permet de demander facilement des données ferroviaires dans OpenStreetMap. Les demandes sont reçues via GET et les résultats sont renvoyés sous forme de données JSON.
L'API prend en charge le partage des ressources entre origines (CORS), en envoyant Access-Control-Allow-Origin : * dans l'en-tête de chaque réponse.