info@ismena.com
Ismena websiteIsmena websiteIsmena websiteIsmena website
  • Home
  • About us
  • Technologies
    • Cloud Services
      • Google Cloud Platform
        • Networking
        • Compute
        • Storage
        • SAP on GCP
        • Google Maps
        • Data Center Modernization
    • Infrastructure
      • iSolution Services
      • Unified Communication
      • Network Security
      • Access Security & Control
      • Computing Platforms
      • Structured Cabling Infrastructure
      • Datacenter Infrastructure
      • Networking Infrastructure
      • Retail Analytics
      • Cloud Infrastructure
    • Integration
      • Apigee
      • IBM
      • Custom Connectors
      • UnifAI
    • Security
      • Security Consulting Services
      • Security Solutions
    • Data & AI
      • BigQuery, Looker
      • Gemini
    • Collaboration Tools
      • Google Workspace For Enterprise
    • ERP-CRM
      • Odoo
      • Salesforce
      • SAP on GCP
    • DevOps
      • GCP
      • SonarSource
    • Managed Service Provider
      • Managed Service Provider
    • App Development
      • App Development
    • Open Banking
      • Open banking
    • Chrome Devices
  • Unplugged Podcast
  • Blog
    • Success Stories
    • News
    • Articles
  • Careers
  • Contact Us

Technologies

Integration

Custom Connectors

Explore All Connectors

WeatherAPI Connector

WeatherAPI Connector

Connector Details

Type

Virtual machines, Single VM , BYOL

Runs on

Google Compute Engine

Last Update

24 October, 2024

Category

Overview

Documentation

Pricing

Support

Overview

The WeatherAPI Connector provides a robust interface to access WeatherAPI’s wide range of services, enabling seamless retrieval of current conditions, forecasts, historical weather, astronomy data, and more. Designed for developers building applications requiring weather and location-based data, this connector supports querying detailed weather information, location search, alerts, sports forecasts, time zones, and IP-based location lookups.
This documentation details each endpoint, including its purpose, required and optional parameters, configuration requirements, and expected outputs, along with practical workflow examples to guide implementation.

Integration Overview

This document provides a comprehensive guide for each endpoint, its purpose, configuration, and workflow support using the WeatherAPI Connector. The connector forwards HTTP GET requests to WeatherAPI, handling query parameters and headers to ensure reliable data retrieval.
Supported Integration Action Points

  • get_current_weather – Retrieves current weather conditions.
  • get_forecast_weather – Retrieves weather forecasts for specified days.
  • get_historical_weather – Retrieves past weather data for a given date.
  • get_future_weather – Retrieves future weather predictions.
  • get_marine_weather – Retrieves marine-related weather forecasts.
  • get_astronomy_data – Retrieves astronomy data like sunrise, sunset, and moon phases.
  • search_locations – Searches locations by name or query string.
  • get_alerts – Retrieves active weather alerts.
  • get_sports_weather – Retrieves weather data for sporting events or venues.
  • get_timezone_info – Retrieves time zone information for a location.
  • get_ip_lookup – Performs IP-based geolocation lookup.

Detailed Integration Documentation

Current Weather Retrieval

Action get_current_weather
Purpose Retrieves current weather conditions for a specified location.
Configuration Ensure the connector is configured with the base URL via CONNECTOR_ENV_WEATHERAPI_BASE_URL environment variable. Include the WeatherAPI key in the request header as key.
Parameters Required:
  • q: Location query (string, e.g., "London", "90210", or "latitude,longitude").
Optional:
  • lang: Language code for the response (string, e.g., "en", "fr").
Output
  • Successful: Returns a JSON object with current weather details including temperature, wind speed, humidity, and condition text.
  • Failure: Returns error codes (400: Bad Request, 401: Unauthorized, 404: Not Found, 500: Internal Server Error).
Workflow Example
  • Configure the connector with CONNECTOR_ENV_WEATHERAPI_BASE_URL.
  • Execute a GET request to /current.json?q=London.
  • Process the JSON response to display current conditions in your application.

Forecast Weather Retrieval

Action get_forecast_weather
Purpose Retrieves forecasted weather data for the specified location and days.
Parameters Required:
  • q: Location query (string).
  • days: Number of forecast days (integer, max supported by WeatherAPI).
Optional:
  • alerts: Include alerts (boolean).
  • aqi: Include air quality index (boolean).
Workflow Example
  • GET /forecast.json?q=London&days=3&alerts=yes&aqi=yes

Historical Weather Retrieval

Action get_historical_weather
Purpose Retrieves historical weather data for a given location and date.
Parameters Required:
  • q: Location query (string).
  • dt: Date in YYYY-MM-DD format.
Workflow Example
  • GET /history.json?q=London&dt=2024-09-01

Future Weather Retrieval

Action get_future_weather
Purpose Retrieves future (experimental) weather forecasts.
Parameters Required:
  • q: Location query.
  • dt: Date in the future (YYYY-MM-DD).
Workflow Example
  • GET /future.json?q=London&dt=2025-09-01

Marine Weather Retrieval

Action get_marine_weather
Purpose Retrieves marine weather forecasts for oceans or seas.
Parameters Required:
  • q: Marine location coordinates (latitude,longitude).
Workflow Example
  • GET /marine.json?q=36.7783,-119.4179

Astronomy Data Retrieval

Action get_astronomy_data
Purpose Retrieves astronomy data (sunrise, sunset, moon phases) for a location and date.
Parameters Required:
  • q: Location query.
  • dt: Date (optional, defaults to current).
Workflow Example
  • GET /astronomy.json?q=London&dt=2024-09-23

Location Search

Action search_locations
Purpose Searches for locations matching a query string.
Parameters Required:
  • q: Location name or query string.
Workflow Example
  • GET /search.json?q=Paris

Alerts Retrieval

Action get_alerts
Purpose Retrieves active weather alerts for a location.
Parameters Required:
  • q: Location query.
Workflow Example
  • GET /alerts.json?q=London

Sports Weather Retrieval

Action get_sports_weather
Purpose Retrieves weather data for sports venues or events.
Parameters Optional:
  • q: Location or venue query (some endpoints may return pre-defined sports venues).
Workflow Example
  • GET /sports.json?q=London

Timezone Info Retrieval

Action get_timezone_info
Purpose Retrieves time zone information for a location.
Parameters Required:
  • q: Location query.
Workflow Example
  • GET /timezone.json?q=London

IP Lookup

Action get_ip_lookup
Purpose Performs IP-based location lookup to retrieve location and time zone data.
Parameters Required:
  • q: IP address or auto:ip (string).
Workflow Example
  • GET /ip.json?q=auto:ip

Workflow Creation with the Connector

Example Workflow: Forecast and Alerts Integration

Retrieve Weather Forecast
  • Execute get_forecast_weather with q=London&days=3.
  • Display a 3-day forecast in the application.
Retrieve Weather Alerts
  • Execute get_alerts with q=London.
  • Display alerts (if any) alongside forecast data.
Show Astronomy Data
  • Execute get_astronomy_data with q=London.
  • Display sunrise and sunset times.
Time Zone Info
  • Execute get_timezone_info with q=London.
  • Adjust time displays in the app accordingly.

This workflow enables applications to provide users with accurate dataset exploration, querying, and export capabilities, enhancing data management and analysis.

Pricing

Request a Quote

Support

For Technical support please contact us on

custom-connectors-support@isolutions.sa

iSolution logo - white - transparent 250 px

iSolution logo - white - transparent 250 px

A tech solution company dedicated to providing innovation thus empowering businesses to thrive in the digital age.

  • Home
  • About us
  • Blog
  • Careers
  • Success Stories
  • News
  • Articles
  • Contact Us
  • Terms and conditions
  • Privacy Policy
© Copyright 2024 iSolution | All Rights Reserved
  • Home
  • About us
  • Technologies
    • Cloud Services
      • Google Cloud Platform
        • Networking
        • Compute
        • Storage
        • SAP on GCP
        • Google Maps
        • Data Center Modernization
    • Infrastructure
      • iSolution Services
      • Unified Communication
      • Network Security
      • Access Security & Control
      • Computing Platforms
      • Structured Cabling Infrastructure
      • Datacenter Infrastructure
      • Networking Infrastructure
      • Retail Analytics
      • Cloud Infrastructure
    • Integration
      • Apigee
      • IBM
      • Custom Connectors
      • UnifAI
    • Security
      • Security Consulting Services
      • Security Solutions
    • Data & AI
      • BigQuery, Looker
      • Gemini
    • Collaboration Tools
      • Google Workspace For Enterprise
    • ERP-CRM
      • Odoo
      • Salesforce
      • SAP on GCP
    • DevOps
      • GCP
      • SonarSource
    • Managed Service Provider
      • Managed Service Provider
    • App Development
      • App Development
    • Open Banking
      • Open banking
    • Chrome Devices
  • Unplugged Podcast
  • Blog
    • Success Stories
    • News
    • Articles
  • Careers
  • Contact Us
Ismena website

Register To Wired For Banking

Wired For Banking Riyadh

Register to Wired for Banking

Wired For Banking Doha

Register To Palo Alto & iSolution Event

Register to Gemini in Action Workshop

[forminator_form id=”14485″]

Registration To Amman Unplugged Event

[forminator_form id=”14419″]

Register to Gemini in Action Workshop

[forminator_form id=”14298″]

Tech and Culture Riyadh

[forminator_form id=”13094″]