{"slug":"photon-geocoding-api","name":"Photon geocoding API","host":"photon.komoot.io","site":"https://komoot.io","category":"data","docsUrl":null,"sources":[{"kind":"changelog","url":"https://raw.githubusercontent.com/komoot/photon/master/CHANGELOG.md"},{"kind":"archive","url":"https://raw.githubusercontent.com/komoot/photon/master/docs/api-v1.md"}],"url":"https://www.okapi.bot/providers/photon-geocoding-api/","json":"https://www.okapi.bot/api/v1/providers/photon-geocoding-api.json","breakingChanges":[{"slug":"osm-tag-on-get-api-is-deprecated","api":"photon-geocoding-api","title":"osm_tag on GET /api is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /api","query parameter osm_tag"],"method":"GET","path":"/api","source":{"url":"https://raw.githubusercontent.com/komoot/photon/master/docs/api-v1.md","kind":"archive"},"quote":"Preferably use the 'include'/'exclude' category filters with the 'osm' category\ninstead of the direct osm tag filters here.","migration":"Filter with include=osm.<key>.<value> or exclude=osm.<key>.<value> category filters instead of osm_tag.","migrationChange":null,"needsDecision":null,"text":{"summary":"The query parameter osm_tag on GET /api has been deprecated without a shutdown date. Calls continuing to use osm_tag will eventually fail. The provider notes that developers should preferably use category filters instead of direct tag filtering.","migration":"Filter with include=osm.<key>.<value> or exclude=osm.<key>.<value> category filters instead of osm_tag.","by":"writer"},"publishedAt":"2026-10-23T10:19:37.223Z","updatedAt":"2026-10-26T03:34:42.496Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/photon-geocoding-api/breaking-changes/osm-tag-on-get-api-is-deprecated/"},{"slug":"osm-tag-on-get-reverse-is-deprecated","api":"photon-geocoding-api","title":"osm_tag on GET /reverse is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /reverse","query parameter osm_tag"],"method":"GET","path":"/reverse","source":{"url":"https://raw.githubusercontent.com/komoot/photon/master/docs/api-v1.md","kind":"archive"},"quote":"Preferably use the 'include'/'exclude' category filters with the 'osm' category\ninstead of the direct osm tag filters here.","migration":"Filter with include=osm.<key>.<value> or exclude=osm.<key>.<value> category filters instead of osm_tag.","migrationChange":null,"needsDecision":null,"text":{"summary":"The provider has deprecated the osm_tag query parameter on the GET /reverse endpoint without a shutdown date. Calls relying on this parameter will eventually fail once it is fully removed.","migration":"Filter with include=osm.<key>.<value> or exclude=osm.<key>.<value> category filters instead of osm_tag.","by":"writer"},"publishedAt":"2026-10-23T10:19:37.223Z","updatedAt":"2026-10-26T03:34:40.319Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/photon-geocoding-api/breaking-changes/osm-tag-on-get-reverse-is-deprecated/"}]}