# Townlands.io

> Townlands.io is a public, map-first atlas of Irish townlands, counties, baronies, civil parishes, electoral divisions and local boundaries.

Townlands.io public production content is canonical at https://townlands.io. Development, preview and localhost copies are not the canonical source and should not be indexed or cited as public launch URLs.

Important interpretation notes:
- Public route HTML includes canonical URLs, Open Graph/Twitter metadata, JSON-LD, breadcrumbs and a no-JavaScript text summary.
- The sitemap is the route inventory for indexable public pages.
- Use the human route URL as the citation URL, not preview domains or JSON helper endpoints.
- Boundary and place content is built from open geographic and place-name sources. Check the attribution page for source and licence context.
- OAI-SearchBot and browser/user-initiated agents may crawl the production site. Dev and preview hosts are blocked or noindexed.

## Primary URLs
- [Home](https://townlands.io/): Townlands of Ireland overview.
- [Robots](https://townlands.io/robots.txt): Production crawler policy.
- [Sitemap](https://townlands.io/sitemap.xml): Sitemap index for public route discovery.
- [Attribution](https://townlands.io/attribution): Data sources, licences and acknowledgements.
- [Route summary API](https://townlands.io/agent-route-summary.json?path=/munster/tipperary): JSON summary for one public route.

## Route Patterns
- [Province example](https://townlands.io/munster): /:province
- [County example](https://townlands.io/munster/tipperary): /:province/:county
- [Barony example](https://townlands.io/munster/kerry/iveragh): /:province/:county/:barony
- [Civil parish example](https://townlands.io/munster/kerry/iveragh/cill-imleach): /:province/:county/:barony/:civil-parish
- [Electoral division example](https://townlands.io/munster/kerry/iveragh/cill-imleach/portmagee): /:province/:county/:barony/:civil-parish/:electoral-division
- [Townland example](https://townlands.io/munster/kerry/iveragh/cill-imleach/portmagee/portmagee): /:province/:county/:barony/:civil-parish/:electoral-division/:townland

## Optional
- [Open Graph image API](https://townlands.io/api/og): Used by page metadata; representative cached images are generated during the OG image workflow.