Museum

This repository is now archived and subsequent works will be carried out the in Smart data models repositories. The latest version of this Data Model can be found at https://github.com/smart-data-models/dataModel.PointOfInterest

Description

This entity contains a harmonised geographic description of a museum. It is used in applications that use spatial data and is applicable to Tourism, Cultural, and Smart City vertical segments and related IoT applications. Special thanks to TURESPAÑA who provided some examples which inspired the development of this data model.

Data Model

A JSON Schema corresponding to this data model can be found here. This entity type has been designed as an extension of https://schema.org/Museum so that any property specified by schema.org and which domain is https://schema.org/Museum can be used by applications.

  • id : Unique identifier.

  • type : Entity type. It must be equal to Museum.

  • dataProvider : Specifies the URL to information about the provider of this information

    • Attribute type: Property. URL
    • Optional
  • dateModified : Last update timestamp of this entity.

    • Attribute type: Property. DateTime
    • Read-Only. Automatically generated.
  • dateCreated : Entity's creation timestamp.

    • Attribute type: Property. DateTime
    • Read-Only. Automatically generated.
  • source : A sequence of characters giving the source of the entity data.
    • Attribute type: Property. Text or URL
    • Optional
  • name : Name given to this museum.
    • Attribute type: Property. Text.
    • Normative References: https://uri.etsi.org/ngsi-ld/name equivalent to name
    • Mandatory
  • alternateName : Alternative name given to this museum.

  • description : Description of this museum.

    • Attribute type: Property. Text
    • Normative References: https://uri.etsi.org/ngsi-ld/description equivalent to description
    • Optional
  • location : Location of this museum represented by a GeoJSON geometry, usually a Point or a Polygon.

  • address : Address of this museum.
  • museumType : Type of museum according to the exhibited content.
    • Attribute type: Property. List of Text
    • Allowed values: (appliedArts, scienceAndTechnology, fineArts, music, history, sacredArt, archaeology, specials, decorativeArts, literature, medicineAndPharmacy, maritime, transports, military, wax, popularArtsAndTraditions, numismatic, unesco, ceramics, sumptuaryArts, naturalScience, prehistoric, ethnology, railway, mining, textile, sculpture, multiDisciplinar, painting, paleonthology, modernArt, thematic, architecture, museumHouse, cathedralMuseum, diocesanMuseum, universitary, contemporaryArt, bullfighting). Other possible source for museum types not covered above is Wikipedia.
    • Optional
  • owner : Museum's owner.

    • Attribute type: Property. List of Text or List of URIs or a List of references to an entity of type Person or Organization
    • Optional
  • featuredArtist : Main featured artist(s) at this museum.

    • Attribute type: Property. List of references to entities of type Person.
    • Optional
  • historicalPeriod : Corresponds to the historical period(s) of the exhibitions made by this museum.

    • Attribute type: Property. List of Text
    • Allowed values:
      • An ISO8601 time interval. For example 1920/1940. The second element of the interval can be left empty to denote "till now".
      • A comma separated list of years, for instance 1620,1625,1718.
      • A century, represented by a year pattern, for instance 19xx would correspond to the twentieth century. And 196x would correspond to the sixties decade.
    • Optional
  • artPeriod : Corresponds to the art period(s) of the exhibitions made by this museum.

    • Attribute type: Property. List of Text
    • Allowed values:
      • Those defined by Wikipedia.
      • Any other extended value needed by an application and not described by the above resource.
    • Optional
  • buildingType : Type of building that hosts the museum.

    • Attribute type: Property. Text
    • Allowed values: (prehistoricPlace, acropolis, alcazaba, aqueduct, alcazar, amphitheatre, arch, polularArchitecture, basilica, road, chapel, cartuja, nobleHouse, residence, castle, castro, catacombs, cathedral, cloister, convent, prehistoricCave, dolmen, officeBuilding, houseBuilding, industrialBuilding, militaryBuilding, hermitage, fortress, sculpturalGroups, church, garden, fishMarket, masia, masiaFortificada, minaret, monastery, monolith, walls, necropolis, menhir, mansion, palace, pantheon, pazo, pyramid, bridge, gate, arcade, walledArea, sanctuary, grave, synagogue, taulasTalayotsNavetas, theathre, temple, spring, tower, archeologicalSite, university, graveyard, fortifiedTemple, civilEngineering, square, seminar, bullfightingRing, publicBuilding, town, cavesAndTouristicMines, proCathedral, mosque, circus, burialMound)
    • Optional
  • facilities : Describes different facilities offered by this museum.

    • Attribute type: Property. List of Text
    • Allowed values: (elevator, cafeteria, shop, auditory, conferenceRoom, audioguide, cloakRoom, forDisabled, forBabies, guidedTour, restaurant, ramp, reservation) or any other value needed by an application.
    • Optional
  • openingHoursSpecification : Opening hours specification for this museum.

  • touristArea : Tourist area at which this museum is located. Precise semantics might depend on the application or target country or region. For instance Costa del Sol.

    • Attribute type: Property. Text
    • Optional
  • contactPoint : Contact point for the museum.

  • refSeeAlso : Reference to one or more related entities.

    • Attribute type: Property. List of References
    • Optional

Examples

Normalized Example

Normalized NGSI response

{
    "id": "Museum-Barcelona-MACBA-1234",
    "type": "Museum",
    "alternateName": {
        "value": "MACBA"
    },
    "openingHoursSpecification": {
        "value": [
            {
                "dayOfWeek": "Mo, Wed, Thu, Fr",
                "closes": "19:30",
                "opens": "11:00"
            },
            {
                "dayOfWeek": "Sat",
                "closes": "21:00",
                "opens": "10:00"
            },
            {
                "dayOfWeek": "Sun",
                "closes": "15:00",
                "opens": "10:00"
            }
        ]
    },
    "description": {
        "value": "The MACBA was designed by the American architect Richard Meier and inaugurated in 1995."
    },
    "source": {
        "value": "http://www.tourspain.es"
    },
    "artPeriod": {
        "value": ["contemporary"]
    },
    "museumType": {
        "value": ["fineArts"]
    },
    "facilities": {
        "value": ["shop", "cloakRoom", "guidedTour"]
    },
    "location": {
        "type": "geo:json",
        "value": {
            "type": "Point",
            "coordinates": [2.1668771521199393, 41.38302235796602]
        }
    },
    "address": {
        "type": "PostalAddress",
        "value": {
            "addressCountry": "ES",
            "addressLocality": "Barcelona",
            "streetAddress": "Plaza Dels \u00c0ngels, 1"
        }
    },
    "touristArea": {
        "value": "Barcelona-Capital"
    },
    "name": {
        "value": "Museo de Arte Contemporaneo de Barcelona"
    }
}

key-value pairs Example

Sample uses simplified representation for data consumers ?options=keyValues

{
    "id": "Museum-Barcelona-MACBA-1234",
    "type": "Museum",
    "name": "Museo de Arte Contemporaneo de Barcelona",
    "alternateName": "MACBA",
    "description": "The MACBA was designed by the American architect Richard Meier and inaugurated in 1995.",
    "address": {
        "addressCountry": "ES",
        "addressLocality": "Barcelona",
        "streetAddress": "Plaza Dels Àngels, 1"
    },
    "museumType": ["fineArts"],
    "artPeriod": ["contemporary"],
    "facilities": ["shop", "cloakRoom", "guidedTour"],
    "location": {
        "type": "Point",
        "coordinates": [2.1668771521199393, 41.38302235796602]
    },
    "openingHoursSpecification": [
        {
            "opens": "11:00",
            "closes": "19:30",
            "dayOfWeek": "Mo, Wed, Thu, Fr"
        },
        {
            "opens": "10:00",
            "closes": "21:00",
            "dayOfWeek": "Sat"
        },
        {
            "opens": "10:00",
            "closes": "15:00",
            "dayOfWeek": "Sun"
        }
    ],
    "touristArea": "Barcelona-Capital",
    "source": "http://www.tourspain.es"
}

LD Example

Sample uses the NGSI-LD representation

{
    "id": "urn:ngsi-ld:Museum:Museum-Barcelona-MACBA-1234",
    "type": "Museum",
    "alternateName": {
        "type": "Property",
        "value": "MACBA"
    },
    "openingHoursSpecification": {
        "type": "Property",
        "value": [
            {
                "dayOfWeek": "Mo, Wed, Thu, Fr",
                "closes": "19:30",
                "opens": "11:00"
            },
            {
                "dayOfWeek": "Sat",
                "closes": "21:00",
                "opens": "10:00"
            },
            {
                "dayOfWeek": "Sun",
                "closes": "15:00",
                "opens": "10:00"
            }
        ]
    },
    "description": {
        "type": "Property",
        "value": "The MACBA was designed by the American architect Richard Meier and inaugurated in 1995."
    },
    "source": {
        "type": "Property",
        "value": "http://www.tourspain.es"
    },
    "artPeriod": {
        "type": "Property",
        "value": ["contemporary"]
    },
    "museumType": {
        "type": "Property",
        "value": ["fineArts"]
    },
    "facilities": {
        "type": "Property",
        "value": ["shop", "cloakRoom", "guidedTour"]
    },
    "location": {
        "type": "GeoProperty",
        "value": {
            "type": "Point",
            "coordinates": [2.1668771521199393, 41.38302235796602]
        }
    },
    "address": {
        "type": "Property",
        "value": {
            "addressCountry": "ES",
            "addressLocality": "Barcelona",
            "streetAddress": "Plaza Dels \u00c0ngels, 1",
            "type": "PostalAddress"
        }
    },
    "touristArea": {
        "type": "Property",
        "value": "Barcelona-Capital"
    },
    "name": {
        "type": "Property",
        "value": "Museo de Arte Contemporaneo de Barcelona"
    },
    "@context": [
        "https://schema.lab.fiware.org/ld/context",
        "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"
    ]
}

Use it with a real service

Coming soon

Open Issues