MagicMirror/modules/default/weather/providers/openweathermap.js

/* global WeatherProvider, WeatherObject */

/* Magic Mirror
 * Module: Weather
 *
 * By Michael Teeuw http://michaelteeuw.nl
 * MIT Licensed.
 * 
 * This class is the blueprint for a weather provider.
 */

WeatherProvider.register("openweathermap", {

	// Set the name of the provider.
	// This isn't strictly necessary, since it will fallback to the provider identifier
	// But for debugging (and future alerts) it would be nice to have the real name.
	providerName: "OpenWeatherMap",

	// Overwrite the fetchCurrentWeather method.
	fetchCurrentWeather: function() {
		this.fetchData(this.getUrl())
			.then(data => {
				if (!data || !data.main || typeof data.main.temp === "undefined") {
					// Did not receive usable new data.
					// Maybe this needs a better check?
					return;
				}

				this.setFetchedLocation(data.name + ', ' + data.sys.country)

				var currentWeather = this.generateWeatherObjectFromCurrentWeather(data)
				this.setCurrentWeather(currentWeather)
			})
			.catch(function(request) {
				Log.error("Could not load data ... ", request)
			})
	},

	// Overwrite the fetchCurrentWeather method.
	fetchWeatherForecast: function() {
		this.fetchData(this.getUrl())
			.then(data => {
				if (!data || !data.list || !data.list.length) {
					// Did not receive usable new data.
					// Maybe this needs a better check?
					return;
				}

				this.setFetchedLocation(data.city.name + ', ' + data.city.country)

				var forecast = this.generateWeatherObjectsFromForecast(data.list)
				this.setWeatherForecast(forecast)
			})
			.catch(function(request) {
				Log.error("Could not load data ... ", request)
			})
	},



	/** OpenWeatherMap Specific Methods - These are not part of the default provider methods */
	/*
	 * Gets the complete url for the request
	 */
	getUrl: function() {
		return this.config.apiBase + this.config.apiVersion + this.config.weatherEndpoint + this.getParams()
	},

	/* 
	 * Generate a WeatherObject based on currentWeatherInformation
	 */
	generateWeatherObjectFromCurrentWeather: function(currentWeatherData) {
		var currentWeather = new WeatherObject()

		currentWeather.humidity = currentWeatherData.main.humidity
		currentWeather.temperature = currentWeatherData.main.temp
		currentWeather.windSpeed = currentWeatherData.wind.speed
		currentWeather.windDirection = currentWeatherData.wind.deg
		currentWeather.weatherType = this.convertWeatherType(currentWeatherData.weather[0].icon)
		currentWeather.sunrise = moment(currentWeatherData.sys.sunrise, "X")
		currentWeather.sunset = moment(currentWeatherData.sys.sunset, "X")

		return currentWeather
	},

	/*
	 * Generate WeatherObjects based on forecast information
	 */
	generateWeatherObjectsFromForecast: function(forecasts) {
		var days = []

		for (var forecast of forecasts) {
			var weather = new WeatherObject()

			weather.date = moment(forecast.dt, "X")
			weather.minTemperature = forecast.temp.min
			weather.maxTemperature = forecast.temp.max
			weather.weatherType = this.convertWeatherType(forecast.weather[0].icon)
			weather.rain = forecast.rain

			days.push(weather)
		}

		return days
	},

	/*
	 * Convert the OpenWeatherMap icons to a more usable name.
	 */
	convertWeatherType: function(weatherType) {
		var weatherTypes = {
			"01d": "day-sunny",
			"02d": "day-cloudy",
			"03d": "cloudy",
			"04d": "cloudy-windy",
			"09d": "showers",
			"10d": "rain",
			"11d": "thunderstorm",
			"13d": "snow",
			"50d": "fog",
			"01n": "night-clear",
			"02n": "night-cloudy",
			"03n": "night-cloudy",
			"04n": "night-cloudy",
			"09n": "night-showers",
			"10n": "night-rain",
			"11n": "night-thunderstorm",
			"13n": "night-snow",
			"50n": "night-alt-cloudy-windy"
		}

		return weatherTypes.hasOwnProperty(weatherType) ? weatherTypes[weatherType] : null
	},

	/* getParams(compliments)
	 * Generates an url with api parameters based on the config.
	 *
	 * return String - URL params.
	 */
	getParams: function() {
		var params = "?";
		if(this.config.locationID) {
			params += "id=" + this.config.locationID;
		} else if(this.config.location) {
			params += "q=" + this.config.location;
		} else if (this.firstEvent && this.firstEvent.geo) {
			params += "lat=" + this.firstEvent.geo.lat + "&lon=" + this.firstEvent.geo.lon
		} else if (this.firstEvent && this.firstEvent.location) {
			params += "q=" + this.firstEvent.location;
		} else {
			this.hide(this.config.animationSpeed, {lockString:this.identifier});
			return;
		}

		params += "&units=" + this.config.units;
		params += "&lang=" + this.config.lang;
		params += "&APPID=" + this.config.apiKey;

		return params;
	},
});