Actions2
- Address Actions
- Company Actions
Overview
This node integrates with the Data Gouv API to perform address-related searches. Specifically, for the "Address" resource and "Search Address" operation, it allows users to query addresses based on street names and other optional parameters. This is useful in scenarios where you need to validate, autocomplete, or find detailed information about addresses within France.
Practical examples include:
- Autocompleting user-entered addresses in a form.
- Validating postal codes and street names before processing orders.
- Retrieving multiple address suggestions based on partial input.
Properties
| Name | Meaning |
|---|---|
| Street | The street name or query string to search for. Required field. |
| Zip | Optional postal code to narrow down the search results. |
| Autocomplete | Boolean flag to enable or disable autocomplete behavior in the search. Defaults to true. |
| Limit | Maximum number of address results to return. Accepts values from 1 to 1000. Default is 10. |
Output
The node outputs an array of address objects in the json output field. Each object represents an address matching the search criteria, typically including details such as street, city, postal code, and possibly additional metadata returned by the Data Gouv API.
If binary data were involved (e.g., maps or images), it would be summarized here, but this node focuses on JSON address data only.
Dependencies
- Requires access to the Data Gouv API service.
- Needs an API key or authentication token configured in n8n credentials to authorize requests to the Data Gouv API.
- The node uses internal connectors (
ApiAddressConnector) to communicate with the API.
Troubleshooting
- Empty Results: If no addresses are returned, verify that the "Street" parameter is correctly specified and that the postal code (if used) matches the area.
- API Authentication Errors: Ensure that the API key or authentication token is valid and properly configured in n8n.
- Limit Parameter Issues: Setting the limit outside the allowed range (less than 1 or greater than 1000) may cause errors; keep it within the specified bounds.
- Network or Timeout Errors: Check network connectivity and API availability if requests fail or time out.