Snowparks¶
A resource that implements the concept of Snowpark defined in the AlpineBits® Ontology.
A JSON object representing such a resource MUST contain the following fields:
-
type: the constant"snowparks"that identifies the resource as being of the type snowpark. -
id: a string that uniquely and persistently identifies the snowpark within a SERVER. See the definition in ???. -
attributes: an object containing the attributes of the snowpark. -
relationships: an object containing the relationships of the snowpark to other resources. -
links: an object containing the links related to the snowpark.
A snowpark resource is structured as follows:
{
"type": "snowparks",
"id": "1",
"meta": { ... },
"attributes": { ... },
"relationships": { ... },
"links": { ... }
}
Meta¶
See the definition of the meta object in ???.
Attributes¶
The attributes object of a snowpark resource MUST contain the following fields:
-
abstract: a ??? object containing a brief description for the snowpark. Nullable. See the definition in ???. -
address: an ??? object representing the address of the snowpark. The address should only be set if the snowpark is directly accessible from a public road. Nullable. -
description: a ??? object containing a description of the snowpark. Nullable. Conditional Assignment. See the definition in ???. -
difficulty: a string describing the difficulty level of a snowpark according to the following enumerated values:-
"beginner" -
"intermediate" -
"advanced" -
"expert"
-
-
geometries: an array of ??? objects each of which represents the location of the snowpark in terms of GPS coordinates. There should be at most one geometry object of each type (e.g. Point, LineString). Nullable. Non-empty. -
howToArrive: a ??? object containing instructions on how to arrive at the snowpark. Nullable. -
length: a number representing the total length of the snowpark in meters. The computation of the length (in the case of branching paths, for instance) is determined by the data provider. Nullable. -
maxAltitude: a number representing the highest elevation point of the snowpark in meters above sea level. Nullable. -
minAltitude: a number representing the lowest elevation point of the snowpark in meters above sea level. Nullable. -
name: a ??? object containing the complete name of the snowpark. Non-nullable. Conditional Assignment. See the definition in ???. -
openingHours: an ??? object representing the hours in which the snowpark is open to the public. Nullable. -
shortName: a ??? object containing a short name of the snowpark. Nullable. See the definition in ???. -
snowCondition: a ??? object containing the latest reported condition of the snow in the snowpark. -
url: a ??? object or string describing the snowpark, such as a website or a Wikipedia page. Nullable. See the definition in ???.
A summary of the attributes is presented in the table below:
| Field | Type | Constraints |
|---|---|---|
abstract |
Nullable |
|
address |
Nullable |
|
description |
Nullable, Conditional Assignment |
|
difficulty |
string |
Enumeration, Nullable |
geometries |
Array of ??? |
Nullable, Non-empty |
howToArrive |
string |
Nullable |
length |
number |
Nullable, Unit of Measure, Greater than Zero |
maxAltitude |
number |
Nullable, Unit of Measure |
minAltitude |
number |
Nullable, Unit of Measure |
name |
Non-nullable, Conditional Assignment |
|
openingHours |
Nullable |
|
shortName |
Nullable |
|
snowCondition |
Nullable |
|
url |
Nullable |
Relationships¶
The relationships object of a snowpark resource MUST contain the following fields:
-
categories: a ??? category resources that are instantiated by the snowpark. See Section ???. Nullable. Non-empty.No category is pre-defined by the standard.
-
connections: a ??? place resources that identify the places that are physically accessible from the mountain area, which may include other Snowparks, ???, ???, and ???. Nullable. Non-empty.Notice that connections between place resources may not be symmetrical (i.e., bidirectional). For example, a place like a lift may give access to a snowpark, but the snowpark may not give access back to it.
-
features: a ??? feature resources present in a snowpark, such as a ramp or a rail. See Section ???. Nullable. Non-empty.No feature is pre-defined by the standard.
-
multimediaDescriptions: a ??? media object resources (see ???) that are related to the snowpark. See Section ???. Nullable. Non-empty.
A summary of the relationships is presented in the table below:
| Field | Type | Constraints |
|---|---|---|
categories |
Nullable, Non-empty |
|
connections |
Nullable, Non-empty |
|
features |
Nullable, Non-empty |
|
multimediaDescriptions |
Nullable, Non-empty |
Links¶
See the definition of the links object in ???.
Examples¶
The following example contains the minimal information required for a snowpark resource:
{
"type": "snowparks",
"id": "1",
"meta": {
"dataProvider": null,
"lastUpdate": null
},
"attributes": {
"name": {
"eng": "Snowpark Merano 2000"
},
"shortName": null,
"description": null,
"abstract": null,
"url": null,
"length": null,
"minAltitude": null,
"maxAltitude": null,
"address": {
"street": null,
"city": {
"eng": "Merano"
},
"region": null,
"country": "IT",
"zipcode": null,
"categories": null,
"complement": null
},
"howToArrive": null,
"difficulty": null,
"geometries": null,
"openingHours": null,
"snowCondition": null
},
"relationships": {
"connections": null,
"features": null,
"categories": null,
"multimediaDescriptions": null
},
"links": {
"self": "https://example.com/2022-04/snowparks/1"
}
}
|
The following example illustrates the fields defined for snowpark resources:
{
"type": "snowparks",
"id": "1",
"meta": {
"dataProvider": "https://example.com",
"lastUpdate": "2020-04-01T08:00:00+02:00"
},
"attributes": {
"name": {
"ita": "Snowpark Merano 2000",
"deu": "Snowpark Merano 2000",
"eng": "Snowpark Merano 2000"
},
"shortName": {
"eng": "Snowpark Merano 2000"
},
"description": {
"eng": "Located in the rear part of the skiing area on the Oswald-Slope, close to the Waidmann Alpine Cottage, the SNOWPARK MERANO 2000 awaits brave Snowboarders and Freestylers. An ambitious project with many kicks, rails, tubes and boxes for newcomers and pros alike. You can reach the Jump Zone from the mountain station of the Ropeway by using the chairlift Piffing."
},
"abstract": {
"eng": "Located in the rear part of the skiing area on the Oswald-Slope, close to the Waidmann Alpine Cottage, the SNOWPARK MERANO 2000 awaits brave Snowboarders and Freestylers..."
},
"url": "https://example.com",
"length": 1300,
"minAltitude": 1500,
"maxAltitude": 2500,
"address": {
"street": null,
"city": {
"eng": "Merano"
},
"region": null,
"country": "IT",
"zipcode": null,
"categories": null,
"complement": null
},
"howToArrive": null,
"difficulty": "intermediate",
"geometries": [
{
"type": "LineString",
"coordinates": [
[
11.305682659149168,
46.66705018437341
],
[
11.30692720413208,
46.667182709603225
],
[
11.308064460754393,
46.667491933875965
]
]
}
],
"openingHours": {
"dailySchedules": {
"2020-12-25": null
},
"weeklySchedules": [
{
"validFrom": "2020-01-01",
"validTo": "2020-12-31",
"monday": [
{
"opens": "08:00:00+01:00",
"closes": "18:00:00+01:00"
}
],
"tuesday": [
{
"opens": "08:00:00+01:00",
"closes": "18:00:00+01:00"
}
],
"wednesday": [
{
"opens": "08:00:00+01:00",
"closes": "18:00:00+01:00"
}
],
"thursday": [
{
"opens": "08:00:00+01:00",
"closes": "18:00:00+01:00"
}
],
"friday": [
{
"opens": "08:00:00+01:00",
"closes": "18:00:00+01:00"
}
],
"saturday": [
{
"opens": "08:00:00+01:00",
"closes": "18:00:00+01:00"
}
],
"sunday": [
{
"opens": "08:00:00+01:00",
"closes": "18:00:00+01:00"
}
]
}
]
},
"snowCondition": {
"primarySurface": "frozen-granular",
"secondarySurface": "packed-powder",
"baseSnow": 30,
"baseSnowRange": {
"lower": 25,
"upper": 40
},
"latestStorm": 5,
"obtainedIn": "2020-01-14",
"snowOverNight": 0,
"groomed": true,
"snowMaking": false
}
},
"relationships": {
"connections": {
"data": [
{
"type": "skiSlopes",
"id": "2"
},
{
"type": "skiSlopes",
"id": "3"
}
],
"links": {
"related": "https://example.com/2022-04/snowparks/1/connections/"
}
},
"features": {
"data": [
{
"type": "features",
"id": "example:jib"
},
{
"type": "features",
"id": "example:pipe"
}
],
"links": {
"related": "https://example.com/2022-04/snowparks/1/features"
}
},
"categories": {
"data": [
{
"type": "categories",
"id": "example:free-style"
}
],
"links": {
"related": "https://example.com/2022-04/snowparks/1/categories"
}
},
"multimediaDescriptions": {
"data": [
{
"type": "mediaObjects",
"id": "2"
}
],
"links": {
"related": "https://example.com/2022-04/snowparks/1/multimediaDescriptions/"
}
}
},
"links": {
"self": "https://example.com/2022-04/snowparks/1"
}
}
|