Actions2
Overview
This node integrates with the Yahoo! Maps for Developers API, specifically providing geocoding functionality. The "Geocode" operation allows users to input an address string and receive detailed location information including latitude and longitude coordinates. This is useful in scenarios such as mapping addresses on a map, validating user-entered locations, or enriching datasets with geographic coordinates.
Practical examples include:
- Converting customer shipping addresses into coordinates for delivery route optimization.
- Displaying store locations on a map based on their addresses.
- Filtering data points by geographic proximity using the returned coordinates.
Properties
| Name | Meaning |
|---|---|
| Geocode Query | The address string to be geocoded (e.g., "東京都港区六本木"). |
| Address Level | The detail level of the address to consider: Prefecture Level, Municipality Level, Town or District Level, Block or Subdistrict Level. |
| Address Range | The search scope relative to the address level: Greater Equal, Less Equal, or Equal. |
| Results | Number of geocoding results to return (integer). |
Output
The node outputs JSON data containing location information corresponding to the input address query. The output includes details such as latitude and longitude coordinates and possibly other address components depending on the API response.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for Yahoo! Maps for Developers.
- The node makes HTTP GET requests to the Yahoo! Maps API endpoint
https://map.yahooapis.jp/geocode/V1/geoCoder. - Proper configuration of the API key credential within n8n is necessary for authentication.
Troubleshooting
Common Issues:
- Invalid or missing API key will cause authentication errors.
- Incorrectly formatted address queries may return no results.
- Exceeding API rate limits can result in request failures.
Error Messages:
- Authentication errors typically indicate issues with the provided API key; verify that the key is valid and correctly configured.
- Empty or zero results suggest the address query might be too vague or incorrect; try refining the address or adjusting the address level and range parameters.
- Network or timeout errors may require checking internet connectivity or retrying later.