Einführung

Ein Geocoder übersetzt zwischen Text und Koordinaten: aus „Domgasse 1, Klagenfurt” wird ein Punkt, aus einem Punkt eine Adresse.

pixel.map betreibt zwei Geocoder. Das ist kein Versehen und keine Übergangslösung — sie sind unterschiedlich gut in unterschiedlichen Dingen.

	Photon	Pelias
Basis-URL	https://geocoder.pixelmap.at	https://pelias.pixelmap.at/v1
Datenbasis	ausschließlich OpenStreetMap	OpenStreetMap + OpenAddresses, WhosOnFirst, GeoNames
Antwortform	GeoJSON mit OSM-Feldern (osm_key, osm_value, osm_id)	GeoJSON mit label, layer, source, confidence
Endpunkte	/api, /reverse	/search, /reverse, /autocomplete
Stark bei	benannten Orten, Bergen, Seen, POIs	Hausadressen
Dokumentation	Photon	Pelias

Welchen nehmen?

Gemessen am 14.09.2026, dieselben vier Anfragen an beide Dienste:

Anfrage	Photon	Pelias
Domgasse 1 Klagenfurt	Gebäude in Maria Saal — falscher Ort	Domgasse 1, Klagenfurt (Quelle OpenAddresses)
Wörthersee	Wörthersee, water/lake	Klagenfurt — der See wird zur Stadt
Pyramidenkogel	Pyramidenkogel, natural/peak	Pyramidenkogelstraße — die Straße statt des Bergs

Diese Tabelle ist eine Momentaufnahme

Die Ergebnisse hängen vom Indexstand beider Dienste ab, und der ändert sich: OpenStreetMap wird täglich bearbeitet, OpenAddresses und GeoNames werden nachgezogen. Eine Anfrage, die heute danebengreift, kann nächsten Monat sitzen — und umgekehrt.

Was daraus nicht altert, ist der Grund: Pelias hat Adressdatenbanken, Photon hat ausschließlich OpenStreetMap. Die Empfehlung unten folgt aus den Datenquellen, nicht aus den vier Zeilen oben.

Daraus die Empfehlung:

• Hausadressen → Pelias. Es hat OpenAddresses als Quelle und findet Hausnummern, an denen Photon scheitert.
• Benannte Orte, Natur, POIs → Photon. Es bleibt bei dem, was in OpenStreetMap wirklich so heißt, und liefert mit osm_key/osm_value gleich die Art des Objekts mit.
• Beides gebraucht? Fragen Sie Pelias für Adresseingaben und Photon für die Ortssuche — oder Photon zuerst und Pelias als Rückfall, wenn die Eingabe wie eine Adresse aussieht (Ziffern enthält).

Ohne Ortsbindung sucht beides weltweit

Die Eingabe Klagen lieferte bei beiden einen Ort in Indonesien. Mit einer Ortsbindung auf Kärnten liefern beide korrekt Klagenfurt:

# Photon
curl -H "Authorization: Bearer <IHR-TOKEN>" -G "https://geocoder.pixelmap.at/api" \
  --data-urlencode "q=Klagen" --data-urlencode "lat=46.6247" --data-urlencode "lon=14.3053"

# Pelias
curl -G -H "Authorization: Bearer <IHR-TOKEN>" "https://pelias.pixelmap.at/v1/autocomplete" \
  --data-urlencode "text=Klagen" \
  --data-urlencode "focus.point.lat=46.6247" --data-urlencode "focus.point.lon=14.3053"

Für jede Eingabemaske, die während des Tippens sucht, ist das nicht optional.

Photon im Überblick

Die folgenden Seiten beschreiben Photon (geocoder.pixelmap.at):

• Vorwärts-Geokodierung — Text → Koordinaten
• Rückwärts-Geokodierung — Koordinaten → Ort
• Suchvorschläge — während des Tippens
• Beispiele · Fehler

Pelias hat ein eigenes Kapitel.

Zugriff

Beide Geocoder verlangen einen Token. Pelias nimmt ihn als Header Authorization: Bearer <IHR-TOKEN> oder als Parameter ?token=<IHR-TOKEN>, Photon nur als Header: Den Parameter token kennt Photon nicht und antwortet darauf mit 400. Die Beispiele setzen den Header. Wie Sie einen Token bekommen und warum er nicht in den Quelltext einer Webseite gehört, steht unter Zugriff auf die Dienste.