@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix ns1: <http://schema.org/> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
@prefix vcard: <http://www.w3.org/2006/vcard/ns#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

<https://www.avoindata.fi/data/dataset/c6637fbd-2bcf-4ef1-a1fb-f333d235a072> a dcat:Dataset ;
    dct:accrualPeriodicity [ a dct:Frequency ;
            rdf:value "vuorokausi, day, dag" ] ;
    dct:description """Helsingin kaupungin palvelukiinteistöjen energiankulutustietoja tarjoava Nuuka open API on kanava, jonka kautta käyttäjä pystyy hakemaan tietoja Helsingin kaupungin omistamista kiinteistöistä ja niiden energiankulutuksesta. Rajapinta on täysin avoin, eikä vaadi tunnistautumista.\r
\r
Rajapinnat jakautuvat kiinteistöjen tietojen hakuun ja energiadatan hakuun. Hakuja pystyy tekemään kohteen nimen, kohteen käyttötarkoituksen ja kohteen kiinteistönumeron perusteella.\r
\r
Kiinteistöt pystyy listaamaan ja niistä pystyy hakemaan tarkempaa tietoa. Huomioitavaa on ero kiinteistöjen ja rakennusten välillä: yksi kiinteistö voi sisältää useita rakennuksia, esimerkiksi koulun ja päiväkodin. Kiinteistön tietoja hakiessa palautetaan myös kiinteistön sisältämien rakennusten tiedot. Koordinaateissa käytetty koordinaattijärjestelmä on WGS84 Web Mercator (EPSG:3857).\r
\r
Energiadataa voi hakea kuukausi-, päivä- ja tuntitasolla. Datan saatavuus ja tarkkuus vaihtelee kohteittain. Kaikkein vanhin data on vuositasolla, alkaen n.1980. Tarkin, tuntikohtainen data on pääsääntöisesti saatavilla alkaen 2015. Mahdollisia raportointiryhmiä on neljä: sähkö, lämmitys, vesi ja jäähdytys. Kaikki energiadata näytetään kiinteistön päämittaritasolla. Kuukausikohtaisen datan pystyy hakemaan myös normalisoituna. Data päivittyy kerran vuorokaudessa.\r
\r
Tarkemmat tiedot eri rajapinnoista löytyvät [Swagger-dokumentaatiosta](https://helsinki-openapi.nuuka.cloud/swagger). Tiedot palautetaan JSON-formaatissa.\r
\r
Kannan tiedoissa esiintyy puutteita. Aukkoja aikasarjoissa voi esiintyä kaikilla tasoilla ja koko katetulla aikavälillä. Datan validoinnin tarkkuus riippuu energiatyypistä ja datan lähteestä, joka puolestaan riippuu ajankohdasta ja kohteesta. Lähtökohtaisesti data on sitä eksaktimpaa mitä uudempaa se on. Kaikkein uusinta dataa myös monitoroidaan ja korjataan virheiden ilmetessä\r
\r
**Esimerkkihakuja**\r
\r
1. Listaa kaikki kiinteistöt: https://helsinki-openapi.nuuka.cloud/api/v1.0/Property/List?Customer=Helsinki\r
2. Hae päivittäinen energiankulutus (ReportingGroup=Electricity) kiinteistölle Hakaniemen kauppahalli (PropertyName=1000 Hakaniemen Kauppahalli) vuodelle 2019:  https://helsinki-openapi.nuuka.cloud/api/v1.0/EnergyData/Daily/ListByProperty?Customer=Helsinki&Record=LocationName&SearchString=1000%20Hakaniemen%20kauppahalli&ReportingGroup=Electricity&StartTime=2019-01-01&EndTime=2019-12-31""",
        """Nuuka open API, which provides energy consumption information for the City of Helsinki’s service properties, is a channel through which the user can search for information about properties owned by the City of Helsinki and their energy consumption. The interface is completely open and does not require authentication. \r
\r
The APIs are divided into property data search and energy data search. Searches can be made based on the feature’s name, purpose of use and property number. \r
\r
The properties can be listed, and you can search for more detailed information about them. Note the difference between properties and buildings: one property can include several buildings, such as a school and a daycare centre. When searching for property data, the data of the buildings contained in the property are also returned. The coordinate system used is WGS84 Web MERCATOR (EPSG:3857). \r
\r
Energy data can be searched for at the monthly, daily and hourly level. The availability and accuracy of the data varies according to the feature. The oldest data is at the annual level, starting from around 1980. The most accurate, hourly data is generally available from 2015. There are four possible reporting groups: electricity, heating, water and cooling. All energy data is displayed at the property’s main meter level. Monthly data can also be retrieved as normalised. The data is updated once a day. \r
\r
More detailed information about the various interfaces can be found in the [Swagger documentation](https://helsinki-openapi.nuuka.cloud/swagger). The data is returned in JSON format. \r
\r
There are deficiencies in the database data. Gaps in the time series can occur at all levels and over the entire covered period. The accuracy of data validation depends on the energy type and the source of the data, which in turn depends on the time and destination. In principle, the more recent the data is, the more exact it is. The most recent data is also monitored and corrected when errors occur. \r
\r
**Example searches:** \r
\r
1. List all properties: https://helsinki-openapi.nuuka.cloud/api/v1.0/Property/List?Customer=Helsinki\r
2. Search daily energy consumption (ReportingGroup=Electricity) for the property Hakaniemi Market Hall (PropertyName=1000 Hakaniemen Kauppahalli) for 2019:  https://helsinki-openapi.nuuka.cloud/api/v1.0/EnergyData/Daily/ListByProperty?Customer=Helsinki&Record=LocationName&SearchString=1000%20Hakaniemen%20kauppahalli&ReportingGroup=Electricity&StartTime=2019-01-01&EndTime=2019-12-31\r
\r
""" ;
    dct:identifier "c6637fbd-2bcf-4ef1-a1fb-f333d235a072" ;
    dct:issued "2020-04-16"^^xsd:date ;
    dct:publisher <https://www.avoindata.fi/data/sv/organization/a66b14c4-131b-4b98-a208-b41de4bb15de> ;
    dct:spatial [ a dct:Location ;
            dct:identifier "helsinki" ] ;
    dct:title "Energy consumption data of city of Helsinki’s utility and service properties",
        "Helsingin kaupungin palvelukiinteistöjen energiankulutustietoja" ;
    ns1:dateModified "2023-06-19T06:59:20.644617"^^xsd:dateTime,
        "2023-06-19T06:59:20.644617" ;
    ns1:datePublished "2020-04-16T00:00:00"^^xsd:dateTime,
        "2020-04-16T00:00:00.000000" ;
    ns1:description """Helsingin kaupungin palvelukiinteistöjen energiankulutustietoja tarjoava Nuuka open API on kanava, jonka kautta käyttäjä pystyy hakemaan tietoja Helsingin kaupungin omistamista kiinteistöistä ja niiden energiankulutuksesta. Rajapinta on täysin avoin, eikä vaadi tunnistautumista.\r
\r
Rajapinnat jakautuvat kiinteistöjen tietojen hakuun ja energiadatan hakuun. Hakuja pystyy tekemään kohteen nimen, kohteen käyttötarkoituksen ja kohteen kiinteistönumeron perusteella.\r
\r
Kiinteistöt pystyy listaamaan ja niistä pystyy hakemaan tarkempaa tietoa. Huomioitavaa on ero kiinteistöjen ja rakennusten välillä: yksi kiinteistö voi sisältää useita rakennuksia, esimerkiksi koulun ja päiväkodin. Kiinteistön tietoja hakiessa palautetaan myös kiinteistön sisältämien rakennusten tiedot. Koordinaateissa käytetty koordinaattijärjestelmä on WGS84 Web Mercator (EPSG:3857).\r
\r
Energiadataa voi hakea kuukausi-, päivä- ja tuntitasolla. Datan saatavuus ja tarkkuus vaihtelee kohteittain. Kaikkein vanhin data on vuositasolla, alkaen n.1980. Tarkin, tuntikohtainen data on pääsääntöisesti saatavilla alkaen 2015. Mahdollisia raportointiryhmiä on neljä: sähkö, lämmitys, vesi ja jäähdytys. Kaikki energiadata näytetään kiinteistön päämittaritasolla. Kuukausikohtaisen datan pystyy hakemaan myös normalisoituna. Data päivittyy kerran vuorokaudessa.\r
\r
Tarkemmat tiedot eri rajapinnoista löytyvät [Swagger-dokumentaatiosta](https://helsinki-openapi.nuuka.cloud/swagger). Tiedot palautetaan JSON-formaatissa.\r
\r
Kannan tiedoissa esiintyy puutteita. Aukkoja aikasarjoissa voi esiintyä kaikilla tasoilla ja koko katetulla aikavälillä. Datan validoinnin tarkkuus riippuu energiatyypistä ja datan lähteestä, joka puolestaan riippuu ajankohdasta ja kohteesta. Lähtökohtaisesti data on sitä eksaktimpaa mitä uudempaa se on. Kaikkein uusinta dataa myös monitoroidaan ja korjataan virheiden ilmetessä\r
\r
**Esimerkkihakuja**\r
\r
1. Listaa kaikki kiinteistöt: https://helsinki-openapi.nuuka.cloud/api/v1.0/Property/List?Customer=Helsinki\r
2. Hae päivittäinen energiankulutus (ReportingGroup=Electricity) kiinteistölle Hakaniemen kauppahalli (PropertyName=1000 Hakaniemen Kauppahalli) vuodelle 2019:  https://helsinki-openapi.nuuka.cloud/api/v1.0/EnergyData/Daily/ListByProperty?Customer=Helsinki&Record=LocationName&SearchString=1000%20Hakaniemen%20kauppahalli&ReportingGroup=Electricity&StartTime=2019-01-01&EndTime=2019-12-31""" ;
    ns1:license "http://creativecommons.org/licenses/by/4.0/" ;
    ns1:name "Helsingin kaupungin palvelukiinteistöjen energiankulutustietoja" ;
    ns1:url "/data/sv/dataset/helsingin-kaupungin-palvelukiinteistojen-energiankulutustietoja" ;
    dcat:contactPoint [ a vcard:Organization ;
            vcard:fn "Helsingin kaupunkiympäristön toimiala / Rakennetun omaisuuden hallinta" ;
            vcard:hasEmail <mailto:%5B%27kymp.nuuka@hel.fi%27%5D> ] ;
    dcat:distribution [ a dcat:Distribution ;
            dct:conformsTo [ a dct:Standard ;
                    dct:identifier "WGS84 Web Mercator (EPSG:3857)" ] ;
            dct:description "" ;
            dct:format [ a dct:MediaTypeOrExtent ;
                    rdf:value "JSON" ] ;
            dct:license <http://creativecommons.org/licenses/by/4.0/> ;
            dct:title "Rajapinnan swagger-dokumentaatio",
                "Swagger documentation",
                "Swagger dokumentation" ;
            dcat:accessURL <https://www.avoindata.fi/data/dataset/c6637fbd-2bcf-4ef1-a1fb-f333d235a072/resource/07e91c2d-7f17-4b8c-8dfe-2c6398237119> ;
            dcat:downloadURL <https://helsinki-openapi.nuuka.cloud/swagger> ;
            dcat:temporalResolution "month, tunti, vuorokausi, månad, kuukausi, timme, hour, day, dag"^^xsd:duration ] ;
    dcat:keyword "energia",
        "energiankulutus",
        "energy",
        "energy consumption",
        "kiinteistöt" ;
    dcat:landingPage <https://helsinki-openapi.nuuka.cloud/swagger> ;
    dcat:theme <https://www.avoindata.fi/data/sv/group/36d446ce-37f1-4c29-bbfc-1a6fc1a2c95c>,
        <https://www.avoindata.fi/data/sv/group/b859f7bd-397f-4030-a51a-cf1426143a4b>,
        <https://www.avoindata.fi/data/sv/group/c5152ebf-5fff-4876-af52-b719ef845310> .

<http://creativecommons.org/licenses/by/4.0/> a dct:LicenseDocument .

<https://www.avoindata.fi/data/sv/group/36d446ce-37f1-4c29-bbfc-1a6fc1a2c95c> a skos:Concept ;
    skos:prefLabel "Bebyggd miljö & infrastruktur",
        "Built-up areas & Infrastructure",
        "Rakennettu ympäristö ja infrastruktuuri" .

<https://www.avoindata.fi/data/sv/group/b859f7bd-397f-4030-a51a-cf1426143a4b> a skos:Concept ;
    skos:prefLabel "Energi",
        "Energia",
        "Energy" .

<https://www.avoindata.fi/data/sv/group/c5152ebf-5fff-4876-af52-b719ef845310> a skos:Concept ;
    skos:prefLabel "Environment",
        "Miljö",
        "Ympäristö" .

<https://www.avoindata.fi/data/sv/organization/a66b14c4-131b-4b98-a208-b41de4bb15de> a foaf:Agent ;
    foaf:name "Helsingin kaupunkiympäristön toimiala" .

<https://helsinki-openapi.nuuka.cloud/swagger> a foaf:Document .

