JSON-LD

JSON-LD (JavaScript Object Notation for Linked Data) is a method of encoding linked data using JSON and of serializing data similarly to traditional JSON.^[1] It is meant to be simple to create by modifying JSON documents.^[2] JSON-LD is a World Wide Web Consortium Recommendation initially developed by the JSON for Linking Data Community Group,^[3] transferred to the RDF Working Group^[4] for review, improvement and standardization,^[5] and now maintained by the JSON-LD Working Group.^[6]

Design

JSON-LD is based on the concept of a "context" that maps JSON object properties to concepts in an ontology using an RDF model. In order to map the JSON-LD syntax to RDF, JSON-LD allows values to be coerced to a specified type or tagged with a language. A context can be embedded directly in a JSON-LD document or put into a separate file and referenced from traditional JSON documents via an HTTP Link header.

Example

{
  "@context": {
    "name": "http://xmlns.com/foaf/0.1/name",
    "homepage": {
      "@id": "http://xmlns.com/foaf/0.1/workplaceHomepage",
      "@type": "@id"
    },
    "Person": "http://xmlns.com/foaf/0.1/Person"
  },
  "@id": "https://me.example.com",
  "@type": "Person",
  "name": "John Smith",
  "homepage": "https://www.example.com/"
}

The example above describes a person, based on the FOAF (friend of a friend) ontology. First, the two JSON properties name and homepage and the type Person are mapped to concepts in the FOAF vocabulary and the value of the homepage property is specified to be of the type @id. In other words, the homepage id is specified to be an IRI in the context definition. Based on the RDF model, this allows the person described in the document to be unambiguously identified by an IRI. The use of resolvable IRIs allows RDF documents containing more information to be transcluded which enables clients to discover new data by following those links; this principle is known as 'Follow Your Nose'.^[7]

By having all data semantically annotated as in the example, an RDF processor can identify that the document contains information about a person (@type) and if the processor understands the FOAF vocabulary it can determine which properties specify the person's name and homepage.

Use

The encoding is used by Schema.org,^[8] Google Knowledge Graph,^[9][10][11] and used mostly for search engine optimization activities. It has also been used for applications such as biomedical informatics,^[12] and representing provenance information.^[13] It is also the basis of Activity Streams, a format for "the exchange of information about potential and completed activities",^[14] and is used in ActivityPub, the federated social networking protocol.^[15] Additionally, it is used in the context of Internet of Things (IoT), where a Thing Description,^[16] which is a JSON-LD document, describes the network facing interfaces of IoT devices.

See also

• Hypertext Application Language

References

External links

• JSON-LD.org