Die Fehler im Überblick
| Sie erhalten | Das bedeutet | Was zu tun ist |
|---|---|---|
| 429 Too Many Requests | Alle Slots Ihrer IP-Adresse waren 15 Sekunden lang belegt. | Warten Sie vor der nächsten Abfrage, führen Sie nur eine Abfrage gleichzeitig aus und prüfen Sie Ihre Slots unter /api/status. |
| 504 Gateway Timeout | Der Server fand innerhalb von 15 Sekunden keinen Platz für die Zeit und den Speicher, die Ihre Abfrage angibt. | Fordern Sie weniger an: ein kleineres [timeout] oder [maxsize], ein kleineres Gebiet. Oder versuchen Sie es später erneut. |
200 mit einer runtime error-Remark zur Zeit | Die Abfrage lief länger als ihr [timeout] (180 Sekunden, wenn Sie nichts setzen) und wurde abgebrochen. | Verkleinern Sie das Gebiet oder die Filter oder erhöhen Sie den Timeout; ein höherer Timeout wird schwerer zugelassen. |
200 mit einer runtime error-Remark zum Speicher | Die Abfrage brauchte mehr als ihr [maxsize] (512 MiB, wenn Sie nichts setzen). | Machen Sie die Abfrage schmaler, geben Sie weniger aus (out center statt out geom) oder erhöhen Sie [maxsize]. |
Fehler mit Status 200 übersieht man leicht: Die Antwort ist gültiges JSON ohne Elemente, und der Grund steht nur im Feld remark. Prüfen Sie es in Ihrem Client.
Wie das Rate Limit funktioniert
Overpass zählt Anfragen pro Nutzer, und Nutzer ist Ihre IP-Adresse (bei IPv6 deren erste 64 Bit), sofern Sie keinen Nutzer-Key senden. Jeder Nutzer hat einige Slots. Eine Abfrage belegt einen Slot, solange sie läuft, und danach für eine Abkühlzeit. Die Abkühlzeit ist bei ruhigem Server ein Bruchteil der Laufzeit und bei hoher Last ein Vielfaches davon, sodass derselbe Client an einem ausgelasteten Tag weniger Abfragen durchbringt.
Eine Abfrage, die keinen freien Slot findet, wartet bis zu 15 Sekunden und erhält dann 429. Die beiden öffentlichen Server hinter overpass-api.de zählen getrennt.
Um Ihren eigenen Stand zu sehen, öffnen Sie die Statusseite:
curl https://overpass-api.de/api/statusDie dritte Zeile nach „Rate limit:“ ist die Zahl Ihrer Slots. Ab der sechsten Zeile steht, wann Ihre belegten Slots frei werden.
Warum eine kleine Abfrage 504 bekommen kann
Vor dem Ausführen prüft der Server die Zeit und den Speicher, die eine Abfrage angibt: [timeout] ist standardmäßig 180 Sekunden und [maxsize] 512 MiB. Eine Abfrage wird nur zugelassen, wenn beides in die Hälfte dessen passt, was der Server in diesem Moment frei hat. Wenn nicht, wartet sie bis zu 15 Sekunden und erhält dann 504. Eine Abfrage, die sicherheitshalber [timeout:900] angibt, kann auf einem ausgelasteten Server also abgelehnt werden, während dieselbe Abfrage mit [timeout:60] läuft.
Abhilfe im Client
- Senden Sie jeweils nur eine Abfrage. Der Hauptserver erlaubt keine parallelen Skripte.
- Machen Sie nach einem 429 oder einem anderen Fehlerstatus eine Pause vor der nächsten Abfrage; das OpenStreetMap-Wiki empfiehlt 30 Sekunden.
- Cachen Sie Antworten. Kartendaten ändern sich für die meisten Apps nicht von einer Minute zur nächsten.
- Senden Sie einen
User-Agent, der Ihre App nennt, wie es die Nutzungsrichtlinie verlangt. - Geben Sie ein
[timeout]an, das nahe an dem liegt, was die Abfrage braucht, nicht den größten Wert. - Teilen Sie ein großes Gebiet in kleinere Boxen auf und verwenden Sie
out centeroderout tags, wenn Sie keine vollständige Geometrie brauchen.
Was der öffentliche Server erlaubt
Die Nutzungsrichtlinie im OpenStreetMap-Wiki sieht weniger als etwa 10.000 Abfragen und 1 GB Downloads pro Tag als unproblematisch für andere Nutzer an und verlangt, dass regelmäßige Nutzung hundertmal darunter bleibt. Eine App zählt alle ihre Nutzer zusammen. Kommerzielle Nutzung soll auf kostenpflichtige oder selbst gehostete Server umziehen, und laut Wiki ist der Hauptserver derzeit überlastet und nicht als zuverlässig zu erwarten.
Wenn Ihr Backend Overpass-Abfragen für Ihre Nutzer sendet, teilen sich alle die Slots Ihres Servers. Das ist der übliche Zeitpunkt, sich nach einer anderen Möglichkeit umzusehen.
Alternativen, wenn der öffentliche Server nicht reicht
- Eigene Overpass-Instanz betreiben. Volle Abfragesprache und minütliche Updates, aber Sie kümmern sich um Server, Festplatte und Updates.
- Eine kostenpflichtige Overpass-Instanz. Das Wiki listet mehrere mit Preisen und Limits auf.
- Unser Endpoint. Eigener Key und eigene Limits, ab 500 Anfragen pro Tag kostenlos. Er beantwortet eine Teilmenge von Overpass QL aus einer monatlich aktualisierten Datenbank, ohne Rekursion; die Seite Overpass-API-Alternative listet genau auf, was unterstützt wird, und die Beispiele zeigen gängige Abfragen.
Quellen: Overpass-API-Dokumentation, „Commons“ und die Seite zur Overpass API im OpenStreetMap-Wiki, abgerufen am 7. November 2026.