Venues

A resource that implements the concept of Venue defined in the AlpineBits® Ontology.

A JSON object representing such a resource MUST contain the following fields:

• type: the constant "venues" that identifies the resource as being of the type venue.

• id: a string that uniquely and persistently identifies the venue within a SERVER. See the definition in ???.

• attributes: an object containing the attributes of the venue.

• relationships: an object containing the relationships of the venue to other resources.

• links: an object containing the links related to the venue.

Venue resources are structured in the following way:

{
  "type": "venues",
  "id": "1",
  "meta": { ... },
  "attributes": { ... },
  "relationships": { ... },
  "links": { ... }
}

Meta

See the definition of the meta object in ???.

Attributes

The attributes object of the venue resource MUST contain the following fields:

• abstract: a ??? object containing a brief description of the venue. Nullable. See the definition in ???.

• address: an ??? object containing the address of the venue. Nullable.

• description: a ??? object containing a description of the venue. Nullable. Conditional Assignment. See the definition in ???.

• geometries: an array of ??? objects each of which represents the location of the venue in terms of GPS coordinates. There should be at most one geometry object of each type (e.g. Point, LineString). Nullable. Non-empty.

• howToArrive: a ??? object containing instructions on how to arrive at the venue. Nullable.

• name: a ??? object containing the complete name of the venue. Non-nullable. Conditional Assignment. See the definition in ???.

• shortName: a ??? object containing a short name of the venue. Nullable. See the definition in ???.

• url: a ??? object or string describing the venue, such as a website or a Wikipedia page. Nullable. See the definition in ???.

A summary of the attributes object is presented in the table below:

Field	Type	Constraints
abstract	???	Nullable
address	???	Nullable
description	???	Nullable, Conditional Assignment
geometries	Array of ???	Nullable, Non-empty
howToArrive	string	Nullable
name	???	Non-nullable, Conditional Assignment
shortName	???	Nullable
url	???	Nullable

Relationships

The relationships object of a mountain area resource MUST contain the following fields:

• categories: a ??? category resources that are instantiated by the venue. See Section ???. Nullable. Non-empty.

  No category is pre-defined by the standard.

• multimediaDescriptions: a ??? media object resources (see ???) that are related to the venue. See Section ???. Nullable. Non-empty.

A summary of the relationships is presented in the table below:

Field	Type	Constraints
categories	??? object to ???	Nullable, Non-empty
multimediaDescriptions	??? object to ???	Nullable, Non-empty

Links

See the definition of the links object in ???.

Examples

The following example presents an object containing the minimal information required of a venue resource:

{
  "type": "venues",
  "id": "1",
  "meta": {
    "dataProvider": null,
    "lastUpdate": null
  },
  "attributes": {
    "abstract": null,
    "address": null,
    "description": null,
    "geometries": null,
    "howToArrive": null,
    "name": {
      "eng": "Auditorium 1"
    },
    "shortName": null,
    "url": null
  },
  "relationships": {
    "categories": null,
    "multimediaDescriptions": null
  },
  "links": {
    "self": "https://example.com/2022-04/venues/1"
  }
}

asciidoc/examples/venue.min.json

The following example presents an object representing a venue resource:

{
  "type": "venues",
  "id": "1",
  "meta": {
    "dataProvider": "https://example.com",
    "lastUpdate": "2020-04-01T08:00:00+02:00"
  },
  "attributes": {
    "abstract": {
      "eng": "The Auditorium 1 of the Free University of Bozen-Bolzano provides a great space for keynotes, lectures and presentations."
    },
    "address": {
      "street": {
        "ita": "Piazza Università, 1",
        "deu": "Universitätsplatz 1"
      },
      "city": {
        "deu": "Bozen"
      },
      "region": {
        "deu": "Trentino-Südtirol"
      },
      "country": "IT",
      "zipcode": "39100",
      "complement": {
        "deu": "Hauptgebäude"
      },
      "categories": [
        "example:building"
      ]
    },
    "description": {
      "eng": "The Auditorium 1 of the Free University of Bozen-Bolzano provides a great space for keynotes, lectures and presentations, being available to host events related academic, provincial and cultural topics."
    },
    "geometries": [
      {
        "type": "Point",
        "coordinates": [
          11.35087251663208,
          46.49873937419277
        ]
      }
    ],
    "howToArrive": {
      "eng": "From the train station, the Free University of Bozen-Bolzano is accessible in a 5 minutes walk into the historical city center."
    },
    "name": {
      "eng": "Auditorium 1 - Free University of Bozen-Bolzano"
    },
    "shortName": {
      "eng": "Auditorium 1"
    },
    "url": "https://example.com/auditorium-1"
  },
  "relationships": {
    "categories": {
      "data": [
        {
          "type": "categories",
          "id": "example:auditorium"
        }
      ],
      "links": {
        "related": "https://example.com/2022-04/venues/1/categories"
      }
    },
    "multimediaDescriptions": {
      "data": [
        {
          "type": "mediaObjects",
          "id": "1"
        }
      ],
      "links": {
        "related": "https://example.com/2022-04/venues/1/multimediaDescriptions"
      }
    }
  },
  "links": {
    "self": "https://example.com/2022-04/venues/1"
  }
}

asciidoc/examples/venue.full.json