Linked Art API: Name Structure

Table of Contents

Introduction

Names are linguistic labels given to some entity, and represented as a common JSON structure in all endpoints.

Names are described in the base patterns of the model documentation, and examples are present for practically every class.

Property Definitions

Properties of Names

Property Name Datatype Requirement Description
id string Optional If present, the value MUST be a URI identifying the name
type string Required The class for the name, which MUST be the value "Name"
_label string Optional A human readable label, intended for developers
content string Required The string form of the Name
classified_as array Recommended An array of json objects, each of which is a further classification of the name and MUST follow the requirements for Type
language array Recommended An array of json objects, each of which is a language present in the content of the name and MUST follow the requirements for Language
part array Optional An array of json objects, each of which is a part of the current name, and MUST follow these requirements for Names
referred_to_by array Optional An array of json objects, each of which is either a reference to a textual work that refers to the name, or an embedded statement about the name.

Property Diagram

diagram

Incoming Properties

Name instances are typically found as the object of the following properties. This list is not exhaustive, but is intended to cover the likely cases.

Property Name Source Class Description
identified_by All Names are used to provide an identifying label to the entity via identified_by.

(And that's all!)

Example

An object is given the name "Hacha (Ceremonial Axe)", with a note that the original form was 'hacha'.

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/object/7",
  "type": "HumanMadeObject",
  "identified_by": [
    {
      "type": "Name",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300404670",
          "type": "Type",
          "_label": "Primary Name"
        }
      ],
      "content": "Hacha (Ceremonial Axe)",
      "referred_to_by": [
        {
          "type": "LinguisticObject",
          "classified_as": [
            {
              "id": "http://vocab.getty.edu/aat/300027200",
              "type": "Type",
              "_label": "Note",
              "classified_as": [
                {
                  "id": "http://vocab.getty.edu/aat/300418049",
                  "type": "Type",
                  "_label": "Brief Text"
                }
              ]
            }
          ],
          "content": "Title was originally given as 'hacha'"
        }
      ],
      "language": [
        {
          "id": "http://vocab.getty.edu/aat/300389311",
          "type": "Language",
          "_label": "Spanish"
        },
        {
          "id": "http://vocab.getty.edu/aat/300388277",
          "type": "Language",
          "_label": "English"
        }
      ],
      "part": [
        {
          "type": "Name",
          "classified_as": [
            {
              "id": "http://vocab.getty.edu/aat/300312006",
              "type": "Type",
              "_label": "Subtitle"
            }
          ],
          "content": "Ceremonial Axe",
          "language": [
            {
              "id": "http://vocab.getty.edu/aat/300388277",
              "type": "Language",
              "_label": "English"
            }
          ]
        }
      ]
    }
  ]
}

graph TD classDef object stroke:black,fill:#E1BA9C,rx:20px,ry:20px; classDef actor stroke:black,fill:#FFBDCA,rx:20px,ry:20px; classDef type stroke:red,fill:#FAB565,rx:20px,ry:20px; classDef name stroke:orange,fill:#FEF3BA,rx:20px,ry:20px; classDef dims stroke:black,fill:#c6c6c6,rx:20px,ry:20px; classDef infoobj stroke:#907010,fill:#fffa40,rx:20px,ry:20px classDef timespan stroke:blue,fill:#ddfffe,rx:20px,ry:20px classDef place stroke:#3a7a3a,fill:#aff090,rx:20px,ry:20px classDef event stroke:#1010FF,fill:#96e0f6,rx:20px,ry:20px classDef literal stroke:black,fill:#f0f0e0; classDef classstyle stroke:black,fill:white; O1(object7) class O1 object; O1-- type -->O1_0[HumanMadeObject] class O1_0 classstyle; O2( _ ) class O2 name; O2-- type -->O2_0[Name] class O2_0 classstyle; O3(aat:300404670) class O3 type; O3-- type -->O3_0[Type] class O3_0 classstyle; O3-- _label -->O3_3("''Primary Name''") class O3_3 literal; O2-- classified_as -->O3 O2-- content -->O2_3("''Hacha (Ceremonial Axe)''") class O2_3 literal; O4( _ ) class O4 infoobj; O4-- type -->O4_0[LinguisticObject] class O4_0 classstyle; O5(aat:300027200) class O5 type; O5-- type -->O5_0[Type] class O5_0 classstyle; O5-- _label -->O5_3("''Note''") class O5_3 literal; O6(aat:300418049) class O6 type; O6-- type -->O6_0[Type] class O6_0 classstyle; O6-- _label -->O6_3("''Brief Text''") class O6_3 literal; O5-- classified_as -->O6 O4-- classified_as -->O5 O4-- content -->O4_3("''Title was originally given as 'hacha'''") class O4_3 literal; O2-- referred_to_by -->O4 O7(aat:300389311) class O7 type; O7-- type -->O7_0[Language] class O7_0 classstyle; O7-- _label -->O7_3("''Spanish''") class O7_3 literal; O2-- language -->O7 O8(aat:300388277) class O8 type; O8-- type -->O8_0[Language] class O8_0 classstyle; O8-- _label -->O8_3("''English''") class O8_3 literal; O2-- language -->O8 O9( _ ) class O9 name; O9-- type -->O9_0[Name] class O9_0 classstyle; O10(aat:300312006) class O10 type; O10-- type -->O10_0[Type] class O10_0 classstyle; O10-- _label -->O10_3("''Subtitle''") class O10_3 literal; O9-- classified_as -->O10 O9-- content -->O9_3("''Ceremonial Axe''") class O9_3 literal; O9-- language -->O8 O2-- part -->O9 O1-- identified_by -->O2
Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)

Future Considerations