Une alternative à Overpass API avec votre propre clé

Pointez votre client ici

L'endpoint reçoit la requête dans data, comme Overpass : dans l'URL, dans un champ de formulaire ou comme corps brut d'un POST. Envoyez la clé dans l'en-tête Authorization, ou en ?key= pour les clients qui ne peuvent pas définir d'en-têtes.

La réponse contient les habituels version, generator, osm3s et elements. Un client qui permet de changer l'adresse du serveur fonctionne avec https://geo.runningcat.dev/v1/overpass/interpreter?key=YOUR_KEY, tant que ses requêtes restent dans ce qui est listé ci-dessous. D'autres requêtes figurent sur la page des exemples Overpass QL.

Ce à quoi il répond

• Requêtes : node, way, rel, nwr, nw, nr, wr et area, avec ensembles nommés (->.a, .a) et unions.
• Filtres de tags : [k], [!k], [k=v], [k!=v], [k~re], [k!~re], [~kre~vre] et le ,i insensible à la casse.
• Où : une bbox, around un point ou une ligne, poly, des identifiants, area et is_in. area[...] trouve les limites administratives et les zones protégées.
• Sortie : out avec body, skel, ids, tags, geom, center, bb, count, une limite et qt.
• Paramètres : [out:json] et [bbox]. [timeout] et [maxsize] sont acceptés, et chaque requête dispose de 30 secondes au maximum.

Où il diffère d'Overpass

• Chaque requête a besoin d'une bbox, d'un around, d'un poly, d'une zone ou d'un identifiant. Une requête de tags sur le monde entier est refusée.
• La récursion (>, <, >>, <<), la différence, foreach, if, make, convert, map_to_area et around sur un ensemble ne sont pas pris en charge. L'historique et les diffs (date, diff, adiff) ni les filtres user, newer et changed non plus.
• Les ways arrivent sans leurs listes de nœuds et les relations sans leurs vrais membres. Avec out geom, un way porte sa géométrie, et une relation porte à la place des membres avec géométrie.
• La réponse est uniquement en JSON, avec au plus 10 000 éléments sur le forfait Free, 25 000 sur Developer et 50 000 sur Pro. Les métadonnées d'édition (versions, utilisateurs, changesets) ne sont pas incluses.
• Les données cartographiques sont actualisées chaque mois, pas chaque minute.

Une requête qui utilise quelque chose de non pris en charge revient en erreur avec un remark qui le nomme, pour que vous sachiez tout de suite quoi changer.

Des limites sur lesquelles vous pouvez compter

Le serveur Overpass public principal demande de rester sous environ 10 000 requêtes et 1 Go de téléchargements par jour, un centième de cela pour un usage régulier, et il renvoie les utilisateurs commerciaux vers des serveurs payants ou auto-hébergés (wiki d'OpenStreetMap). Sa limite de débit donne à chaque adresse IP quelques emplacements ; quand votre backend envoie les requêtes, tous vos utilisateurs se partagent donc ces emplacements. Le guide des erreurs 429 et 504 explique comment cela fonctionne.

Ici, les limites dépendent de votre clé, et chaque requête Overpass compte pour une requête, quelle que soit la taille de la réponse. La quantité que peut contenir une réponse dépend du forfait.

Au-delà d'une limite, une requête est refusée avec le statut 429 et un en-tête Retry-After ; rien n'est facturé en plus. Dans nos tests, les cafés autour d'un point sont revenus en environ 0,2 seconde, l'eau potable dans un rectangle de la taille d'une ville en environ 1 seconde, et les boulangeries dans les limites de Cracovie en environ 3 secondes. Une requête sur un pays entier par area peut dépasser le timeout.

Plus que des données cartographiques, avec la même clé

La clé donne aussi accès aux prévisions météo et de qualité de l'air, à la qualité de l'air mesurée, aux niveaux des rivières, aux altitudes, aux fuseaux horaires, au routage et aux arrêts le long d'un itinéraire. Voir les POI le long d'un itinéraire, l'API météo et tout ce que fait l'API.