Fehlermeldungen und Lösungen

Was Photon tatsächlich antwortet

Gemessen am 14.09.2026.

Fall	Antwort
Anfrage ohne q	400
/autocomplete aufgerufen	404 — den Endpunkt gibt es nicht, siehe Suchvorschläge
Keine Treffer	200 mit leerer features-Liste

Kein Treffer ist kein Fehler

Photon antwortet auf eine erfolglose Suche mit 200 und {"type":"FeatureCollection","features":[]}. Wer nur den Statuscode prüft, hält das für Erfolg und läuft dann auf features[0] auf.

Prüfen Sie die Länge der Liste, nicht den Code.

Wenn Treffer kommen, aber die falschen

Häufiger als echte Fehler — und meist eine dieser drei Ursachen:

1. Keine Ortsbindung. Ohne lat/lon sucht Photon weltweit. Gemessen: Klagen → ein Ort auf Java. Mit Bindung auf Kärnten → Klagenfurt.
2. Falsche Objektart. Die Rückwärtssuche liefert das nächste OSM-Objekt, und das ist in der Stadt oft ein Bussteig oder ein Gebäudeteil. Mit osm_tag einschränken.
3. Hausnummer gesucht. Photon kennt nur, was in OpenStreetMap steht. Gemessen: Domgasse 1 Klagenfurt → Gebäude in Maria Saal. Für Adressen ist Pelias zuständig.

Ohne Token: 401 / 403

Alle Dienste verlangen einen Token. Fehlt er oder ist er ungültig, wird die Anfrage mit 401 oder 403 abgelehnt. Siehe Zugriff auf die Dienste.

Was wir nicht beobachtet haben

• 429: Eine Begrenzung der Anfragerate ist uns nicht bekannt und wurde nicht gemessen — das ist keine Zusage. Gerade bei Suchvorschlägen während des Tippens entstehen schnell viele Anfragen; drosseln Sie clientseitig (150–250 ms Verzögerung, laufende Anfragen abbrechen).

Beides steht hier ausdrücklich als offen, nicht als „gibt es nicht”.