This vocabulary allows representing data related to public lighting, including data related to streetlights, luminaries, lamps, poles and lighting boxes. It has been developed in the context of the OpenCityData initiative.
A first version of this vocabulary was created in the context of the International Open Data Day. This new version takes into account the results obtained in that first version of the vocabulary, the problems identified in its use and the advances made in recent years in the proposal of ontology design patterns for cities and in models such as the one proposed by FI-WARE. This updated version of the vocabulary has been generated during the development of a final degree project at the Escuela Técnica Superior de Ingenieros Informáticos of the Universidad Politécnica de Madrid.
Terms from various vocabularies and data models are reused:
esalumb | <http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico> |
schema | <http://schema.org> |
esdir | <http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/direccion-postal> |
esalumb-kos | <http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico> |
esequip | <http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/equipamiento-municipal> |
owl | <http://www.w3.org/2002/07/owl> |
xsd | <http://www.w3.org/2001/XMLSchema> |
skos | <http://www.w3.org/2004/02/skos/core> |
rdfs | <http://www.w3.org/2000/01/rdf-schema> |
geosparql | <http://www.opengis.net/spec/geosparql> |
esadm | <http://vocab.linkeddata.es/def/sector-publico/territorio> |
rdf | <http://www.w3.org/1999/02/22-rdf-syntax-ns> |
terms | <http://purl.org/dc/terms> |
xml | <http://www.w3.org/XML/1998/namespace> |
dc | <http://purl.org/dc/elements/1.1> |
The figure from below contains the classes and properties from the public lighting vocabulary.
Partial descriptions of the different components of the vocabulary will be provided below.
The esequip:Equipment class is subclass of the geosparql:Feature class that belongs to the geospatal data pattern.
The pattern of the geospatial data uses the geo and geosparql vocabularies. To obtain the geolocation of an equipment (for example, a streetlight) we use the object property geosparql:has geometry that has a relation with the geosparql:Geometry class. The geosparql:Point class is a subclass of the geosparql:Geometry class and it has attributes like the latitude (geo:lat) and longitude (geo:long).
The following example is the geolocation using the attributes geo:lat and geo:long.
<http://example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/123456/geometry> a geosparql:Point;
geo:lat "-3.657807"^^xsd:double;
geo:long "40.461237"^^xsd:double;
The esalumb:Streetlight class is a subclass of the esequip:Equipment class, it is used to represent the data about the municipal equipment. It includes the attributes esequip:startingDate that refers to the date when the streetlight was installed, esequip:endingDate that refers to the date when the streetlight was desinstalled and esequip:reviewDate that represents if the equipment has had a review. It is also identified with the dct:identifier
The following example has attributes of the Equipment class and from the Streetlight class to describe a streetlight.
In this case the class that represents the municipal equipment has an attribute thet represents the identifier that has every streetlight. From the streetlight class we have three attributes:the maximun heigh of a streetlight, the width between one of the luminaries to its opposite and the control cabinet where the streetlightas are controlled.
<http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/123456> a esalumb:Streetlight;
dct:identifier "123456"^^xsd:string;
esalumb:width "3"^^xsd:float;
esalumb:heigh "6"^^xsd:float;
esalumb:controlCabinet "Caseta de Camineros "^^xsd:string;
The esalumb:Streetlight class is related with the esdir:DireccionPostal class using the property schema:address.
The esdir:DireccionPostal class has two object properties esadm:neighborhood and esadm:district, that are defined in the esadm vocabulary, they are related with the classes esadm:Neighborhodd and esadm:District that refers to the neighborhodd and district where the streetlight is located.
The class esdir:DireccionPostal is subclass of the schema:PostalAddress class defined by the schema vocabulary and it has as its atributtes schema:streetAddress that refers to the complete name of the street including the number and the venue type where the streetlight is located, schema:addressCountry that refers to the country where the streetlight is located and schema:addressLocality that refers to the locality where the streetlight is located.
The following example has attributes of the classes from before.
<http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/123456/address> a esdir:DireccionPostal, schema:PostalAddress;
schema:streetAddress "CALLE DE GOMEZNARRO 54"^^xsd:string;
schema:locality "Madrid"^^xsd:string;
schema:country "España"^^xsd string;
esadm:district <http://www.example.org/madrid/recurso/sector-publico/territorio/distrito/Hortaleza>;
esadm:neighborhood <http://www.example.org/madrid/recurso/sector-publico/territorio/barrio/3>;
The esalumb:Streetlight class is related to the parts that compose the streetlight using the object properties esalumb:box, esalumb:pole and esalumb:luminary. The lamp is related to the luminary using the object property esalumb:hasLamp.
We can also see the classes that have a skos concept schemes associated, the esalumb:Box class has a skos list that represents the different types of cables that a streetlight can use esalumb-kos:cableType, the esalumb:Pole class has a skos list that represents the different types of holders it can have esalumb-kos:holderType, the esalumb:Luminary class has a skos list that represents the different types of luminaries that can be used esalumb-kos:luminaryType and lastly the esalumb:Lamp class has a skos list that represents the different types of lamp that can be used esalumb-kos:lampType.
The SKOS concept schemes are defined int the repository SKOS
The following example has the use of the skos lists and the use of the Luminary class.
We have the holderType skos list that represents the different types of holders a streetlight can have, a list that represents the different types of lamp that a streetlight can have, another list that represents the different types of cables that a streetlight can have and lastly the last skos list is about the different types of luminaries that a streetlight can have. We also have an attribute ehat represents the number of luminaries that a streetlight has.
<http://www.example.org/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/2023> a esalumb:Farola;
dct:identifier "2023"^^xsd:string;
esalumb:box <http://www.example.org/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/2023/caja>;
esalumb:luminary <http://www.example.org/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/2023/luminaria>;
esalumb:pole <http://www.example.org/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/2023/soporte>;
<http://www.example.org/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/2023/soporte> a esalumb:Soporte;
esalumb-kos:holderType <http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipo-soporte/poste>;
<http://www.example.org/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/2023/luminaria> a esalumb:Luminaria;
esalumb:lamp <http://www.example.org/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/2023/lampara>;
esalumb:numberOfLuminaries "1"^^xsd:int;
esalumb-kos:luminaryType <http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipo-luminaria/proyector> ;
<http://www.example.org/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/2023/lampara> a esalumb:Lampara ;
esalumb-kos:lampType <http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipo-lampara/led>;
<http://www.example.org/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/2023/caja> a esalumb:Caja ;
esalumb-kos:cableType <http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipo-cable/ET103>;
The esalumb:Streetlight class has three related SKOS lists, the first one esalumb-kos:powerType where we have the different types of source that a streetlight can have, the second one esalumb-kos:iluminationType where we have the different types of ilumination that a streetlight can have and lastly esalumb-kos:lightingType where we have the different types of lighting that a streetlight can have.
The following example has the three types of skos lists that the Streetlight can have.
<http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/123456> a esalumb:Streetlight;
dct:identifier "123456"^^xsd:string;
esalumb-kos:powerType <http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipo-alimentacion/subterranea>;
esalumb-kos:iluminationType <http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipo-iluminacion/permanente>;
esalumb-kos:lightingType <http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipo-alumbrado/s1>;
In order to make easier the understanding of the use of all of these classes and properties of the vocabulary an example from the data provided by the city hall of Madrid is going to be generated dataset. The complete transformation is available in GitHub
<http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/20040016> a esalumb:Streetlight;
dct:identifier "20040016"^^xsd:string;
schema:address <http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/20040016/address>;
esalumb:luminary <http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/20040016/luminaria>;
geosparql:geometry <http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/20040016/geometry>;
<http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/20040016/luminaria> a esalumb:Luminary;
esalumb:lamp <http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/20040016/lampara>;
<http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/20040016/lampara> a esalumb:Lamp;
esalumb:bulbModel "LBE002"^^xsd:string;
esalumb-kos:lampType <http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipo-lampara/descarga>;
<http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/20040016/address> a schema:PostalAddress;
schema:country "España"^^xsd:string;
schema:locality "Madrid"^^xsd:string;
schema:streetAddress "CALLE DE LAS ERAS 3" ;
esadm:neighborhood <http://www.example.org/datosabiertos/recurso/sector-publico/territorio/barrio/4>;
esadm:district <http://www.example.org/datosabiertos/recurso/sector-publico/territorio/distrito/Hortaleza>;
<http://www.example.org/datosabiertos/recurso/urbanismo-infraestructuras/alumbrado-publico/farola/20040016/geometry> a geosparql:Geometry;
geo:lat "-3.657807"^^xsd:double ;
geo:long "40.461237"^^xsd:double;
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#Caja
IRI: http://www.w3.org/2004/02/skos/core#ConceptScheme
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/direccion-postal#DireccionPostal
IRI: http://vocab.linkeddata.es/def/sector-publico/territorio#Distrito
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/equipamiento-municipal#Equipamiento
IRI: http://www.opengis.net/spec/geosparql/Feature
IRI: http://www.opengis.net/spec/geosparql/Geometry
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#Lampara
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#Farola
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#Luminaria
IRI: http://vocab.linkeddata.es/def/sector-publico/territorio#Barrio
IRI: http://www.opengis.net/spec/geosparql/Point
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#Poste
IRI: http://schema.org#PostalAddress
IRI: http://www.opengis.net/spec/geosparql/SpatialObject
IRI: http://schema.org/address
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#caja
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#tipoCable
IRI: http://www.opengis.net/spec/geosparql/hasGeometry
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#tieneLampara
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#tipoSoporte
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#tipoIluminacion
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#tipoLampara
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#tipoAlumbrado
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#luminaria
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#tipoLuminaria
IRI: http://vocab.linkeddata.es/datosabiertos/def/sector-publico/territorio/barrio
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#poste
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#tipoAlimentacion
IRI: http://vocab.linkeddata.es/def/secctor-public/territorio/distrito
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#accesorios
IRI: http://schema.org/addressCountry
IRI: http://schema.org/addressLocality
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#alturaBrazo1
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#alturaBrazo2
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#modeloBombilla
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#consumo
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#gabineteDeControl
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#metodoDeControl
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/equipamiento-municipal/fechaBaja
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#altura
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/equipamiento-municipal/identifier
IRI: http://www.opengis.net/spec/geosparql/Latitude
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#intensidadLuminica
IRI: http://www.opengis.net/spec/geosparql/long
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#fabricante
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#material
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#numeroDeBrazos
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#numeroDeLamparas
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#numeroDeLuminarias
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#propietario
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#potencia1
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#potencia2
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/equipamiento-municipal/fechaRevision
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/equipamiento-municipal/fechaAlta
IRI: http://schema.org/streetAddress
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#anchura
IRI: http://vocab.linkeddata.es/datosabiertos/def/urbanismo-infraestructuras/alumbrado-publico#horasDeFuncionamiento
IRI: http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipoCable
IRI: http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipoSoporte
IRI: http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipoIluminacion
IRI: http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipoLampara
IRI: http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipoAlumbrado
IRI: http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipoLuminaria
IRI: http://vocab.linkeddata.es/datosabiertos/kos/urbanismo-infraestructuras/alumbrado-publico/tipoAlimentacion
The authors would like to thank Silvio Peroni for developing LODE, a Live OWL Documentation Environment, which is used for representing the Cross Referencing Section of this document and Daniel Garijo for developing Widoco, the program used to create the template used in this documentation.