Anleitung

QuickOSM (QGIS): den Overpass-Server wechseln

QuickOSM, das QGIS-Plugin für OpenStreetMap-Daten, verwendet standardmässig den öffentlichen Server overpass-api.de. Wenn Ihre Downloads mit Fehlern 429 oder 504 scheitern, oder wenn Sie den Server für die Arbeit brauchen, stellen Sie QuickOSM auf einen anderen um.

Öffnen Sie in QuickOSM Parameters, geben Sie unter Add a custom Overpass server die Basis-URL des Servers ein, klicken Sie auf Add, und wählen Sie ihn als Standard aus. Die URL endet mit einem Schrägstrich und ohne interpreter, weil QuickOSM das selbst anhängt:

https://api.overpass.ch/v1/IHR_API_SCHLÜSSEL/

Die Bezeichnungen in dieser Anleitung stammen aus der englischen Oberfläche; in einer deutschen QGIS-Installation heissen sie ähnlich.

QuickOSM 2.5.3 und neuer

Seit Version 2.5.3 (Juni 2026) können Sie Server in den Einstellungen des Plugins hinzufügen:

Öffnen Sie QuickOSM über die Werkzeugleiste oder Vector → QuickOSM.
Klicken Sie links in der Liste auf Parameters.
Tippen Sie unter Overpass API die URL in Add a custom Overpass server, und klicken Sie auf Add. Der Server erscheint in der Liste der eigenen Server.
Wählen Sie ihn oben in der Auswahlliste der Server aus. QuickOSM verwendet ihn ab dann für jede Abfrage.

Ihre Version sehen Sie unter Plugins → Manage and Install Plugins. Ein Update ist der einfachste Weg zu den neuen Einstellungen.

Ältere Versionen: custom_config.json

Ältere Versionen lesen zusätzliche Server aus einer Datei custom_config.json im Ordner QuickOSM Ihres QGIS-Profils:

Wählen Sie in QGIS Settings → User Profiles → Open Active Profile Folder, und öffnen Sie darin den Ordner QuickOSM. Unter Linux ist das zum Beispiel ~/.local/share/QGIS/QGIS3/profiles/default/QuickOSM.

Erstellen Sie custom_config.json mit diesem Inhalt:

{
  "overpass_servers": [
    "https://api.overpass.ch/v1/IHR_API_SCHLÜSSEL/"
  ]
}

Starten Sie QGIS neu, und wählen Sie den Server unter Parameters aus.

Die neuere Einstellungsseite schreibt in dieselbe Datei, von Hand ergänzte Server bleiben also nach einem Update erhalten.

Processing und Modelle

In der Processing-Werkzeugkiste haben die Algorithmen Build query von QuickOSM (by attribute only, inside an area, around an area, inside an extent) einen erweiterten Parameter Overpass server. Er nimmt die vollständige URL mit interpreter, zum Beispiel https://api.overpass.ch/v1/IHR_API_SCHLÜSSEL/interpreter, und verwendet sonst den im Plugin gewählten Server. Ihre Ausgabe-URL geht dann an Download from Overpass. Setzen Sie den Server ausdrücklich in Modellen, die nicht von den Plugin-Einstellungen der Person abhängen dürfen, die sie ausführt.

Wenn es trotzdem scheitert

404: Der URL fehlt der Schrägstrich am Ende, oder sie endet schon auf interpreter.
401 oder 403: Der Schlüssel ist falsch oder widerrufen, oder er ist auf Referer beschränkt. QGIS sendet keinen Referer; verwenden Sie also einen Schlüssel ohne diese Beschränkung.
Timeouts bei grossen Gebieten: Erhöhen Sie Timeout in den erweiterten Optionen der Abfrage. Auf overpass.ch werden Werte über dem Maximum des Tarifs auf dieses gesenkt; wie Sie Abfragen günstiger machen, steht in der Anleitung zu den Fehlern.
Umwandeln zwischen Overpass QL und XML: Generate query kann eine Abfrage zwischen den beiden Sprachen übersetzen. Dafür nutzt es den Endpunkt convert des Servers, den overpass.ch nicht anbietet. Das Ausführen von Abfragen ist davon nicht betroffen.

Warum überhaupt wechseln?

Der öffentliche Server begrenzt jede IP-Adresse auf wenige parallele Abfragen, mit Wartezeiten nach langen Abfragen. Für einen gelegentlichen Download reicht das, aber ein belebtes Firmennetz oder eine Reihe von Processing-Jobs stösst schnell auf 429 Too Many Requests. Ein Server mit Ihrem eigenen Schlüssel hat stattdessen Limits pro Schlüssel, bei denselben Daten. Die Anleitung zu den Alternativen vergleicht die Möglichkeiten.

Kostenlosen Schlüssel holen Beispiele