OpenWeatherMap API
Synopsis
Give the today and tomorrow weather with the related data (humidity, temperature, etc ...) for a given location.
Options
| parameter | 
required | 
default | 
choices | 
comment | 
| api_key | 
YES | 
None | 
 | 
User API key of the OWM API | 
| location | 
YES | 
None | 
 | 
The location | 
| lang | 
No | 
en | 
multiple | 
First 2 letters cf : section Multilingual support in : lang | 
| temp_unit | 
No | 
Kelvin | 
Celsius, Kelvin, Fahrenheit | 
 | 
| country | 
No | 
US | 
multiple | 
Frist 2 letters of the country cf API doc | 
Return Values
| Name | 
Description | 
Type | 
sample | 
| location | 
The current location | 
String | 
Grenoble | 
| weather_today | 
Today : The weather sentence | 
String | 
cloudy | 
| sunset_today_time | 
Today : The sunset time (iso) | 
String | 
2016-10-15 20:07:57+00 | 
| sunrise_today_time | 
Today : The sunrise time (iso) | 
String | 
2016-10-15 07:07:57+00 | 
| temp_today_temp | 
Today : Average temperature | 
float | 
25 | 
| temp_today_temp_max | 
Today : Max temperature | 
float | 
45 | 
| temp_today_temp_min | 
Today : Min temperatue | 
float | 
5 | 
| pressure_today_press | 
Today : Pressure | 
float | 
1009 | 
| pressure_today_sea_level | 
Today : Pressure at the Sea level | 
float | 
1038.381 | 
| humidity_today | 
Today : % of humidity | 
float | 
60 | 
| wind_today_deg | 
Today : Direction of the wind in degree | 
float | 
45 | 
| wind_today_speed | 
Today : Wind speed | 
float | 
2.66 | 
| snow_today | 
Today : Volume of snow | 
float | 
0 | 
| rain_today | 
Today : Rain volume | 
float | 
0 | 
| clouds_coverage_today | 
Today : % Cloud coverage | 
float | 
65 | 
| weather_tomorrow | 
Tomorrow : The weather sentence | 
String | 
sunny | 
| sunset_time_tomorrow | 
Tomorrow : The sunset time (iso) | 
String | 
2016-10-16 20:07:57+00 | 
| sunrise_time_tomorrow | 
Tomorrow : The sunrise time (iso) | 
String | 
2016-10-16 07:07:57+00 | 
| temp_tomorrow_temp | 
Tomorrow : Average temperature | 
float | 
25 | 
| temp_tomorrow_temp_max | 
Tomorrow : Max temperature | 
float | 
45 | 
| temp_tomorrow_temp_min | 
Tomorrow : Min temperatue | 
float | 
5 | 
| pressure_tomorrow_press | 
Tomorrow : Pressure | 
float | 
1009 | 
| pressure_tomorrow_sea_level | 
Tomorrow : Pressure at the Sea level | 
float | 
1038.381 | 
| humidity_tomorrow | 
Tomorrow : % of humidity | 
float | 
60 | 
| wind_tomorrow_deg | 
Tomorrow : Direction of the wind in degree | 
float | 
45 | 
| wind_tomorrow_speed | 
Tomorrow : Wind speed | 
float | 
2.66 | 
| snow_tomorrow | 
Tomorrow : Volume of snow | 
float | 
0 | 
| rain_tomorrow | 
Tomorrow : Rain volume | 
float | 
0 | 
| clouds_coverage_tomorrow | 
Tomorrow : % Cloud coverage | 
float | 
65 | 
Synapses example
  - name: "get the weather"
    neurons:
      - openweathermap:
          api_key: "fdfba4097c318aed7836b2a85a6a05ef"
          lang: "en"
          temp_unit: "celsius"
          say_template:
          - "Today in {{ location }} the weather is {{ weather_today }} with a temperature of {{ temp_today_temp }} degree and tomorrow the weather will be {{ weather_tomorrow }} with a temperature of {{ temp_tomorrow_temp }} degree"
          args:
          - location
    signals:
      - order: "what is the weather in {{ location }}"
You also can define the "location" args directly in neuron argument list.
  - name: "get the weather"
    neurons:
      - openweathermap:
          api_key: "fdfba4097c318aed7836b2a85a6a05ef"
          lang: "fr"
          temp_unit: "celsius"
          location : "grenoble"
          country: "FR"
          say_template:
          - "Aujourd'hui a {{ location }} le temps est {{ weather_today }} avec une température de {{ temp_today_temp }} degrés et demain le temps sera {{ weather_tomorrow }} avec une température de {{ temp_tomorrow_temp }} degrés"
    signals:
      - order: "quel temps fait-il "
Templates example
    Today in {{ location }} the weather is {{ weather_today }} with a temperature of {{ temp_today_temp }} degree
Notes