@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Documentation for your Premium plan
@base https://www.meteosource.com/api/v1/premium
@version v1
@auth ApiKey X-API-Key in header | ApiKey Authorization in header
@common_fields {key: str}
@endpoints 7
@toc point(1), air_quality(1), time_machine(1), find_places(1), find_places_prefix(1), nearest_place(1), map(1)

@group point
@endpoint GET /point
@optional {place_id: str, lat: str, lon: str, sections: str=current,hourly, timezone: str, language: str(cs/en/de/es/fr/pl/pt)=en, units: str(auto/metric/us/uk/ca)=auto}
@returns(200)
@errors {400, 402, 403, 422, 429}

@endgroup

@group air_quality
@endpoint GET /air_quality
@optional {place_id: str, lat: str, lon: str, timezone: str}
@returns(200)
@errors {400, 402, 403, 422, 429}

@endgroup

@group time_machine
@endpoint GET /time_machine
@required {date: str(date)}
@optional {place_id: str, lat: str, lon: str, timezone: str, units: str(auto/metric/us/uk/ca)=auto, language: str(cs/en/de/es/fr/pl/pt)=en}
@returns(200)
@errors {400, 402, 403, 422, 429}

@endgroup

@group find_places
@endpoint GET /find_places
@required {text: str}
@optional {language: str(cs/en/de/es/fr/pl/pt)=en}
@returns(200)
@errors {400, 402, 403, 422, 429}

@endgroup

@group find_places_prefix
@endpoint GET /find_places_prefix
@required {text: str}
@optional {language: str(cs/en/de/es/fr/pl/pt)=en}
@returns(200)
@errors {400, 402, 403, 422, 429}

@endgroup

@group nearest_place
@endpoint GET /nearest_place
@required {lat: str, lon: str}
@optional {language: str(cs/en/de/es/fr/pl/pt)=en}
@returns(200) {name: str, place_id: str, adm_area1: any, adm_area2: any, country: any, lat: str, lon: str, timezone: any, type: str}
@errors {400, 402, 403, 422, 429}

@endgroup

@group map
@endpoint GET /map
@required {variable: str, datetime: str}
@optional {tile_x: int, tile_y: int, tile_zoom: int, min_lat: str, min_lon: str, max_lat: str, max_lon: str}
@returns(200)
@errors {400, 402, 403, 422, 429}

@endgroup

@end