Custom Connector
Malaysia Weather Connector
Malaysia
The Malaysia Weather Connector facilitates seamless integration with the Malaysia Weather API, a service provided by MET Malaysia offering real-time weather information for Malaysia. It provides access to 7-day general forecasts, weather warnings, and earthquake warnings, supporting queries and filtering by location and time period in JSON.
Overview
Integration Overview
This document provides a detailed guide for each integration point, its purpose, configuration, and workflow support using the Malaysia Weather API Connector.
- getWeatherForecast. Retrieve 7-day weather forecasts for Malaysian locations.
- getWeatherWarnings. Retrieve weather warnings issued by MET Malaysia.
- getEarthquakeWarnings. Retrieve earthquake warnings with location and magnitude details.
Documentation
Detailed Integration Documentation
Get Weather Forecast Retrieval
| Action | getWeatherForecast |
|---|---|
| Purpose | Retrieves a 7-day weather forecast for locations in Malaysia — morning, afternoon, and night forecasts, temperature ranges, and summaries. |
| Configuration | Configure the base URL via CONNECTOR_ENV_MALAYSIAWEATHERAPI_BASE_URL. |
| Parameters | Optional: limit (integer, min 1) — limits the number of forecast entries. contains — filters by prefix for location_id or location_name (e.g. Langkawi@location__location_name). |
| Output | JSON array of forecast objects: location (location_id, location_name), date, morning/afternoon/night_forecast, summary_forecast, summary_when, min_temp, max_temp (°C). Failure: 400 invalid query, 500 server error. |
| Workflow example | Execute getWeatherForecast with contains=Langkawi@location__location_name and limit=7 to display a week-long forecast in a travel app. |
Get Weather Warnings Retrieval
| Action | getWeatherWarnings |
|---|---|
| Purpose | Retrieves weather warnings issued by MET Malaysia (e.g. strong winds, rough seas), with details in English and Bahasa Melayu. |
| Configuration | Configure the base URL via CONNECTOR_ENV_MALAYSIAWEATHERAPI_BASE_URL. |
| Parameters | Optional: limit (integer, min 1). timestamp_start — filters warnings from a datetime (e.g. 1957-08-31T00:00:00@warning_issue__issued). |
| Output | JSON array of warning objects: warning_issue (issued, title_bm, title_en), valid_from/valid_to, heading_en/bm, text_en/bm, instruction_en/bm. Failure: 400/500. |
| Workflow example | Execute getWeatherWarnings with a timestamp_start filter and integrate into an emergency notification system. |
Get Earthquake Warnings Retrieval
| Action | getEarthquakeWarnings |
|---|---|
| Purpose | Retrieves earthquake warnings with location, magnitude, and depth — supporting disaster preparedness and monitoring. |
| Configuration | Configure the base URL via CONNECTOR_ENV_MALAYSIAWEATHERAPI_BASE_URL. |
| Parameters | Optional: limit (integer, min 1). |
| Output | JSON array of earthquake objects: utc/local datetime, lat, lon, depth (km), location, magnitude (magdefault), magtypedefault, status, visible, lat/lon vectors. Failure: 400/500. |
| Workflow example | Execute getEarthquakeWarnings with limit=5 to power a seismic-monitoring dashboard. |
Example Workflow: Weather & Disaster Monitoring
| Retrieve forecasts | Use getWeatherForecast with contains=Kuala Lumpur@location__location_name to display daily weather. |
|---|---|
| Monitor warnings | Execute getWeatherWarnings with timestamp_start to track recent warnings in a public safety alert system. |
| Track earthquakes | Use getEarthquakeWarnings to fetch recent data and visualize seismic activity on a dashboard. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.