photon-geocoderlisted

# Photon Geocoder API Open-source geocoder for OpenStreetMap data. Free public instance at `photon.komoot.io` (rate-limited) or self-hosted via `java -jar photon.jar serve` on port 2322. ## When to Use - Converting addresses/place names to coordinates (forward geocoding) - Converting coordinates to addresses (reverse geocoding) - Building search-as-you-type address autocomplete - Filtering places by OSM tags, layers, or categories - Need free, no-API-key geocoding with multilingual support **Not for:** Routing/directions (use OSRM/GraphHopper), map tile rendering, POI databases. ## Quick Reference | Endpoint | Purpose | Required Params | |----------|---------|-----------------| | `GET /api` | Forward search | `q` (search term) | | `GET /structured` | Structured address search | At least one of: `city`, `street`, `postcode`, etc. | | `GET /reverse` | Reverse geocode | `lat`, `lon` | | `GET /status` | Health check + data date | None | **Public instance:** `https://photon.komoot.io` (add `/api?q=...`) **Self-hosted default:** `http://localhost:2322` ## Autocomplete Pattern ``` GET /api?q=via+rom&lat=41.89&lon=12.49&zoom=14&limit=5&lang=it&layer=street&layer=house ``` Use `lat`/`lon`/`zoom` for location bias, `layer` to restrict to streets/houses, `limit=5` for fast responses. Fire on each keystroke with debounce (200-300ms). ## Location-Biased Search ``` GET /api?q=farmacia&lat=45.46&lon=9.19&zoom=14&location_bias_scale=0.1&osm_tag=amenity:pharmacy&limit=5 ``` Low `