Import OpenWeatherMap Data to Google Sheets
In this guide, we’ll walk through how to pull data from the OpenWeatherMap API directly into Google Sheets, using the API Connector add-on for Sheets. We’ll first get an API key from OpenWeatherMap, and then set up a request to pull in weather forecast details from OpenWeatherMap to your spreadsheet.
- Part 1: Get your OpenWeatherMap API Key
- Part 2: Create your API Request URL
- Part 3: Pull OpenWeatherMap API Data into Sheets
- Part 4: Notes and Expansions
- If you haven’t already, sign up for an account at https://home.openweathermap.org/users/sign_up
- Once you have an account, click your name to open the account menu and navigate to the API keys section.
- There should be a default API key already created for you (if not, you can click the ‘Generate’ button to make a new one). Keep it handy as we’ll need it shortly. That’s it! You now have access to OpenWeatherMap. Just note that OpenWeatherMap takes 15-20 minutes to recognize newly created API keys, so take a little break before moving to the next section.
We’ll follow the OpenWeatherMap API documentation to access current weather data for a specific location. OpenWeatherMap has both free and paid plans, but for the purposes of this example we’ll stick to the free data.
- API root: http://api.openweathermap.org/data/2.5
- Endpoint: /weather
- Parameters: q=CITY_NAME,COUNTRY_CODE&APPID=YOUR_API_KEY
Putting it all together, we get the full API Request URL:
Of course, you should substitute in your own API key and location of interest.
We can now enter all our values into API Connector and start importing OpenWeatherMap data into Google Sheets.
- Open up Google Sheets and click Add-ons > API Connector > Create New API Request.
- In the Create Request interface, enter the Request URL we just created
- Leave the headers section blank as we don’t need any headers for this request.
- Create a new tab. You can call it whatever you like, but here we’ll call it ‘LondonWeather’. While still in that tab, click ‘Set’ to use that tab as your data destination.
- Name your request. Again we’ll call it ‘LondonWeather’
- Click Run and a moment later you’ll see weather data populate the OpenWeatherMap tab in your Google Sheet:
- When querying weather data from OpenWeatherMap, you can identify locations by either city name (
q=London), city name + country code (
q=London,uk), city ID (
id=2172797), geographic coordinates (
lat=35&lon=139), or zip code (
zip=94040,us). If you’re interested in querying results for a specific city, use the city ID to avoid ambiguous results.
- Experiment with endpoints and query strings as described in the documentation to see other types of weather data. For example, you’d get a 5-day forecast for Moscow by entering the following:
(Tip: When you run this query, note that the
list » dt_txtfield contains the date and time stamp for the forecast).
- You can query the following data collections for free: Current weather data, 5 day / 3 hour forecast, and Weather stations. There is also a new One Call API that offers 1000 free API calls a day. Free accounts have limited service availability; if you query too rapidly you may receive the following error message: “Your account is temporary blocked due to exceeding of requests limitation of your subscription type.” In those cases, stop and wait for 10 minutes before repeating your request.
Following the above steps, you will now be able to import data from the OpenWeatherMap API directly into Google Sheets.