Einführung

Pelias ist der zweite Geocoder von pixel.map. Er zieht mehrere Datenquellen zusammen — OpenStreetMap, OpenAddresses, WhosOnFirst, GeoNames — und ist dadurch bei Hausadressen deutlich treffsicherer als Photon.

Basis-URL: https://pelias.pixelmap.at/v1

Welchen der beiden Sie nehmen sollten und woran wir das gemessen haben, steht im Vergleich.

Endpunkte

Endpunkt	Zweck
/search	Vollständige Suche — Text → Orte
/autocomplete	Vorschläge während des Tippens
/reverse	Koordinaten → Ort

Suche

curl -G -H "Authorization: Bearer <IHR-TOKEN>" "https://pelias.pixelmap.at/v1/search" \
  --data-urlencode "text=Domgasse 1 Klagenfurt" \
  --data-urlencode "size=5"

Gemessen am 14.09.2026: liefert Domgasse 1, Klagenfurt, KA, Austria, layer: address, Quelle openaddresses — dieselbe Anfrage, an der Photon scheitert.

Antwort

{
  "type": "FeatureCollection",
  "geocoding": { … },
  "bbox": [ … ],
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [ … ] },
      "properties": {
        "label": "Domgasse 1, Klagenfurt, KA, Austria",
        "layer": "address",
        "source": "openaddresses",
        "confidence": 1,
        "accuracy": "point",
        "country": "Austria",
        "country_a": "AUT",
        "county": "…",
        "gid": "openaddresses:address:…"
      }
    }
  ]
}

Drei Felder tragen die Auswertung:

Feld	Bedeutung
label	Der fertig formatierte Anzeigename — kein Zusammenbauen nötig
layer	Was gefunden wurde: address, street, locality, venue, region …
source	Woher: openaddresses, openstreetmap, whosonfirst, geonames
confidence	Selbsteinschätzung zwischen 0 und 1

layer auswerten, nicht nur label anzeigen

layer sagt, ob Sie eine Hausadresse, eine Straße oder eine ganze Ortschaft bekommen haben. Wer eine Adresse erwartet und layer: locality zurückbekommt, hat einen Treffer mit hoher confidence, aber nicht die gesuchte Genauigkeit.

Gemessen: Klagenfurt Domgasse lieferte einen Treffer mit confidence: 1 — und zwar layer: venue aus GeoNames, nicht die Straße. Die Selbstsicherheit des Dienstes sagt nichts über die Art des Treffers.

Vorschläge während des Tippens

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

focus.point ist nicht optional

Ohne Ortsbindung sucht Pelias weltweit — gemessen lieferte Klagen einen Ort in Indonesien. Mit focus.point.lat/focus.point.lon auf Kärnten kommt Klagenfurt.

Anders als bei Photon (lat/lon) heißen die Parameter hier focus.point.lat und focus.point.lon — mit Punkten im Namen.

Rückwärts

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

Auch hier die Punkt-Schreibweise: point.lat, point.lon.

Einschränken

Parameter	Wirkung
boundary.country	Nur ein Land, z. B. AT
boundary.rect.min_lat u. a.	Nur ein Ausschnitt
layers	Nur bestimmte Arten, z. B. address,street
sources	Nur bestimmte Quellen, z. B. openaddresses
size	Anzahl der Treffer

layers=address ist der direkte Weg, wenn Sie ausschließlich Hausadressen wollen und keine Ortschaften in der Liste dulden.

Fehler und leere Ergebnisse

Gemessen am 14.09.2026:

Fall	Antwort
Anfrage ohne text	400
Keine Treffer	200, features leer, kein Fehlereintrag

Kein Treffer ist kein Fehler

Wie bei Photon: eine erfolglose Suche kommt mit 200 und leerer features-Liste zurück. Prüfen Sie die Länge der Liste, nicht den Statuscode.

Zugriff

Pelias verlangt einen Token, als Header Authorization: Bearer <IHR-TOKEN> oder als Parameter ?token=<IHR-TOKEN>. 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.