Changes

              
    

          
          
        
        

            
f
1
{
f
1
{
            
2
  "author": "",
2
  "author": "",
            
3
  "author_email": "",
3
  "author_email": "",
            
4
  "creator_user_id": "c028eea2-1878-47b8-843b-aa298066c249",
4
  "creator_user_id": "c028eea2-1878-47b8-843b-aa298066c249",
            
5
  "data_owner": "Tampere",
5
  "data_owner": "Tampere",
            
6
  "groups": [
6
  "groups": [
            
7
    {
7
    {
            
8
      "description": "This group collects together data related to the 
8
      "description": "This group collects together data related to the 
            
9
city of Tampere.",
9
city of Tampere.",
            
10
      "display_name": "Tampere",
10
      "display_name": "Tampere",
            
11
      "id": "07adac22-b527-4417-82b9-41c7c24e6f4c",
11
      "id": "07adac22-b527-4417-82b9-41c7c24e6f4c",
            
12
      "image_display_url": "",
12
      "image_display_url": "",
            
13
      "name": "tampere",
13
      "name": "tampere",
            
14
      "title": "Tampere"
14
      "title": "Tampere"
            
15
    }
15
    }
            
16
  ],
16
  ],
            
17
  "id": "73444995-4438-4443-9402-b11cf84a7060",
17
  "id": "73444995-4438-4443-9402-b11cf84a7060",
            
18
  "isopen": false,
18
  "isopen": false,
            
19
  "license_id": "internal",
19
  "license_id": "internal",
            
20
  "license_title": "For internal research and education use",
20
  "license_title": "For internal research and education use",
            
21
  "maintainer": "Ville Heikkil\u00e4",
21
  "maintainer": "Ville Heikkil\u00e4",
            
22
  "maintainer_email": "ville.heikkila@tuni.fi",
22
  "maintainer_email": "ville.heikkila@tuni.fi",
            
23
  "metadata_created": "2022-10-17T08:24:38.547680",
23
  "metadata_created": "2022-10-17T08:24:38.547680",
            
n
24
  "metadata_modified": "2024-03-20T15:22:30.473368",
n
24
  "metadata_modified": "2024-04-29T05:50:30.518547",
            
25
  "name": "tampere-street-lights",
25
  "name": "tampere-street-lights",
            
26
  "notes": "Data from the street light system of Tampere including 
26
  "notes": "Data from the street light system of Tampere including 
            
27
electricity consumption,\r\nambient illuminance data and door sensor 
27
electricity consumption,\r\nambient illuminance data and door sensor 
            
n
28
data.  There are 3 different control\r\ncabinets and 317 different 
n
28
data. There are 3 different control\r\ncabinets and 317 different 
            
29
street light groups which together manage about 40000\r\nstreetlights. 
29
street light groups which together manage about 40000\r\nstreetlights. 
            
30
Each control cabinet provides illuminance measurements. The 
30
Each control cabinet provides illuminance measurements. The 
            
31
data\r\nalso contains the limit values at which the streetlights are 
31
data\r\nalso contains the limit values at which the streetlights are 
            
32
supposed to turn on\r\n or off. These limits can be different for each 
32
supposed to turn on\r\n or off. These limits can be different for each 
            
n
33
control cabinet. Each street\r\nlight group provides electrical 
n
33
control cabinet. Each street\r\nlight group provides electric current 
            
34
intensity (electrical current) and voltage\r\nmeasurements. The 
34
and voltage\r\nmeasurements. The electrical data is given separately 
            
35
electrical data is given separately for each of the three\r\nphases. 
35
for each of the three\r\nphases. The door sensor data relates to the 
            
36
The door sensor data relates to the street light groups. The data 
36
street light groups. The data also\r\ncontains information on which 
            
37
also\r\ncontains information on which control cabinet controls which 
37
control cabinet controls which street light group\r\n(each street 
            
38
street light group\r\n(each street light group can have either 1 or 2 
38
light group can have either 1 or 2 control cabinets). See 
            
39
control cabinets). See 

            
40
\r\n[CityIoT](https://ckan.energydata.rd.tuni.fi/organization/cityiot) 
39
\r\n[CityIoT](https://ckan.energydata.rd.tuni.fi/organization/cityiot) 
            
41
project for\r\ngeneral information about how the measurements are 
40
project for\r\ngeneral information about how the measurements are 
            
42
stored and can be used.\r\n\r\n## Data model\r\n\r\nThe FIWARE entity 
41
stored and can be used.\r\n\r\n## Data model\r\n\r\nThe FIWARE entity 
            
43
types used in this data set are from 
42
types used in this data set are from 
            
44
amodels.readthedocs.io/en/latest/Weather/doc/introduction.html)\r\nand 
43
amodels.readthedocs.io/en/latest/Weather/doc/introduction.html)\r\nand 
            
45
readthedocs.io/en/latest/StreetLighting/doc/introduction.html)\r\ndata 
44
readthedocs.io/en/latest/StreetLighting/doc/introduction.html)\r\ndata 
            
n
46
models. However some changes had to be  made to the entity attributes 
n
45
models. However, some changes had to be made to the entity attributes 
            
47
to\r\nfit them to the original data. The following entity types are 
46
to\r\nfit them to the original data. The following entity types are 
            
48
used.\r\n\r\n- 
47
used.\r\n\r\n- 
            
49
en/latest/StreetLighting/StreetlightControlCabinet/doc/spec.html):\r\n  
48
en/latest/StreetLighting/StreetlightControlCabinet/doc/spec.html):\r\n  
            
50
Controllers of the street light groups. IlluminanceOn and 
49
Controllers of the street light groups. IlluminanceOn and 
            
51
IlluminanceOff\r\n  attributes were added to this type to represent 
50
IlluminanceOff\r\n  attributes were added to this type to represent 
            
52
the values when the street\r\n  lights should be turned on and 
51
the values when the street\r\n  lights should be turned on and 
            
53
off.\r\n- 
52
off.\r\n- 
            
54
edocs.io/en/latest/StreetLighting/StreetlightGroup/doc/spec.html):\r\n  
53
edocs.io/en/latest/StreetLighting/StreetlightGroup/doc/spec.html):\r\n  
            
n
55
Represents a group of street lights . In this data set contains the 
n
54
Represents a group of street lights. In this data set contains the 
            
56
electrical\r\n  measurements which in the original data model are part 
55
electrical\r\n  measurements which in the original data model are part 
            
57
of the control cabinet.\r\n- 
56
of the control cabinet.\r\n- 
            
58
amodels.readthedocs.io/en/latest/Device/Device/doc/spec.html):\r\nUsed 
57
amodels.readthedocs.io/en/latest/Device/Device/doc/spec.html):\r\nUsed 
            
59
to represent door sensors and illuminance sensors. The illuminance 
58
to represent door sensors and illuminance sensors. The illuminance 
            
60
sensors\r\nare related to control cabinets and the door sensors to 
59
sensors\r\nare related to control cabinets and the door sensors to 
            
61
street light groups. As\r\na change from the standard device data 
60
street light groups. As\r\na change from the standard device data 
            
62
model, The\r\nowner attribute is used to model these 
61
model, The\r\nowner attribute is used to model these 
            
63
relationships.\r\n- 
62
relationships.\r\n- 
            
64
s.readthedocs.io/en/latest/Weather/WeatherObserved/doc/spec.html):\r\n  
63
s.readthedocs.io/en/latest/Weather/WeatherObserved/doc/spec.html):\r\n  
            
65
Is used to model the illuminance measurements from the control 
64
Is used to model the illuminance measurements from the control 
            
66
cabinets.\r\n\r\n## Notes about the data\r\n\r\n- The data was 
65
cabinets.\r\n\r\n## Notes about the data\r\n\r\n- The data was 
            
67
originally stored in a different database system with its own\r\n  
66
originally stored in a different database system with its own\r\n  
            
n
68
data model. From there it was then transfered and converted to the 
n
67
data model. From there, it was then transferred and converted to the 
            
69
CityIoT platform.\r\n- In the original data, locations were given only 
68
CityIoT platform.\r\n- In the original data, locations were given only 
            
n
70
as street addresses. For this\r\ndata set, the free service  
n
69
as street addresses. For this\r\ndata set, the free service 
            
71
https://nominatim.openstreetmap.org/ was used to\r\nget the 
70
https://nominatim.openstreetmap.org/ was used to\r\nget the 
            
72
corresponding latitude and longitude coordinates.\r\n- The illuminance 
71
corresponding latitude and longitude coordinates.\r\n- The illuminance 
            
73
data contained only measurement values close to the point when\r\n  
72
data contained only measurement values close to the point when\r\n  
            
74
the streetlights were supposed to turn on or off. This means that 
73
the streetlights were supposed to turn on or off. This means that 
            
75
there is no\r\n  measurements from midday or midnight. This was 
74
there is no\r\n  measurements from midday or midnight. This was 
            
76
intentional by the data\r\n  provider, since the data was originally 
75
intentional by the data\r\n  provider, since the data was originally 
            
77
meant to test whether the streetlight\r\n  control system worked 
76
meant to test whether the streetlight\r\n  control system worked 
            
78
properly.\r\n- Time resolution for illuminance measurements is about 4 
77
properly.\r\n- Time resolution for illuminance measurements is about 4 
            
n
79
minutes.  For the\r\n  electrical intensity it is 2 or 3 hours though 
n
78
minutes.  For the\r\n  electrical intensity it is 2 or 3 hours, though 
            
80
there can be cases where\r\n  measurements for one phase are reported 
79
there can be cases where\r\n  measurements for one phase are reported 
            
81
first then few minutes after there are\r\n  measurements for the other 
80
first then few minutes after there are\r\n  measurements for the other 
            
n
82
phases for example. Voltage is reported only couple\r\n  times a 
n
81
phases, for example. Voltage is reported only couple\r\n  times a 
            
83
day.\r\n- UTC time is used with the timestamps.\r\n\r\n## Accessing 
82
day.\r\n- UTC time is used with the timestamps.\r\n\r\n## Accessing 
            
84
the data\r\n\r\nThe data is stored in the Tampere University CityIoT 
83
the data\r\n\r\nThe data is stored in the Tampere University CityIoT 
            
n
85
platform. The used FIWARR\r\nservice is streetlight and all entities 
n
84
platform. The used FIWARE\r\nservice is streetlight and all entities 
            
86
there are under the service path\r\n/Tampere.\r\n\r\n### 
85
there are under the service path\r\n/Tampere.\r\n\r\n### 
            
87
Examples\r\n\r\nfind out the streetlight group entity ids which has 
86
Examples\r\n\r\nfind out the streetlight group entity ids which has 
            
88
KV-0446 as a controller cabinet:\r\n\r\n    curl -X GET 
87
KV-0446 as a controller cabinet:\r\n\r\n    curl -X GET 
            
89
StreetlightGroup&q=refStreetlightCabinetController~=KV-0446&attrs=id\" 
88
StreetlightGroup&q=refStreetlightCabinetController~=KV-0446&attrs=id\" 
            
90
--header \"Fiware-Service: streetlight\" --header 
89
--header \"Fiware-Service: streetlight\" --header 
            
91
\"Fiware-Servicepath: /Tampere\" --header \"apikey: 
90
\"Fiware-Servicepath: /Tampere\" --header \"apikey: 
            
92
your_apikey\"\r\n\r\nFind out which streetlight groups have all phases 
91
your_apikey\"\r\n\r\nFind out which streetlight groups have all phases 
            
93
for intensity and voltage set with all values for intensity being 
92
for intensity and voltage set with all values for intensity being 
            
94
above 10 A:\r\n\r\n    curl -X GET 
93
above 10 A:\r\n\r\n    curl -X GET 
            
95
e.L1!=null;voltage.L2!=null;voltage.L3!=null&attrs=intensity,voltage\" 
94
e.L1!=null;voltage.L2!=null;voltage.L3!=null&attrs=intensity,voltage\" 
            
96
--header \"Fiware-Service: streetlight\" --header 
95
--header \"Fiware-Service: streetlight\" --header 
            
97
\"Fiware-Servicepath: /Tampere\" --header \"apikey: 
96
\"Fiware-Servicepath: /Tampere\" --header \"apikey: 
            
98
your_apikey\"\r\n\r\nGet daily maximum illuminance values for street 
97
your_apikey\"\r\n\r\nGet daily maximum illuminance values for street 
            
99
light control cabinet KV-0217 between 4 January 2019 and 7 January 
98
light control cabinet KV-0217 between 4 January 2019 and 7 January 
            
100
2019:\r\n\r\n    curl -X GET 
99
2019:\r\n\r\n    curl -X GET 
            
101
T00:00:00Z&toDate=2019-01-07T23:59:59Z&aggrMethod=max&aggrPeriod=day\" 
100
T00:00:00Z&toDate=2019-01-07T23:59:59Z&aggrMethod=max&aggrPeriod=day\" 
            
102
--header \"Fiware-Service: streetlight\" --header 
101
--header \"Fiware-Service: streetlight\" --header 
            
103
\"Fiware-Servicepath: /Tampere\" --header \"apikey: 
102
\"Fiware-Servicepath: /Tampere\" --header \"apikey: 
            
104
your_apikey\"\r\n",
103
your_apikey\"\r\n",
            
105
  "num_resources": 5,
104
  "num_resources": 5,
            
106
  "num_tags": 3,
105
  "num_tags": 3,
            
107
  "organization": {
106
  "organization": {
            
108
    "approval_status": "approved",
107
    "approval_status": "approved",
            
109
    "created": "2022-10-17T09:15:18.177419",
108
    "created": "2022-10-17T09:15:18.177419",
            
110
    "description": "The [CityIoT project](https://www.cityiot.fi/) 
109
    "description": "The [CityIoT project](https://www.cityiot.fi/) 
            
111
collected smart city related data\r\nin Tampere about street lights, 
110
collected smart city related data\r\nin Tampere about street lights, 
            
112
electric buses and bus passenger analytics. This\r\ndata is stored in 
111
electric buses and bus passenger analytics. This\r\ndata is stored in 
            
113
a [FIWARE](https://www.fiware.org/) based platform. FIWARE is\r\na 
112
a [FIWARE](https://www.fiware.org/) based platform. FIWARE is\r\na 
            
114
collection of standards and components for creating smart solutions. 
113
collection of standards and components for creating smart solutions. 
            
115
The\r\nplatform is available at the URL 
114
The\r\nplatform is available at the URL 
            
n
116
https://tlt-cityiot.rd.tuni.fi/. The data is\r\navailable via the HTTP 
n
115
https://tlt-cityiot.rd.tuni.fi/. The data is\r\navailable via the 
            
117
based APIs offered by the platform. To access any of the\r\ndata sets 
116
HTTP-based APIs offered by the platform. To access any of the\r\ndata 
            
118
an API key is required. If you are interested in using any of 
117
sets an API key is required. If you are interested in using any of 
            
119
the\r\nCityIoT data sets, contact the person marked as the maintainer 
118
the\r\nCityIoT data sets, contact the person marked as the maintainer 
            
120
of the data set. \r\n\r\nIn order to get the data and make use of it 
119
of the data set. \r\n\r\nIn order to get the data and make use of it 
            
121
some understanding is required about\r\nthe following 3 aspects of the 
120
some understanding is required about\r\nthe following 3 aspects of the 
            
122
CityIoT platform:\r\n\r\n1. The [NGSI v2 
121
CityIoT platform:\r\n\r\n1. The [NGSI v2 
            
123
pecification](https://fiware.github.io/specifications/ngsiv2/stable/): 
122
pecification](https://fiware.github.io/specifications/ngsiv2/stable/): 
            
124
defines the API used by the main FIWARE component\r\nthe Orion context 
123
defines the API used by the main FIWARE component\r\nthe Orion context 
            
n
125
broker and also the entity based data model used by all 
n
124
broker and also the entity-based data model used by all 
            
126
FIWARE\r\ncomponents.\r\n2. The [Orion context 
125
FIWARE\r\ncomponents.\r\n2. The [Orion context 
            
127
broker](https://fiware-orion.readthedocs.io/en/master/): Has the most 
126
broker](https://fiware-orion.readthedocs.io/en/master/): Has the most 
            
n
128
recent version of the data i.e. NGSI v2\r\nentities. This data can be 
n
127
recent version of the data, i.e. NGSI v2\r\nentities. This data can be 
            
129
queried or subscribed to so that you get notified\r\nwhen the data 
128
queried or subscribed to so that you get notified\r\nwhen the data 
            
130
changes.\r\n3. 
129
changes.\r\n3. 
            
131
[QuantumLeap](https://quantumleap.readthedocs.io/en/latest/): Stores 
130
[QuantumLeap](https://quantumleap.readthedocs.io/en/latest/): Stores 
            
n
132
NGSI v2 entity data into a timeseries data base. It allows\r\nthen the 
n
131
NGSI v2 entity data into a timeseries database. It allows\r\nthen the 
            
133
querying of this historic data via an HTTP API.\r\n\r\nSo in short, 
132
querying of this historic data via an HTTP API.\r\n\r\nSo in short, 
            
134
understand the NGSI v2 data model so you know what kind of 
133
understand the NGSI v2 data model so you know what kind of 
            
135
data\r\nstructures you are dealing with. Use Orion if you want a 
134
data\r\nstructures you are dealing with. Use Orion if you want a 
            
136
programmatic way to\r\nlist all available data entities, query their 
135
programmatic way to\r\nlist all available data entities, query their 
            
137
current state or subscribe to\r\nchanges in their state. Use 
136
current state or subscribe to\r\nchanges in their state. Use 
            
138
QuantumLeap if you want to explore how the entities\r\nhave changed 
137
QuantumLeap if you want to explore how the entities\r\nhave changed 
            
n
139
over time.\r\n\r\n## The data model\r\n\r\nIn FIWARe NGSI v2 data is 
n
138
over time.\r\n\r\n## The data model\r\n\r\nIn FIWARE NGSI v2 data is 
            
140
modelled as context entities. Entities can represent\r\nlogical of 
139
modelled as context entities. Entities can represent\r\nlogical of 
            
141
physical things such as a sensor, a person or a weather 
140
physical things such as a sensor, a person or a weather 
            
n
142
observation.\r\nEntities have a id and a type indicating what the 
n
141
observation.\r\nEntities have an id and a type indicating what the 
            
143
entity represents. Entities\r\nthen can have various attributes 
142
entity represents. Entities\r\nthen can have various attributes 
            
144
providing information about them. The entity\r\ntype determines what 
143
providing information about them. The entity\r\ntype determines what 
            
145
attributes an entity should have. This way domain specific\r\ndata 
144
attributes an entity should have. This way domain specific\r\ndata 
            
146
models can be created by defining the needed entity types and 
145
models can be created by defining the needed entity types and 
            
n
147
their\r\nattributes. For example weather observation could have 
n
146
their\r\nattributes. For example, weather observation could have 
            
148
attributes for\r\ntemperature, humidity and the location for the 
147
attributes for\r\ntemperature, humidity and the location for the 
            
n
149
observation. An attribute has a\r\nname and  a value including data 
n
148
observation. An attribute has a\r\nname and a value including data 
            
150
type for the value. An attribute can also have\r\nmetadata such as 
149
type for the value. An attribute can also have\r\nmetadata such as 
            
151
timestamp for when the value was acquired or what is 
150
timestamp for when the value was acquired or what is 
            
152
the\r\nmeasurement accuracy for the value. The documentation for each 
151
the\r\nmeasurement accuracy for the value. The documentation for each 
            
153
CityIoT data set\r\nexplains what entity types the data consists of 
152
CityIoT data set\r\nexplains what entity types the data consists of 
            
154
and what attributes the entities have.\r\n\r\nThe entities are 
153
and what attributes the entities have.\r\n\r\nThe entities are 
            
n
155
represented as JSON. For example an entity representing an\r\nelectric 
n
154
represented as JSON. For example, an entity representing 
            
156
bus from one of the CityIoT data sets looks like this with only part 
155
an\r\nelectric bus from one of the CityIoT data sets looks like this 
            
157
of\r\nthe attributes included:\r\n\r\n    {\r\n        \"id\": 
156
with only part of\r\nthe attributes included:\r\n\r\n    {\r\n        
            
158
\"Vehicle:TKL16\",\r\n        \"type\": \"Vehicle\",\r\n        
157
\"id\": \"Vehicle:TKL16\",\r\n        \"type\": \"Vehicle\",\r\n        
            
159
\"vehicleType\": {\r\n            \"value\": \"bus\"\r\n        },\r\n        
158
\"vehicleType\": {\r\n            \"value\": \"bus\"\r\n        },\r\n        
            
160
\"name\": {\r\n            \"value\": \"TKL16\"\r\n        },\r\n        
159
\"name\": {\r\n            \"value\": \"TKL16\"\r\n        },\r\n        
            
161
\"location\": {\r\n            \"type\": \"geo:json\",\r\n            
160
\"location\": {\r\n            \"type\": \"geo:json\",\r\n            
            
162
\"value\": {\r\n                \"type\": \"Point\",\r\n                
161
\"value\": {\r\n                \"type\": \"Point\",\r\n                
            
163
\"coordinates\": [23.769203333333333, 61.49531666666667]\r\n            
162
\"coordinates\": [23.769203333333333, 61.49531666666667]\r\n            
            
164
},\r\n            \"metadata\": {\r\n                \"timestamp\": 
163
},\r\n            \"metadata\": {\r\n                \"timestamp\": 
            
165
{\r\n                    \"type\": \"DateTime\",\r\n                    
164
{\r\n                    \"type\": \"DateTime\",\r\n                    
            
166
\"value\": \"2019-04-03T14:52:18.192881Z\"\r\n                }\r\n            
165
\"value\": \"2019-04-03T14:52:18.192881Z\"\r\n                }\r\n            
            
167
}\r\n        },\r\n        \"speed\": {\r\n            \"value\": 
166
}\r\n        },\r\n        \"speed\": {\r\n            \"value\": 
            
168
34.5,\r\n            \"metadata\": {\r\n                \"timestamp\": 
167
34.5,\r\n            \"metadata\": {\r\n                \"timestamp\": 
            
169
{\r\n                    \"type\": \"DateTime\",\r\n                    
168
{\r\n                    \"type\": \"DateTime\",\r\n                    
            
170
\"value\": \"2019-04-03T14:52:19.867419Z\"\r\n                }\r\n            
169
\"value\": \"2019-04-03T14:52:19.867419Z\"\r\n                }\r\n            
            
171
}\r\n        },        \r\n        \"power\": {\r\n            
170
}\r\n        },        \r\n        \"power\": {\r\n            
            
172
\"value\": 75.70000000000027,\r\n            \"metadata\": {\r\n                
171
\"value\": 75.70000000000027,\r\n            \"metadata\": {\r\n                
            
173
\"timestamp\": {\r\n                    \"type\": \"DateTime\",\r\n                    
172
\"timestamp\": {\r\n                    \"type\": \"DateTime\",\r\n                    
            
174
\"value\": \"2019-04-03T14:52:20.218114Z\"\r\n                }\r\n            
173
\"value\": \"2019-04-03T14:52:20.218114Z\"\r\n                }\r\n            
            
175
}\r\n        },\r\n        \"chargeState\": {\r\n            
174
}\r\n        },\r\n        \"chargeState\": {\r\n            
            
176
\"value\": 87,\r\n            \"metadata\": {\r\n                
175
\"value\": 87,\r\n            \"metadata\": {\r\n                
            
177
\"timestamp\": {\r\n                    \"type\": \"DateTime\",\r\n                    
176
\"timestamp\": {\r\n                    \"type\": \"DateTime\",\r\n                    
            
178
\"value\": \"2019-04-03T14:52:16.938936Z\"\r\n                }\r\n            
177
\"value\": \"2019-04-03T14:52:16.938936Z\"\r\n                }\r\n            
            
179
}\r\n        }\r\n    }\r\n\r\n\r\n## The Orion context 
178
}\r\n        }\r\n    }\r\n\r\n\r\n## The Orion context 
            
180
broker\r\n\r\nThe Orion context broker stores the latest versions of 
179
broker\r\n\r\nThe Orion context broker stores the latest versions of 
            
181
all entities. Its API is\r\nused to query information about the 
180
all entities. Its API is\r\nused to query information about the 
            
182
entities or subscribe to changes in their\r\nattributes. The Tampere 
181
entities or subscribe to changes in their\r\nattributes. The Tampere 
            
183
CityIoT Orion API is available at the 
182
CityIoT Orion API is available at the 
            
184
URL\r\nhttps://tlt-cityiot.rd.tuni.fi/orion/\r\n\r\nTo separate the 
183
URL\r\nhttps://tlt-cityiot.rd.tuni.fi/orion/\r\n\r\nTo separate the 
            
185
entities of the different data sets, Orions multi tenancy\r\nfeature 
184
entities of the different data sets, Orions multi tenancy\r\nfeature 
            
186
is used. Data is separated into different services and under a 
185
is used. Data is separated into different services and under a 
            
n
187
service\r\nhierarchical service paths can be  used for more 
n
186
service\r\nhierarchical service paths can be used for more 
            
188
fine-grained data organization.\r\nIn API calls the service and 
187
fine-grained data organization.\r\nIn API calls the service and 
            
189
service path are given in HTTP headers:\r\n`Fiware-Service` for the 
188
service path are given in HTTP headers:\r\n`Fiware-Service` for the 
            
190
service and `Fiware-ServicePath` for the service path. For\r\naccess 
189
service and `Fiware-ServicePath` for the service path. For\r\naccess 
            
n
191
control API keys are used. The API key  is given in the `apikey` HTTP 
n
190
control API keys are used. The API key is given in the `apikey` HTTP 
            
192
header.\r\nDocumentation for each data set tells what service is used 
191
header.\r\nDocumentation for each data set tells what service is used 
            
193
and how service paths\r\nare used. You can get an API key by 
192
and how service paths\r\nare used. You can get an API key by 
            
194
requesting access to a data set from the\r\nmaintainer of the data 
193
requesting access to a data set from the\r\nmaintainer of the data 
            
n
195
set. As an example how all this works in practice, the\r\n[Tampere 
n
194
set. As an example, how all this works in practice, the\r\n[Tampere 
            
196
electric 
195
electric 
            
197
ckan.energydata.rd.tuni.fi/dataset/tampere-electric-bus-pilot)\r\ndata 
196
ckan.energydata.rd.tuni.fi/dataset/tampere-electric-bus-pilot)\r\ndata 
            
198
set has entities representing electric buses in service 
197
set has entities representing electric buses in service 
            
199
public_transport\r\nunder the service path /Tampere/electric_bus. 
198
public_transport\r\nunder the service path /Tampere/electric_bus. 
            
200
Using the command line HTTP client\r\ncurl, this is how to get all the 
199
Using the command line HTTP client\r\ncurl, this is how to get all the 
            
201
electric bus entities and their attributes from\r\nOrion:\r\n\r\n    
200
electric bus entities and their attributes from\r\nOrion:\r\n\r\n    
            
202
curl -H 'Fiware-Service: public_transport' -H 'Fiware-ServicePath: 
201
curl -H 'Fiware-Service: public_transport' -H 'Fiware-ServicePath: 
            
203
/Tampere/electric_bus' -H 'apikey: your_apikey' 
202
/Tampere/electric_bus' -H 'apikey: your_apikey' 
            
204
\"https://tlt-cityiot.rd.tuni.fi/orion/v2/entities\"\r\n\r\n## 
203
\"https://tlt-cityiot.rd.tuni.fi/orion/v2/entities\"\r\n\r\n## 
            
205
QuantumLeap\r\n\r\nQuantumLeap stores the change history of the 
204
QuantumLeap\r\n\r\nQuantumLeap stores the change history of the 
            
206
entities in a timeseries database.\r\nThis can then be queried via its 
205
entities in a timeseries database.\r\nThis can then be queried via its 
            
207
API. The Tampere CityIoT QuantumLeap is\r\navailable at the URL: 
206
API. The Tampere CityIoT QuantumLeap is\r\navailable at the URL: 
            
208
https://tlt-cityiot.rd.tuni.fi/quantumleap/\r\n\r\nIt uses the same 
207
https://tlt-cityiot.rd.tuni.fi/quantumleap/\r\n\r\nIt uses the same 
            
209
service and service path\r\nsystem to organize entities as Orion. The 
208
service and service path\r\nsystem to organize entities as Orion. The 
            
t
210
same API key based authentication\r\nsystem is also used. See the 
t
209
same API key-based authentication\r\nsystem is also used. See the 
            
211
Orion section for more details. For example to Get\r\nall values for 
210
Orion section for more details. For example to Get\r\nall values for 
            
212
power and speed for electric bus entity TKL15 between 14:01 and 14:02 
211
power and speed for electric bus entity TKL15 between 14:01 and 14:02 
            
213
on\r\n28th of October 2019 with curl the following command would be 
212
on\r\n28th of October 2019 with curl the following command would be 
            
214
used:\r\n\r\n    curl -H 'Fiware-Service: public_transport' -H 
213
used:\r\n\r\n    curl -H 'Fiware-Service: public_transport' -H 
            
215
'Fiware-ServicePath: /Tampere/electric_bus' -H 'apikey: your_apikey' 
214
'Fiware-ServicePath: /Tampere/electric_bus' -H 'apikey: your_apikey' 
            
216
ed,power&&fromDate=2019-10-28T12:01:00&&toDate=2019-10-28T12:02:00\"",
215
ed,power&&fromDate=2019-10-28T12:01:00&&toDate=2019-10-28T12:02:00\"",
            
217
    "id": "ede7b870-2dff-4a89-889e-1bb3980ffa6f",
216
    "id": "ede7b870-2dff-4a89-889e-1bb3980ffa6f",
            
218
    "image_url": "",
217
    "image_url": "",
            
219
    "is_organization": true,
218
    "is_organization": true,
            
220
    "name": "cityiot",
219
    "name": "cityiot",
            
221
    "state": "active",
220
    "state": "active",
            
222
    "title": "CityIoT",
221
    "title": "CityIoT",
            
223
    "type": "organization"
222
    "type": "organization"
            
224
  },
223
  },
            
225
  "owner_org": "ede7b870-2dff-4a89-889e-1bb3980ffa6f",
224
  "owner_org": "ede7b870-2dff-4a89-889e-1bb3980ffa6f",
            
226
  "private": false,
225
  "private": false,
            
227
  "relationships_as_object": [],
226
  "relationships_as_object": [],
            
228
  "relationships_as_subject": [],
227
  "relationships_as_subject": [],
            
229
  "resources": [
228
  "resources": [
            
230
    {
229
    {
            
231
      "cache_last_updated": null,
230
      "cache_last_updated": null,
            
232
      "cache_url": null,
231
      "cache_url": null,
            
233
      "created": "2024-03-08T12:00:33.475035",
232
      "created": "2024-03-08T12:00:33.475035",
            
234
      "datastore_active": false,
233
      "datastore_active": false,
            
235
      "description": "An example of a Device entity representing a 
234
      "description": "An example of a Device entity representing a 
            
236
door sensor.",
235
door sensor.",
            
237
      "format": "JSON",
236
      "format": "JSON",
            
238
      "hash": "",
237
      "hash": "",
            
239
      "id": "49f4a884-2c69-4783-8ade-cc74551900de",
238
      "id": "49f4a884-2c69-4783-8ade-cc74551900de",
            
240
      "last_modified": "2024-03-08T12:00:33.444331",
239
      "last_modified": "2024-03-08T12:00:33.444331",
            
241
      "metadata_modified": "2024-03-08T12:03:53.044792",
240
      "metadata_modified": "2024-03-08T12:03:53.044792",
            
242
      "mimetype": "application/json",
241
      "mimetype": "application/json",
            
243
      "mimetype_inner": null,
242
      "mimetype_inner": null,
            
244
      "name": "Door sensor Device entity example",
243
      "name": "Door sensor Device entity example",
            
245
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
244
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
            
246
      "position": 0,
245
      "position": 0,
            
247
      "resource_type": null,
246
      "resource_type": null,
            
248
      "size": 720,
247
      "size": 720,
            
249
      "state": "active",
248
      "state": "active",
            
250
      "url": 
249
      "url": 
            
251
49f4a884-2c69-4783-8ade-cc74551900de/download/device-doorsensor.json",
250
49f4a884-2c69-4783-8ade-cc74551900de/download/device-doorsensor.json",
            
252
      "url_type": "upload"
251
      "url_type": "upload"
            
253
    },
252
    },
            
254
    {
253
    {
            
255
      "cache_last_updated": null,
254
      "cache_last_updated": null,
            
256
      "cache_url": null,
255
      "cache_url": null,
            
257
      "created": "2024-03-08T12:03:53.058908",
256
      "created": "2024-03-08T12:03:53.058908",
            
258
      "datastore_active": false,
257
      "datastore_active": false,
            
259
      "description": "An example Device entity representing an 
258
      "description": "An example Device entity representing an 
            
260
illuminance sensor.",
259
illuminance sensor.",
            
261
      "format": "JSON",
260
      "format": "JSON",
            
262
      "hash": "",
261
      "hash": "",
            
263
      "id": "a2eda52b-9bae-475c-93b8-aa4a468c9d5a",
262
      "id": "a2eda52b-9bae-475c-93b8-aa4a468c9d5a",
            
264
      "last_modified": "2024-03-08T12:03:53.030260",
263
      "last_modified": "2024-03-08T12:03:53.030260",
            
265
      "metadata_modified": "2024-03-08T12:04:59.540041",
264
      "metadata_modified": "2024-03-08T12:04:59.540041",
            
266
      "mimetype": "application/json",
265
      "mimetype": "application/json",
            
267
      "mimetype_inner": null,
266
      "mimetype_inner": null,
            
268
      "name": "Illuminance sensor Device entity example",
267
      "name": "Illuminance sensor Device entity example",
            
269
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
268
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
            
270
      "position": 1,
269
      "position": 1,
            
271
      "resource_type": null,
270
      "resource_type": null,
            
272
      "size": 486,
271
      "size": 486,
            
273
      "state": "active",
272
      "state": "active",
            
274
      "url": 
273
      "url": 
            
275
b-9bae-475c-93b8-aa4a468c9d5a/download/device-illuminancesensor.json",
274
b-9bae-475c-93b8-aa4a468c9d5a/download/device-illuminancesensor.json",
            
276
      "url_type": "upload"
275
      "url_type": "upload"
            
277
    },
276
    },
            
278
    {
277
    {
            
279
      "cache_last_updated": null,
278
      "cache_last_updated": null,
            
280
      "cache_url": null,
279
      "cache_url": null,
            
281
      "created": "2024-03-08T12:04:59.560719",
280
      "created": "2024-03-08T12:04:59.560719",
            
282
      "datastore_active": false,
281
      "datastore_active": false,
            
283
      "description": "An example of a StreetlightControlCabined 
282
      "description": "An example of a StreetlightControlCabined 
            
284
entity.",
283
entity.",
            
285
      "format": "JSON",
284
      "format": "JSON",
            
286
      "hash": "",
285
      "hash": "",
            
287
      "id": "238801fb-2aa8-48cb-ae56-c530ca8995c2",
286
      "id": "238801fb-2aa8-48cb-ae56-c530ca8995c2",
            
288
      "last_modified": "2024-03-08T12:04:59.519859",
287
      "last_modified": "2024-03-08T12:04:59.519859",
            
289
      "metadata_modified": "2024-03-08T12:06:05.096888",
288
      "metadata_modified": "2024-03-08T12:06:05.096888",
            
290
      "mimetype": "application/json",
289
      "mimetype": "application/json",
            
291
      "mimetype_inner": null,
290
      "mimetype_inner": null,
            
292
      "name": "Example StreetlightControlCabined entity",
291
      "name": "Example StreetlightControlCabined entity",
            
293
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
292
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
            
294
      "position": 2,
293
      "position": 2,
            
295
      "resource_type": null,
294
      "resource_type": null,
            
296
      "size": 3858,
295
      "size": 3858,
            
297
      "state": "active",
296
      "state": "active",
            
298
      "url": 
297
      "url": 
            
299
-2aa8-48cb-ae56-c530ca8995c2/download/streetlightcontrolcabinet.json",
298
-2aa8-48cb-ae56-c530ca8995c2/download/streetlightcontrolcabinet.json",
            
300
      "url_type": "upload"
299
      "url_type": "upload"
            
301
    },
300
    },
            
302
    {
301
    {
            
303
      "cache_last_updated": null,
302
      "cache_last_updated": null,
            
304
      "cache_url": null,
303
      "cache_url": null,
            
305
      "created": "2024-03-08T12:06:05.109994",
304
      "created": "2024-03-08T12:06:05.109994",
            
306
      "datastore_active": false,
305
      "datastore_active": false,
            
307
      "description": "An example of a StreetlightGroup entity.",
306
      "description": "An example of a StreetlightGroup entity.",
            
308
      "format": "JSON",
307
      "format": "JSON",
            
309
      "hash": "",
308
      "hash": "",
            
310
      "id": "7bdb6db2-646b-4d33-91cf-5f2d0caf835d",
309
      "id": "7bdb6db2-646b-4d33-91cf-5f2d0caf835d",
            
311
      "last_modified": "2024-03-08T12:06:05.083472",
310
      "last_modified": "2024-03-08T12:06:05.083472",
            
312
      "metadata_modified": "2024-03-08T12:07:19.849920",
311
      "metadata_modified": "2024-03-08T12:07:19.849920",
            
313
      "mimetype": "application/json",
312
      "mimetype": "application/json",
            
314
      "mimetype_inner": null,
313
      "mimetype_inner": null,
            
315
      "name": "Example StreetlightGroup entity",
314
      "name": "Example StreetlightGroup entity",
            
316
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
315
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
            
317
      "position": 3,
316
      "position": 3,
            
318
      "resource_type": null,
317
      "resource_type": null,
            
319
      "size": 1696,
318
      "size": 1696,
            
320
      "state": "active",
319
      "state": "active",
            
321
      "url": 
320
      "url": 
            
322
/7bdb6db2-646b-4d33-91cf-5f2d0caf835d/download/streetlightgroup.json",
321
/7bdb6db2-646b-4d33-91cf-5f2d0caf835d/download/streetlightgroup.json",
            
323
      "url_type": "upload"
322
      "url_type": "upload"
            
324
    },
323
    },
            
325
    {
324
    {
            
326
      "cache_last_updated": null,
325
      "cache_last_updated": null,
            
327
      "cache_url": null,
326
      "cache_url": null,
            
328
      "created": "2024-03-08T12:07:19.864917",
327
      "created": "2024-03-08T12:07:19.864917",
            
329
      "datastore_active": false,
328
      "datastore_active": false,
            
330
      "description": "An example of a WeatherObserved entity used to 
329
      "description": "An example of a WeatherObserved entity used to 
            
331
store illuminance measurements.",
330
store illuminance measurements.",
            
332
      "format": "JSON",
331
      "format": "JSON",
            
333
      "hash": "",
332
      "hash": "",
            
334
      "id": "02618afc-9aa9-4f58-ae6c-7c3fb3fce2ee",
333
      "id": "02618afc-9aa9-4f58-ae6c-7c3fb3fce2ee",
            
335
      "last_modified": "2024-03-08T12:07:19.835570",
334
      "last_modified": "2024-03-08T12:07:19.835570",
            
336
      "metadata_modified": "2024-03-08T12:08:40.875688",
335
      "metadata_modified": "2024-03-08T12:08:40.875688",
            
337
      "mimetype": "application/json",
336
      "mimetype": "application/json",
            
338
      "mimetype_inner": null,
337
      "mimetype_inner": null,
            
339
      "name": "Example WeatherObserved entity",
338
      "name": "Example WeatherObserved entity",
            
340
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
339
      "package_id": "73444995-4438-4443-9402-b11cf84a7060",
            
341
      "position": 4,
340
      "position": 4,
            
342
      "resource_type": null,
341
      "resource_type": null,
            
343
      "size": 1203,
342
      "size": 1203,
            
344
      "state": "active",
343
      "state": "active",
            
345
      "url": 
344
      "url": 
            
346
e/02618afc-9aa9-4f58-ae6c-7c3fb3fce2ee/download/weatherobserved.json",
345
e/02618afc-9aa9-4f58-ae6c-7c3fb3fce2ee/download/weatherobserved.json",
            
347
      "url_type": "upload"
346
      "url_type": "upload"
            
348
    }
347
    }
            
349
  ],
348
  ],
            
350
  "state": "active",
349
  "state": "active",
            
351
  "tags": [
350
  "tags": [
            
352
    {
351
    {
            
353
      "display_name": "electricity",
352
      "display_name": "electricity",
            
354
      "id": "0c58cb6b-5845-4112-9871-6adda7eaac59",
353
      "id": "0c58cb6b-5845-4112-9871-6adda7eaac59",
            
355
      "name": "electricity",
354
      "name": "electricity",
            
356
      "state": "active",
355
      "state": "active",
            
357
      "vocabulary_id": null
356
      "vocabulary_id": null
            
358
    },
357
    },
            
359
    {
358
    {
            
360
      "display_name": "street light",
359
      "display_name": "street light",
            
361
      "id": "90cb5931-2582-4ea0-a5dd-c0aa32bea5a4",
360
      "id": "90cb5931-2582-4ea0-a5dd-c0aa32bea5a4",
            
362
      "name": "street light",
361
      "name": "street light",
            
363
      "state": "active",
362
      "state": "active",
            
364
      "vocabulary_id": null
363
      "vocabulary_id": null
            
365
    },
364
    },
            
366
    {
365
    {
            
367
      "display_name": "tampere",
366
      "display_name": "tampere",
            
368
      "id": "c4067e38-120f-428f-8175-6e7196e617b8",
367
      "id": "c4067e38-120f-428f-8175-6e7196e617b8",
            
369
      "name": "tampere",
368
      "name": "tampere",
            
370
      "state": "active",
369
      "state": "active",
            
371
      "vocabulary_id": null
370
      "vocabulary_id": null
            
372
    }
371
    }
            
373
  ],
372
  ],
            
374
  "temporal_end": "2020-05-04",
373
  "temporal_end": "2020-05-04",
            
375
  "temporal_resolution": "varies between the various types of data",
374
  "temporal_resolution": "varies between the various types of data",
            
376
  "temporal_start": "2018-10-01",
375
  "temporal_start": "2018-10-01",
            
377
  "title": "Tampere street lights",
376
  "title": "Tampere street lights",
            
378
  "type": "dataset",
377
  "type": "dataset",
            
379
  "url": "",
378
  "url": "",
            
380
  "version": ""
379
  "version": ""
            
381
}
380
}