Skip to content

Discover the current weather and time zone information for any location around the world using this interactive map.

License

Notifications You must be signed in to change notification settings

scottgriv/WTZ-Map

Repository files navigation


JavaScript Badge
GitHub Badge Email Badge BuyMeACoffee Badge
GitHub Workflow Status (with event) Silver


Weather Time Zone (WTZ) Map

This Nuxt application allows you to discover the current weather and time zone information for any location around the world. Simply input a location, and the app will display the relevant data, including weather conditions, time zone, and current time.


Application Preview

Table of Contents

Getting Started

Prerequisites

Before you begin, ensure you have met the following requirements:

  • You have installed Node.js and npm.
  • You have a GitHub account.

Installation

  1. Clone the repository:

    git clone https://github.com/scottgriv/WTZ-Map.git
    cd WTZ-Map
  2. Install dependencies:

    npm install
  3. Obtain API keys:

  4. Set up environment variables:

    Create a .env file in the root directory of your project and add your API keys:

    NUXT_ENV_OPENWEATHER_API_KEY=your_openweathermap_api_key
    NUXT_ENV_TIMEZONEDB_API_KEY=your_timezonedb_api_key
    
  5. Run the application locally:

    npm run dev

    The application should now be running on http://localhost:3000.

To deploy your Nuxt application to GitHub Pages, follow these steps:

  1. Add your API keys as GitHub Secrets:
    • Go to your GitHub repository.
    • Click on Settings.
    • Navigate to Secrets and variables > Actions.
    • Click on New repository secret.
    • Add the following secrets:
      • NUXT_ENV_OPENWEATHER_API_KEY
      • NUXT_ENV_TIMEZONEDB_API_KEY

Caution

Secrets must have the NUXT_ENV prefix to properly work. See this Nuxt.js documentation here for more information.

Usage

  1. Enter a location in the search bar.
  2. Click the search button or hit the enter key.
  3. View the corresponding data on the screen.
  4. Click the reset button to clear the results and reset the map view.

Resources

APIs:

Technologies:

Maps Free Tile Providers (No API Key Required)

Note

Easily swap out your map provider by searching for the Change Map Provider Here comment in the code base. Replace the few lines of code below the comment with your map/tile provider or one of the providers mentioned above. By default, I'm using Esri with the World_Topo_Map (topological) style.

License

This project is released under the terms of the MIT License, which permits use, modification, and distribution of the code, subject to the conditions outlined in the license.

  • The MIT License provides certain freedoms while preserving rights of attribution to the original creators.
  • For more details, see the LICENSE file in this repository. in this repository.

Credits

Author: Scott Grivner
Email: scott.grivner@gmail.com
Website: scottgrivner.dev
Reference: Main Branch