Eine Overpass-API-Alternative mit eigenem Key

Richten Sie Ihren Client hierhin

Der Endpoint nimmt die Abfrage als data entgegen, wie Overpass: in der URL, als Formularfeld oder als rohen POST-Body. Senden Sie den Key im Header Authorization oder als ?key= für Clients, die keine Header setzen können.

Die Antwort enthält die üblichen Felder version, generator, osm3s und elements. Ein Client, bei dem Sie die Serveradresse ändern können, funktioniert mit https://geo.runningcat.dev/v1/overpass/interpreter?key=YOUR_KEY, solange seine Abfragen innerhalb des unten Aufgeführten bleiben. Weitere Abfragen stehen auf der Seite Overpass-QL-Beispiele.

Was beantwortet wird

• Abfragen: node, way, rel, nwr, nw, nr, wr und area, mit benannten Mengen (->.a, .a) und Vereinigungen.
• Tag-Filter: [k], [!k], [k=v], [k!=v], [k~re], [k!~re], [~kre~vre] und das Kürzel ,i für Groß-/Kleinschreibung ignorieren.
• Wo: eine bbox, around einen Punkt oder eine Linie, poly, IDs, area und is_in. area[...] findet Verwaltungsgrenzen und Schutzgebiete.
• Ausgabe: out mit body, skel, ids, tags, geom, center, bb, count, einem Limit und qt.
• Einstellungen: [out:json] und [bbox]. [timeout] und [maxsize] werden akzeptiert, und jede Abfrage erhält bis zu 30 Sekunden.

Wo es sich von Overpass unterscheidet

• Jede Abfrage braucht eine bbox, around, poly, area oder ID. Eine weltweite Tag-Abfrage wird abgelehnt.
• Rekursion (>, <, >>, <<), Differenz, foreach, if, make, convert, map_to_area und around auf eine Menge werden nicht unterstützt. Ebenso wenig Historie und Diffs (date, diff, adiff) oder die Filter user, newer und changed.
• Ways kommen ohne ihre Node-Listen und Relationen ohne ihre eigentlichen Mitglieder. Mit out geom trägt ein Way seine Geometrie, und eine Relation trägt stattdessen Mitglieder mit Geometrie.
• Die Antwort ist nur JSON, mit höchstens 10.000 Elementen im Tarif Free, 25.000 bei Developer und 50.000 bei Pro. Bearbeitungs-Metadaten (Versionen, Nutzer, Changesets) sind nicht enthalten.
• Die Kartendaten werden jeden Monat aktualisiert, nicht jede Minute.

Eine Abfrage, die etwas Nicht-Unterstütztes verwendet, kommt als Fehler mit einer remark zurück, die es nennt, sodass Sie sofort wissen, was zu ändern ist.

Limits, mit denen Sie planen können

Der öffentliche Haupt-Overpass-Server bittet darum, unter etwa 10.000 Abfragen und 1 GB Downloads pro Tag zu bleiben, bei regelmäßiger Nutzung bei einem Hundertstel davon, und schickt kommerzielle Nutzer zu kostenpflichtigen oder selbst gehosteten Servern (OpenStreetMap-Wiki). Sein Rate Limit gibt jeder IP-Adresse einige Slots, sodass sich alle Ihre Nutzer diese Slots teilen, wenn Ihr Backend die Abfragen sendet. Die Anleitung zu den Fehlern 429 und 504 erklärt, wie das funktioniert.

Hier gehören die Limits zu Ihrem Key, und jede Overpass-Abfrage zählt als eine Anfrage, egal wie viel sie zurückgibt. Wie viel eine Antwort enthalten darf, hängt vom Tarif ab.

Bei Überschreitung eines Limits wird eine Anfrage mit Status 429 und einem Header Retry-After abgelehnt; es wird nichts extra berechnet. In unseren Tests kamen Cafés um einen Punkt in etwa 0,2 Sekunden zurück, Trinkwasser in einer stadtgroßen Box in etwa 1 Sekunde und Bäckereien innerhalb der Grenzen von Krakau in etwa 3 Sekunden. Eine Abfrage über ein ganzes Land per area kann über den Timeout hinauslaufen.

Mehr als Kartendaten, mit demselben Key

Der Key liefert außerdem Prognosen zu Wetter und Luftqualität, gemessene Luftqualität, Flusspegel, Höhen, Zeitzonen, Routing und Halte entlang einer Route. Siehe POI entlang einer Route, die Wetter-API und alles, was die API kann.