Anleitung

Overpass Turbo: einen anderen Overpass-Server verwenden

Overpass Turbo schickt Ihre Abfragen an overpass-api.de, solange Sie den Server in den Einstellungen nicht ändern.

Öffnen Sie die Einstellungen, tragen Sie die Basis-URL des Servers mit einem Schrägstrich am Ende unter Server ein, und speichern Sie. Overpass Turbo hängt interpreter selbst an. Für overpass.ch lautet die URL:
https://api.overpass.ch/v1/IHR_API_SCHLÜSSEL/

Schritt für Schritt

  1. Öffnen Sie overpass-turbo.eu, und klicken Sie in der Werkzeugleiste auf Einstellungen (englisch: Settings).
  2. Unter Allgemeine Einstellungen (General Settings) finden Sie das Feld Server. Es schlägt die öffentlichen Server aus dem Wiki von OpenStreetMap vor, Sie können aber jede URL eintippen.
  3. Geben Sie die Server-URL mit dem Schrägstrich am Ende ein, zum Beispiel https://api.overpass.ch/v1/IHR_API_SCHLÜSSEL/, und klicken Sie auf Speichern.
  4. Führen Sie eine Abfrage aus. Die Statuszeile unten auf der Karte zeigt den Zeitstempel der Daten, sobald die Antwort da ist.

Overpass Turbo merkt sich den Server in Ihrem Browser und nimmt ihn in die Vorschläge auf, Sie können also später zwischen Servern wechseln. Für den Weg zurück wählen Sie https://overpass-api.de/api/.

Warum der Schrägstrich am Ende zählt

Overpass Turbo baut die URL der Anfrage, indem es interpreter an den Inhalt des Felds Server anhängt. Es ergänzt keinen Schrägstrich und entfernt keinen:

Feld ServerDie Anfrage geht an
…/v1/KEY/…/v1/KEY/interpreterfunktioniert
…/v1/KEY…/v1/KEYinterpreter404
…/v1/KEY/interpreter…/v1/KEY/interpreterinterpreter404

Dieselbe Regel gilt für die öffentlichen Server: https://overpass-api.de/api/, nicht …/api/interpreter.

Ihr API-Schlüssel in Overpass Turbo

  • Der Schlüssel ist Teil der URL und wird in den Browser-Einstellungen für overpass-turbo.eu gespeichert. In den Links, die Teilen erzeugt, steht er nicht.
  • Zwei Links unter Exportieren enthalten die Server-URL und damit Ihren Schlüssel: interaktive Karte und Rohdaten direkt von der Overpass API. Veröffentlichen Sie diese nicht.
  • Für zusätzliche Sicherheit erstellen Sie im Dashboard einen eigenen Schlüssel für Overpass Turbo und beschränken ihn auf den Referer overpass-turbo.eu. Anfragen von anderen Websites werden dann abgewiesen.

Fehlermeldungen und ihre Bedeutung

  • 404, «unknown endpoint»: Die URL ist falsch. Prüfen Sie den Schrägstrich am Ende, und dass das Feld nicht auf interpreter endet.
  • 401, «unknown API key»: ein Tippfehler im Schlüssel, oder ein widerrufener Schlüssel. Kopieren Sie ihn noch einmal aus dem Dashboard.
  • 403: Der Schlüssel ist auf Referer beschränkt, und overpass-turbo.eu gehört nicht dazu.
  • 429 Too Many Requests: Auf einem öffentlichen Server sind alle Slots Ihrer IP-Adresse belegt (siehe die Anleitung zu 429). Auf overpass.ch haben Sie das Limit pro Minute Ihres Tarifs erreicht; die Antwort sagt, wie lange Sie warten müssen.
  • «runtime error: Query timed out»: Die Abfrage braucht mehr Zeit, als sie darf. Ein [timeout:…] über dem Maximum des Tarifs wird auf dieses gesenkt; machen Sie die Abfrage also günstiger, oder verwenden Sie einen Tarif mit längeren Abfragen. Die Anleitung zu den Fehlern hat weitere Lösungen.

Was Sie sonst wissen sollten

  • Kürzel wie {{bbox}} und {{geocodeArea:…}} funktionieren weiter: Overpass Turbo ersetzt sie, bevor es die Abfrage sendet.
  • Karte, Assistent und Darstellung bleiben gleich. Nur der Server, der die Abfrage beantwortet, ändert sich.
  • JOSM und QGIS verwenden dieselbe Basis-URL: siehe die Einstellungen für JOSM und die Anleitung zu QuickOSM.