Snowparks
A resource that implements the concept of Snowpark defined in the AlpineBits® DestinationData 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 Basic Fields. -
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": { ... }
}1. Meta
See the definition of the meta object in basic-resource-schema.adoc#anchor-metadata.
2. Attributes
The attributes object of a snowpark resource MUST contain the following fields:
-
abstract: a datatypes.adoc#anchor-text object containing a brief description for the snowpark. Nullable. See the definition in basic-resource-schema.adoc#anchor-attributes. -
address: an datatypes.adoc#anchor-address 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 datatypes.adoc#anchor-text object containing a description of the snowpark. Nullable. Conditional Assignment. See the definition in basic-resource-schema.adoc#anchor-attributes. -
difficulty: a string describing the difficulty level of a snowpark according to the following enumerated values:-
"beginner" -
"intermediate" -
"advanced" -
"expert"
-
-
geometries: an array of datatypes.adoc#anchor-geometry 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 datatypes.adoc#anchor-text 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 datatypes.adoc#anchor-text object containing the complete name of the snowpark. Non-nullable. Conditional Assignment. See the definition in basic-resource-schema.adoc#anchor-attributes. -
openingHours: an datatypes.adoc#anchor-hoursspecification object representing the hours in which the snowpark is open to the public. Nullable. -
shortName: a datatypes.adoc#anchor-text object containing a short name of the snowpark. Nullable. See the definition in basic-resource-schema.adoc#anchor-attributes. -
snowCondition: a datatypes.adoc#anchor-snow object containing the latest reported condition of the snow in the snowpark. -
url: a datatypes.adoc#anchor-url object or string describing the snowpark, such as a website or a Wikipedia page. Nullable. See the definition in basic-resource-schema.adoc#anchor-attributes.
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 datatypes.adoc#anchor-geometry |
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 |
3. Relationships
The relationships object of a snowpark resource MUST contain the following fields:
-
categories: a basic-resource-schema.adoc#anchor-referencetomany category resources that are instantiated by the snowpark. See Section Categories. Nullable. Non-empty.No category is pre-defined by the standard.
-
connections: a basic-resource-schema.adoc#anchor-referencetomany place resources that identify the places that are physically accessible from the mountain area, which may include other Snowparks, Lifts, Mountain Areas, and Ski Slopes. 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 basic-resource-schema.adoc#anchor-referencetomany feature resources present in a snowpark, such as a ramp or a rail. See Section Features. Nullable. Non-empty.No feature is pre-defined by the standard.
-
multimediaDescriptions: a basic-resource-schema.adoc#anchor-referencetomany media object resources (see Media Objects) that are related to the snowpark. See Section basic-resource-schema.adoc#anchor-multimediadescriptions. Nullable. Non-empty.
A summary of the relationships is presented in the table below:
| Field | Type | Constraints |
|---|---|---|
categories |
basic-resource-schema.adoc#anchor-referencetomany object to Categories |
Nullable, Non-empty |
connections |
basic-resource-schema.adoc#anchor-referencetomany object to Mountain Areas, Ski Slopes, Lifts, and Snowparks |
Nullable, Non-empty |
features |
basic-resource-schema.adoc#anchor-referencetomany object to Features |
Nullable, Non-empty |
multimediaDescriptions |
basic-resource-schema.adoc#anchor-referencetomany object to Media Objects |
Nullable, Non-empty |
4. Links
See the definition of the links object in basic-resource-schema.adoc#anchor-links.
5. 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"
}
}
|