Skip to content

A standard to describe the accessibility of the physical world.

A11yJSON icon 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
  • 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
  }
}

See the examples for more complex definitions, or the list of accessibility criteria to see the format's extent.

Is this for me?

If you build an app that digitalizes any aspect of real life, you decide if it adds a new barrier to this real world – or creates a new entrance. Use this power wisely and ensure that your data design is inclusive. 🦾

A11yJSON can help you if you work with data in…

  • Architecture
  • Indoor navigation
  • Facility management
  • Accessibility surveys
  • Location-based services
  • Outdoor/transit navigation
  • Building Information Management (BIM)

Here is a list of projects using A11yJSON.

Technically…

A11yJSON provides a collection of documented interfaces 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, and sharing it on Twitter! 🙌