WeatherLayers GL

When using the Library to visualize data (including self-hosted data), the User is responsible for ensuring they have sufficient legal authorization to use that data.

Key obligations:

• You must obtain all necessary consents, licenses, or authorizations if the data is sourced from a third party.
• You must be able to provide written evidence of these authorizations to the Provider within 7 days of a written request.
• Failure to comply can lead to suspension of the License and Services, and may incur a contractual penalty of EUR 4,000 per violation.

The package and its source code are dual-licensed. Users can choose between:

• MPL-2.0
• WeatherLayers License Terms of Use (available at https://weatherlayers.com/license-terms-of-use.html)

For specific licensing inquiries, contact support@weatherlayers.com.

The License grants a non-exclusive right to use the Library and Technical Documentation for internal purposes. Users are prohibited from the following:

• Reverse Engineering: You may not disrupt or circumvent minification, decompile, disassemble, or attempt to obtain the source code of the Library.
• Distribution: You may not distribute, lend, rent, or communicate the Library or Documentation to third persons (including providing access to Library functionalities online).
• Modification: You may not modify or adapt the Library or Documentation, or create derivative works (though integration with the Web Application via API is permitted).
• Redistribution of Notices: You may not remove the Provider's copyright notices.
• Security Interference: You may not interfere with security measures or insert harmful code (malware, viruses, etc.).

The purchase of a paid License includes 1 year of Services (support and maintenance) starting from the date the License is provided.

Service Details:

• Scope: Support for failures, faults, or problems in the Library or Technical Documentation. You can contact the Provider via mailto:support@weatherlayers.com.
• Resolution: The Provider provides advice or work-around solutions but does not guarantee specific response or resolution times.
• Continuity: To ensure continued support after the initial 1-year term, a separate support and maintenance agreement must be concluded before the current term expires.

To use the Library, you must first purchase a License. You can do this by concluding a contract via email or through a user account in the WeatherLayers Web Application.

Steps to obtain the Library:

1. Sign up: Create a free account at https://weatherlayers.com (using the "Sign up" button) or at https://account.weatherlayers.com.
2. Select License: Choose your desired license type and provide the required information.
3. Payment: Complete the purchase. The contract is officially concluded once the price is fully paid and the Provider confirms the order via email.
4. Delivery: The Provider will deliver the Library via email or provide a download link (with credentials if necessary) within 10 days of purchase confirmation.

The StacCollection interface supports standard STAC properties, but also includes specific extensions used by the WeatherLayers Cloud Client to configure how weather data is rendered and controlled.

When implementing or consuming a STAC Collection, you can include these custom keys in the object:

• weatherLayers:imageType: Defines the type of image data.
• weatherLayers:imageUnscale: An array [number, number] or null used to unscale raster values.
• weatherLayers:units: An array of UnitDefinition objects.
• weatherLayers:layers: A DatasetLayersConfig object for layer management.
• weatherLayers:controls: A DatasetControlsConfig object for dataset controls.

The DatasetLayersConfig interface is used to configure different types of weather dataset layers. You can optionally specify configurations for contourLayer, gridLayer, highLowLayer, and particleLayer. Each layer type has its own specific configuration requirements.

const config: DatasetLayersConfig = {
  contourLayer: {
    interval: 1,
    majorInterval: 5
  },
  gridLayer: {
    style: myGridStyle,
    iconBounds: [-10, -10, 10, 10]
  },
  highLowLayer: {
    radius: 50
  },
  particleLayer: {
    speedFactor: 1.5,
    width: 2
  }
};

Use loadCatalog() to retrieve a list of available dataset IDs (STAC Collection IDs) from the service.

const datasetIds = await client.loadCatalog();
// Returns an array of strings, e.g., ['temperature', 'wind-speed']