Vorwärts-Geokodierung

Text → Koordinaten.

GET https://geocoder.pixelmap.at/api

Beispiel

curl -H "Authorization: Bearer <IHR-TOKEN>" -G "https://geocoder.pixelmap.at/api" \
  --data-urlencode "q=Klagenfurt Domgasse" \
  --data-urlencode "lang=de" \
  --data-urlencode "limit=2"

Parameter

Parameter	Bedeutung
`q`	Die Suchanfrage. Pflicht.
`lang`	Sprache der Ergebnisnamen (`de`, `en`, `fr`, …)
`limit`	Anzahl der Treffer
`lat` / `lon`	Ortsbindung — Treffer in der Nähe werden bevorzugt
`bbox`	Begrenzt die Suche auf einen Ausschnitt (`west,süd,ost,nord`)
`osm_tag`	Filtert auf OSM-Objektarten, z. B. `place:city` oder `!highway`

Antwort

GeoJSON, direkt in eine Karte einsetzbar:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [14.3097405, 46.6239876] },
      "properties": {
        "name": "Domgasse",
        "district": "Innere Stadt",
        "postcode": "9020",
        "city": "Klagenfurt",
        "state": "Kärnten",
        "country": "Österreich",
        "countrycode": "AT",
        "osm_key": "highway",
        "osm_value": "residential",
        "osm_type": "W",
        "osm_id": 24218742,
        "type": "street",
        "extent": [14.3097394, 46.6243119, 14.3097528, 46.6236634]
      }
    }
  ]
}

osm_key und osm_value sind der eigentliche Gewinn gegenüber einem reinen Adress-Geocoder: Sie sagen, was gefunden wurde — water/lake, natural/peak, place/city, highway/residential. Damit lässt sich ein Ergebnis einordnen, ohne den Namen zu interpretieren.

osm_tag schränkt die Suche ein — das ist wirksamer, als hinterher zu filtern:

# nur Ortschaften, keine Straßen
curl -H "Authorization: Bearer <IHR-TOKEN>" -G "https://geocoder.pixelmap.at/api" \
  --data-urlencode "q=Velden" --data-urlencode "osm_tag=place"

# alles außer Straßen
curl -H "Authorization: Bearer <IHR-TOKEN>" -G "https://geocoder.pixelmap.at/api" \
  --data-urlencode "q=Velden" --data-urlencode "osm_tag=!highway"

Hausnummern

Photon findet Hausnummern nur, soweit OpenStreetMap sie kennt — gemessen lieferte Domgasse 1 Klagenfurt ein Gebäude in Maria Saal, also den falschen Ort. Für Adresseingaben ist Pelias die bessere Wahl; es zieht OpenAddresses hinzu und fand dieselbe Adresse korrekt.