Overview
The "Eskom" node for n8n provides integration with the Eskom API, specifically enabling users to find areas near a given GPS location. This is useful in scenarios where you need to identify nearby regions or service areas based on latitude and longitude coordinates—such as mapping, logistics, or energy service applications.
Practical examples:
- A delivery company wants to determine which Eskom service areas are closest to a customer's address.
- An energy monitoring dashboard displays nearby Eskom areas when a user shares their current GPS location.
Properties
| Name | Type | Meaning |
|---|---|---|
| Latitude | Number | The latitude coordinate of the location to search for nearby areas. |
| Longitude | Number | The longitude coordinate of the location to search for nearby areas. |
| Simplify | Boolean | If enabled, the output data will be simplified (e.g., less detailed geometry or results). |
Output
The node outputs a json field containing information about areas near the provided GPS coordinates. The structure typically includes:
- Area identifiers
- Names or descriptions of the areas
- Distance from the input coordinates
- (Optionally) simplified geometry or metadata if "Simplify" is enabled
Note: The exact fields depend on the Eskom API response, but expect each item in the output array to represent a nearby area with relevant details.
Dependencies
- External Service: Requires access to the Eskom API.
- API Key: You must provide valid Eskom API credentials via the
eskomApicredential in n8n. - n8n Configuration: Ensure the Eskom node is installed and configured with the correct credentials.
Troubleshooting
Common issues:
- Invalid Credentials: If the API key is missing or incorrect, authentication errors will occur. Double-check your
eskomApicredentials in n8n. - Missing Coordinates: Both Latitude and Longitude must be provided; otherwise, the node may throw validation errors or return empty results.
- API Limitations: If you exceed Eskom API rate limits, you may receive error messages about allowance or quota.
Error messages and resolutions:
"Authentication failed": Check and update your Eskom API credentials."Missing required parameter: lat/lon": Ensure both Latitude and Longitude are set in the node properties."API allowance exceeded": Wait before making more requests or check your Eskom account limits.