{"note":"OpenAPI conversion -- returning structured metadata","name":"meteosource-com","description":"Documentation for your Premium plan","version":"v1","base_url":"https://www.meteosource.com/api/v1/premium","endpoints":7,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api 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"}