Malaysia Weather Connector

info@ismena.com

Connector Details

Type

Virtual machines, Single VM , BYOL

Runs on

Google Compute Engine

Last Update

24 October, 2024

Category

Overview

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 weather forecasts, weather warnings, and earthquake warnings. This connector acts as a proxy to streamline data retrieval, supporting actions for querying forecasts and warnings in JSON format, with filtering capabilities for locations and time periods.

Integration Overview

This document provides a detailed guide for each integration point, its purpose, configuration, and workflow support using the Malaysia Weather API Connector.
Supported Integration Action Points

getEarthquakeWarnings: Retrieve earthquake warnings with location and magnitude details.

Detailed Integration Documentation

2.1 Get Weather Forecast Retrieval

Action	getWeatherForecast
Purpose	Retrieves a 7-day weather forecast for various locations in Malaysia, including morning, afternoon, and night forecasts, temperature ranges, and summaries. This supports weather-aware planning and application development.
Configuration	Ensure the connector is configured with the base URL via the `CONNECTOR_ENV_MALAYSIAWEATHERAPI_BASE_URL` environment variable.
Parameters	Required: None Optional: limit: Limits the number of forecast entries (integer, minimum: 1). contains: Filters by prefix for `location_id` or `location_name` (string, e.g., `Langkawi@location__location_name`).
Output	JSON array of forecast objects with: location: Object with `location_id` (e.g., Ds001) and `location_name` (e.g., Langkawi). date: Forecast date (string, e.g., 1957-08-31). morning_forecast, afternoon_forecast, night_forecast: Weather conditions (string, e.g., Hujan di satu dua tempat). summary_forecast: Day’s summary (string, e.g., Ribut petir di satu dua tempat). summary_when: Timing of summary (string, e.g., Petang). min_temp, max_temp: Temperature range in Celsius (integer, e.g., 26, 32). Failure: Returns error details (e.g., 400: Invalid query parameters, 500: Server error).
Workflow Example	Configure the connector with the appropriate base URL. Execute the `getWeatherForecast` action with `contains=Langkawi@location__location_name` and `limit=7`. Process the response to display a week-long forecast for a travel app.

2.2 Get Weather Warnings Retrieval

Action	getWeatherWarnings
Purpose	Retrieves weather warnings issued by MET Malaysia, such as strong winds or rough seas, with details in English and Bahasa Melayu. Supports safety alerts and emergency planning.
Configuration	Ensure the connector is configured with the base URL via the `CONNECTOR_ENV_MALAYSIAWEATHERAPI_BASE_URL` environment variable.
Parameters	Required: None Optional: limit: Limits the number of warning entries (integer, minimum: 1). timestamp_start: Filters warnings from a specific datetime (string, e.g., 1957-08-31T00:00:00@warning_issue__issued).
Output	JSON array of warning objects with: warning_issue: Object with `issued`, `title_bm`, `title_en` (e.g., Amaran Angin Kencang Kategori Pertama). valid_from, valid_to: Validity period (date-time). heading_en, heading_bm: Warning headings. text_en, text_bm: Detailed warning text. instruction_en, instruction_bm: Safety instructions. Failure: Returns error details (e.g., 400: Invalid query parameters, 500: Server error).
Workflow Example	Execute the `getWeatherWarnings` action with `timestamp_start=2023-10-01T00:00:00@warning_issue__issued`. Review warnings for display in a safety dashboard. Integrate into emergency notification systems.

2.3 Get Earthquake Warnings Retrieval

Action	getEarthquakeWarnings
Purpose	Retrieves earthquake warnings with details like location, magnitude, and depth, supporting disaster preparedness and monitoring.
Configuration	Ensure the connector is configured with the base URL via the `CONNECTOR_ENV_MALAYSIAWEATHERAPI_BASE_URL` environment variable.
Parameters	Required: None Optional: limit: Limits the number of earthquake warning entries (integer, minimum: 1).
Output	JSON array of earthquake objects with: utcdatetime, localdatetime: Earthquake time. lat, lon: Coordinates. depth: Depth in kilometers. location, location_original: Location description in Bahasa Melayu and English. n_distancemas, nbm_distancemas: Distance from Malaysia. n_distancerest, nbm_distancerest: Distance from other locations. magdefault: Magnitude. magtypedefault: Magnitude type. status: Status. visible: Visibility (boolean). lat_vector, lon_vector: Vector representation. Failure: Returns error details (e.g., 400: Invalid query parameters, 500: Server error).
Workflow Example	Execute the `getEarthquakeWarnings` action with `limit=5`. Process earthquake data for a monitoring system. Use for disaster response planning.

Workflow Creation with the Connector

Example Workflow: Weather and Disaster Monitoring System

Retrieve Weather Forecasts	Use the `getWeatherForecast` action with `contains=Kuala Lumpur@location__location_name` to fetch forecasts. Display daily weather for urban planning or travel apps.
Monitor Weather Warnings	Execute the `getWeatherWarnings` action with `timestamp_start` to track recent warnings. Integrate into a public safety alert system.
Track Earthquake Warnings	Use the `getEarthquakeWarnings` action to fetch recent earthquake data. Visualize seismic activity on a GCP-hosted dashboard for disaster preparedness.

This workflow enables applications to provide users with comprehensive weather and seismic data, enhancing safety, planning, and decision-making in Malaysia’s dynamic climate and geological context.

Pricing

bill-and-calculator-2023-11-27-05-25-06-utc 1

Request a Quote

Support

For Technical support please contact us on

custom-connectors-support@isolutions.sa

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

Register to Wired for Banking