docs: openweathermap service

README.md

@@ -90,6 +90,7 @@ The basic concept of `Mafl` is to create not just a homepage, but to create an i
 List of services:
 * **[Base](https://mafl.hywax.space/services/base.html)** - The main card of the service. Other services are created on the basis of this service.
 * **[IP API](https://mafl.hywax.space/services/ip-api.html)** - Shows information about your IP address.
+* **[Weather](https://mafl.hywax.space/services/weather.html)** - Shows weather information for your location.
 
 ## 🎨 Themes
 

docs/.vitepress/locales/en.ts

@@ -43,6 +43,7 @@ export default defineConfig({
         items: [
           { text: 'Base', link: '/base' },
           { text: 'IP API', link: '/ip-api' },
+          { text: 'Weather', link: '/openweathermap' },
         ],
       },
       {

docs/.vitepress/locales/ru.ts

@@ -43,6 +43,7 @@ export default defineConfig({
         items: [
           { text: 'Базовый', link: '/base' },
           { text: 'IP API', link: '/ip-api' },
+          { text: 'Погода', link: '/openweathermap' },
         ],
       },
       {

docs/ru/services/openweathermap.md

@@ -0,0 +1,72 @@
+# Open Weather Map  <in-version value="0.9.0" />
+
+<preview-service name="openweathermap" />
+
+Получает данные о погоде с сервиса [Open Weather Map](https://openweathermap.org/).
+
+<!--@include: ../_parts/extends-base-service.md-->
+
+## Широта и долгота
+
+Для получения данных о погоде необходимо указать широту и долготу. Эти данные можно получить с помощью сервиса [LatLong](https://www.latlong.net/).
+
+```yaml
+options:
+  lat: 51.5085
+  lon: -0.1257
+```
+
+## Единицы измерения
+
+Подробнее о единицах измерения можно прочитать в [документации](https://openweathermap.org/weather-data).
+
+```yaml
+options:
+  units: metric
+```
+
+Поддерживаемые значения: `metric`, `imperial`, `standard`
+
+Значение по умолчанию: `metric`
+
+## API ключ
+
+API ключ можно получить в личном кабинете [Open Weather Map](https://home.openweathermap.org/api_keys).
+
+```yaml
+secrets:
+  apiKey: 7ss07b6f7vb3b8329b4ff810c34dfb51
+```
+
+<!--@include: ../_parts/secrets-safety.md-->
+
+## Примеры
+
+### Базовый сервис
+
+::: code-group
+```yaml [config.yml]
+services:
+  - type: openweathermap
+    options:
+      lat: 51.5085
+      lon: -0.1257
+    secrets:
+      apiKey: 7ss07b6f7vb3b8329b4ff810c34dfb51
+```
+:::
+
+### Имперская система
+
+::: code-group
+```yaml [config.yml]
+services:
+  - type: openweathermap
+    options:
+      lat: 51.5085
+      lon: -0.1257
+      units: imperial
+    secrets:
+      apiKey: 7ss07b6f7vb3b8329b4ff810c34dfb51
+```
+:::

docs/services/openweathermap.md

@@ -0,0 +1,72 @@
+# Open Weather Map  <in-version value="0.9.0" />
+
+<preview-service name="openweathermap" />
+
+Weather data is received from [Open Weather Map](https://openweathermap.org/).
+
+<!--@include: ../_parts/extends-base-service.md-->
+
+## Latitude and longitude
+
+For weather data, you need to specify the latitude and longitude. This data can be obtained using the [LatLong](https://www.latlong.net/) service.
+
+```yaml
+options:
+  lat: 51.5085
+  lon: -0.1257
+```
+
+## Units
+
+Read more about units of measurement in the [documentation](https://openweathermap.org/weather-data).
+
+```yaml
+options:
+  units: metric
+```
+
+Values: `metric`, `imperial`, `standard`
+
+Default: `metric`
+
+## API key
+
+API key can be obtained in the personal account of [Open Weather Map](https://home.openweathermap.org/api_keys).
+
+```yaml
+secrets:
+  apiKey: 7ss07b6f7vb3b8329b4ff810c34dfb51
+```
+
+<!--@include: ../_parts/secrets-safety.md-->
+
+## Examples
+
+### Base service
+
+::: code-group
+```yaml [config.yml]
+services:
+  - type: openweathermap
+    options:
+      lat: 51.5085
+      lon: -0.1257
+    secrets:
+      apiKey: 7ss07b6f7vb3b8329b4ff810c34dfb51
+```
+:::
+
+### Imperial units
+
+::: code-group
+```yaml [config.yml]
+services:
+  - type: openweathermap
+    options:
+      lat: 51.5085
+      lon: -0.1257
+      units: imperial
+    secrets:
+      apiKey: 7ss07b6f7vb3b8329b4ff810c34dfb51
+```
+:::