{"files":{"SKILL.md":"---\nname: documentation-for-your-premium-plan\ndescription: \"Documentation for your Premium plan API skill. Use when working with Documentation for your Premium plan for point, air_quality, time_machine. Covers 7 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Documentation for your Premium plan\nAPI version: v1\n\n## Auth\nApiKey X-API-Key in header | ApiKey Authorization in header\n\n## Base URL\nhttps://www.meteosource.com/api/v1/premium\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /point -- get weather data\n3. Explore available endpoints below\n\n## Endpoints\n7 endpoints across 7 groups. See references/api-spec.lap for full details.\n\n### Point\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /point | Get weather data |\n\n### Air_quality\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /air_quality | Get air quality data |\n\n### Time_machine\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /time_machine | Get historical weather data |\n\n### Find_places\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /find_places | Search for places |\n\n### Find_places_prefix\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /find_places_prefix | Search for places by prefix |\n\n### Nearest_place\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /nearest_place | Search for nearest place by coordinates |\n\n### Map\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /map | Get PNG weather map |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all point?\" -> GET /point\n- \"List all air_quality?\" -> GET /air_quality\n- \"List all time_machine?\" -> GET /time_machine\n- \"List all find_places?\" -> GET /find_places\n- \"List all find_places_prefix?\" -> GET /find_places_prefix\n- \"List all nearest_place?\" -> GET /nearest_place\n- \"List all map?\" -> GET /map\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Interactive documentation for your Premium plan\n@base https://www.meteosource.com/api/v1/premium\n@version v1\n@auth ApiKey X-API-Key in header | ApiKey Authorization in header\n@common_fields {key: str # Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header.}\n@endpoints 7\n@toc point(1), air_quality(1), time_machine(1), find_places(1), find_places_prefix(1), nearest_place(1), map(1)\n\n@group point\n@endpoint GET /point\n@desc Get weather data\n@optional {place_id: str # Identifier of a place. To obtain the `place_id` for the location you want, please use endpoints `/find_places_prefix` (search by prefix) or `/find_places` (search by full name)., lat: str # Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4, lon: str # Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4, sections: str=current,hourly # Sections to be included in the response. You can specify more section by separating the values with a comma. The available values are:  * ``current``: Current weather situation * ``daily``: Forecasts for each whole day, without the daily parts * ``daily-parts``: Forecasts for each whole day, morning, afternoon and evening     * Important: forecast for the morning, afternoon and evening is available only for the first       7 days in the forecast * ``hourly``: Forecasts with hourly resolution * ``minutely``: Precipitation forecast with 1 minute resolution * ``alerts``: The weather alerts * ``all``: All sections, timezone: str # Timezone to be used for the date fields. If not specified, local timezone of the forecast location will be used. The format is according to the tzinfo database, so values like `Europe/Prague` or `UTC` can be used. Alternatively you may use the value ``auto`` in which case the local timezone of the location is used. The full list of valid timezone strings can be found [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List)., language: str(cs/en/de/es/fr/pl/pt)=en # The language of text summaries and place names (variable names are never translated)., units: str(auto/metric/us/uk/ca)=auto # Unit system to be used.}\n@returns(200) Successful Response\n@errors {400: Error in passed parameter., 402: Maximum requests per day limit exceeded., 403: API key not specified or invalid., 422: Validation Error, 429: Maximum requests per minute limit exceeded.}\n\n@endgroup\n\n@group air_quality\n@endpoint GET /air_quality\n@desc Get air quality data\n@optional {place_id: str # Identifier of a place. To obtain the `place_id` for the location you want, please use endpoints `/find_places_prefix` (search by prefix) or `/find_places` (search by full name)., lat: str # Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4, lon: str # Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4, timezone: str # Timezone to be used for the date fields. If not specified, local timezone of the forecast location will be used. The format is according to the tzinfo database, so values like `Europe/Prague` or `UTC` can be used. Alternatively you may use the value ``auto`` in which case the local timezone of the location is used. The full list of valid timezone strings can be found [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List).}\n@returns(200) Successful Response\n@errors {400: Error in passed parameter., 402: Maximum requests per day limit exceeded., 403: API key not specified or invalid., 422: Validation Error, 429: Maximum requests per minute limit exceeded.}\n\n@endgroup\n\n@group time_machine\n@endpoint GET /time_machine\n@desc Get historical weather data\n@required {date: str(date) # The day of the data in the past. Specify in `YYYY-MM-DD` format, e.g. `2021-08-24`.}\n@optional {place_id: str # Identifier of a place. To obtain the `place_id` for the location you want, please use endpoints `/find_places_prefix` (search by prefix) or `/find_places` (search by full name)., lat: str # Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4, lon: str # Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4, timezone: str # Timezone to be used for the date fields. If not specified, local timezone of the location will be used. The format is according to the tzinfo database, so values like `Europe/Prague` or `UTC` can be used. Alternatively you may use the value ``auto`` in which case the local timezone of the location is used. The full list of valid timezone strings can be found [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List)., units: str(auto/metric/us/uk/ca)=auto # Unit system to be used., language: str(cs/en/de/es/fr/pl/pt)=en # The language of weather summaries (variable names are never translated).}\n@returns(200) Successful Response\n@errors {400: Error in passed parameter., 402: Maximum requests per day limit exceeded., 403: API key not specified or invalid., 422: Validation Error, 429: Maximum requests per minute limit exceeded.}\n\n@endgroup\n\n@group find_places\n@endpoint GET /find_places\n@desc Search for places\n@required {text: str # Place name or ZIP code}\n@optional {language: str(cs/en/de/es/fr/pl/pt)=en # The language of text summaries and place names (variable names are never translated).}\n@returns(200) Successful Response\n@errors {400: Error in passed parameter., 402: Maximum requests per day limit exceeded., 403: API key not specified or invalid., 422: Validation Error, 429: Maximum requests per minute limit exceeded.}\n\n@endgroup\n\n@group find_places_prefix\n@endpoint GET /find_places_prefix\n@desc Search for places by prefix\n@required {text: str # Place name or ZIP code}\n@optional {language: str(cs/en/de/es/fr/pl/pt)=en # The language of text summaries and place names (variable names are never translated).}\n@returns(200) Successful Response\n@errors {400: Error in passed parameter., 402: Maximum requests per day limit exceeded., 403: API key not specified or invalid., 422: Validation Error, 429: Maximum requests per minute limit exceeded.}\n\n@endgroup\n\n@group nearest_place\n@endpoint GET /nearest_place\n@desc Search for nearest place by coordinates\n@required {lat: str # Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4, lon: str # Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4}\n@optional {language: str(cs/en/de/es/fr/pl/pt)=en # The language of text summaries and place names (variable names are never translated).}\n@returns(200) {name: str, place_id: str, adm_area1: any, adm_area2: any, country: any, lat: str, lon: str, timezone: any, type: str} # Successful Response\n@errors {400: Error in passed parameter., 402: Maximum requests per day limit exceeded., 403: API key not specified or invalid., 422: Validation Error, 429: Maximum requests per minute limit exceeded.}\n\n@endgroup\n\n@group map\n@endpoint GET /map\n@desc Get PNG weather map\n@required {variable: str # Name of the variable for your map. Available values are:  * `temperature`: Temperature 2 metres above ground * `feels_like_temperature`: Feels like temperature * `clouds`: Percentage of sky covered by clouds * `precipitation`: Total precipitation amount accumulated since last hour * `wind_speed`: Wind speed 10 metres above the ground * `wind_gust`: Wind gust speed * `pressure`: Atmospheric pressure at mean sea level * `humidity`: Relative humidity * `wave_height`: Wave height * `wave_period`: Wave period * `sea_temperature`: Sea temperature (available only for +-24 hours) * `air_quality`: Air quality index * `ozone_surface`: Ozone at surface level * `ozone_total`: Total column ozone * `no2`: Nitrogen dioxide at surface level * `pm2.5`: Particulate matter d < 2.5 µm (PM2.5), datetime: str # There are two ways to specify date and time for your map:  1. Datetime in `YYYY-MM-DDTHH:MM` format and `UTC` timezone, e.g. `2021-08-24T12:00` 2. Offset from current time in `[+-]` format, e.g. `+10minutes`, `-2hours` or `+1days`}\n@optional {tile_x: int # The X coordinate of Google Maps tile, tile_y: int # The Y coordinate of Google Maps tile, tile_zoom: int # The zoom level of Google Maps tile, min_lat: str # Minimal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2, min_lon: str # Minimal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2, max_lat: str # Maximal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2., max_lon: str # Maximal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2}\n@returns(200) Successful Response\n@errors {400: Error in passed parameter., 402: Maximum requests per day limit exceeded., 403: API key not specified or invalid., 422: Validation Error, 429: Maximum requests per minute limit exceeded.}\n\n@endgroup\n\n@end\n"}}