Skip to content

Commit

Permalink
Merge pull request #31 from doublebyte1/dev-061223
Browse files Browse the repository at this point in the history
Updates on 06/12/23
  • Loading branch information
doublebyte1 authored Dec 6, 2023
2 parents 887afce + 7c55356 commit 07e13ae
Show file tree
Hide file tree
Showing 4 changed files with 45 additions and 40 deletions.
77 changes: 39 additions & 38 deletions workshop/content/docs/api-deep-dive/sensorthings.md
Original file line number Diff line number Diff line change
Expand Up @@ -398,12 +398,15 @@ only the result and phenomenonTime properties listed.

## Demo

- [Demo From SensorUp](http://developers.sensorup.com/docs/)
- Link: <http://toronto-bike-snapshot.sensorup.com/v1.0/>
- Behaves like a GetCapabilities.
- Provides URLs to interrogate further the service
On this section, we explore different ways to access a [SensorThings API server](http://developers.sensorup.com/docs/) on:

### Return Base Resource Path
<http://toronto-bike-snapshot.sensorup.com/v1.0/>

### Web Client

We start exploring the different endpoints available in the server using a web browser. In alternative you could also use [postman](https://www.postman.com/) or [curl](https://curl.se/).

#### Return Base Resource Path

<http://toronto-bike-snapshot.sensorup.com/v1.0/>

Expand All @@ -426,32 +429,27 @@ only the result and phenomenonTime properties listed.
"name": "Datastreams",
"url": "http://pm25-march.singapore2017.sensorup.com/v1.0/Datastreams"
},
{
"name": "Sensors",
"url": "http://pm25-march.singapore2017.sensorup.com/v1.0/Sensors"
},
{
"name": "Observations",
"url": "http://pm25-march.singapore2017.sensorup.com/v1.0/Observations"
},
{
"name": "ObservedProperties",
"url": "http://pm25-march.singapore2017.sensorup.com/v1.0/ObservedProperties"
},
{
"name": "FeaturesOfInterest",
"url": "http://pm25-march.singapore2017.sensorup.com/v1.0/FeaturesOfInterest"
}
]
}
```

### Return Base Resource Path (Cont)

``` properties
{
"name": "Sensors",
"url": "http://pm25-march.singapore2017.sensorup.com/v1.0/Sensors"
},
{
"name": "Observations",
"url": "http://pm25-march.singapore2017.sensorup.com/v1.0/Observations"
},
{
"name": "ObservedProperties",
"url": "http://pm25-march.singapore2017.sensorup.com/v1.0/ObservedProperties"
},
{
"name": "FeaturesOfInterest",
"url": "http://pm25-march.singapore2017.sensorup.com/v1.0/FeaturesOfInterest"
}
]
}
```

### Which *Things* are available in the server?
#### Which *Things* are available in the server?

<http://toronto-bike-snapshot.sensorup.com/v1.0/Things>

Expand All @@ -473,7 +471,7 @@ only the result and phenomenonTime properties listed.
> ...
> ```
### Getting a *Datastream* for a thing
#### Getting a *Datastream* for a thing
<http://toronto-bike-snapshot.sensorup.com/v1.0/Things(206047)/Datastreams>
Expand Down Expand Up @@ -511,7 +509,7 @@ only the result and phenomenonTime properties listed.
> },
> ```

### Getting the *Observations* related to a stream
#### Getting the *Observations* related to a stream

<http://toronto-bike-snapshot.sensorup.com/v1.0/Datastreams(206051)/Observations>

Expand All @@ -535,7 +533,7 @@ only the result and phenomenonTime properties listed.
},
```

### Complex Query
#### Complex Query

- Expands Datastreams and observations in one query
- Feature of Interest = 7000:Ft. York / Capreol Crt.
Expand All @@ -554,7 +552,7 @@ only the result and phenomenonTime properties listed.
> Datastreams/Observations/phenomenonTime le 2017-03-01T11:30:00.000Z
> ```
### Complex Query Response
#### Complex Query Response
> ``` properties
> {
Expand Down Expand Up @@ -583,11 +581,6 @@ only the result and phenomenonTime properties listed.
> "name": "dock count",
> "definition": "http://unitsofmeasure.org/ucum.html#para-50"
> },
> ```
### Complex Query Response (cont)
> ``` properties
> "Observations@iot.nextLink":
> ".../v1.0/Datastreams(9)/Observations?$top=100&$skip=100",
> "Observations":[
Expand All @@ -605,6 +598,14 @@ only the result and phenomenonTime properties listed.
> "description": " ...
> ```
### Python Client
The [Sensorthings API Python Client](https://pypi.org/project/frost-sta-client/) is a python package for developing applications with SensorThings API.
### QGIS Plugin
The [SensorThings API plugin](https://plugins.qgis.org/plugins/SensorThingsAPI/) enables QGIS software to access dynamic data from sensors, using SensorThings API protocol.
## References
[ITU-T, Overview of the Internet of
Expand Down
Binary file added workshop/content/docs/assets/images/bridges.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion workshop/content/docs/getting-involved.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ There are numerous ways to get involved with the development of OGC APIs. If you

Most of the OGC API development takes place on public [GitHub repositories](https://github.com/orgs/opengeospatial/repositories?q=ogcapi&type=all&language=&sort=). This means anyone can follow the development of the standards, from their early stages and even contribute through the usual mechanisms (e.g.: issue tracker, pull requests)

![Generated with AI ∙ 22 November 2023 at 4:24 pm](assets/images/oaf-issue-tracker.png){width="100.0%"}
![image](assets/images/oaf-issue-tracker.png){width="100.0%"}

## OGC Code sprints

Expand Down
6 changes: 5 additions & 1 deletion workshop/content/docs/transition-and-migration.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,8 @@ This could be the case of many [OWS standards](https://developer.ogc.org/ows.htm

As with deprecated Standards, Legacy Standards are no longer supported, but they remain on the OGC website with a notification that the capabilities of the Standard have been replaced in whole or part by new Standard(s). The notification will clearly indicate that the Legacy Standard is not invalid, but that new implementations of the capabilities of the Standard are better served by the identified new Standard(s).

In the Diving into pygeoapi Workshop, we include a section about the use of bridges to facilitate the migration from OWS to OGC API. TODO: add link
In the [Diving into pygeoapi Workshop](https://dive.pygeoapi.io), you can find
a section about the [use of bridges to facilitate the migration from OWS to OGC
API](https://dive.pygeoapi.io/advanced/bridges/).

![image](assets/images/bridges.png){width="80.0%"}

0 comments on commit 07e13ae

Please sign in to comment.