index.md

A standard to describe the accessibility of the physical world.

A11yJSON is an open standard based on GeoJSON (RFC 7946). Its goal is to make accessibility information more comfortable to exchange.

Integrate A11yJSON into data schemas that describe…

• real places
• local amenities, like elevators, escalators, or vending machines
• sanitary facilities
• physical media and services
• policies that can be barriers (like dog friendliness)
• escalators and elevators (including their real-time operational status)

This is a valid A11yJSON data snippet:

{
  "entrances": [
    { "name": "30th St", "isMainEntrance": true, "isLevel": false },
    { "name": "Side gate", "hasFixedRamp": true }
  ],
  "animalPolicy": {
    "allowsGuideDogs": false
  }
}

The docs provide examples (for example, a cinema, canteen, an elevator) for more complex definitions, or the list of accessibility criteria to see the format's extent.

Is this for me?

See the FAQ.

Here is a list of projects using A11yJSON.

Technically…

A11yJSON provides a collection of documented data model for structuring data in your projects – no matter which language you use.

It comes with a TypeScript library to check your data structures at compile-time.

For web and Node.js, there is @sozialhelden/a11yjson, a npm module. The model validates data at runtime using SimpleSchema, sanitizes input, and returns sophisticated error messages for wrong data.

The schema definition API is simple to read, so the schema should be portable to other schema languages (GraphQL, JSON Schema, …), if necessary. If you have a specific idea, let’s talk!

Who is behind A11yJSON?

A11yJSON is made by Sozialhelden e.V., a non-profit that works on innovative solutions to social issues. It’s based in Berlin, Germany, and known for Wheelmap.org, the world’s biggest open online map of accessible places.

Finally…

If you think that A11yJSON deserves attention, consider giving it a Star on GitHub, share the project on social media, and tell your friends! 🙌