Actions16
Overview
This node integrates with a map service API to provide walking route planning functionality. It calculates the optimal walking path between a specified origin and destination based on geographic coordinates (longitude and latitude). This is useful for applications that require pedestrian navigation, such as travel apps, delivery services, or urban planning tools.
Typical use cases include:
- Finding the best walking route from a user's current location to a point of interest.
- Planning pedestrian routes in city maps for tourism or commuting.
- Integrating walking directions into mobile or web applications.
Properties
| Name | Meaning |
|---|---|
| 出发点 (origin) | Starting point coordinates in "longitude,latitude" format, e.g., "117.500244,40.417801". Coordinates must have up to 6 decimal places. Required. |
| 目的地 (destination) | Destination point coordinates in "longitude,latitude" format, e.g., "117.500244,40.417801". Coordinates must have up to 6 decimal places. Required. |
| 起点POI ID (origin_id) | Optional POI ID for the starting point to improve route accuracy when the origin is a POI. |
| 目的地POI ID (destination_id) | Optional POI ID for the destination to improve route accuracy when the destination is a POI. |
| 返回结果详略 (extensions) | Not applicable for walking operation (only for bus and driving). |
Note: The properties origin and destination are mandatory and define the core input for the walking route calculation. The optional POI IDs help refine the routing if the points correspond to known places of interest.
Output
The node outputs JSON data containing the walking route details returned by the map API. This typically includes:
- Route geometry (path coordinates).
- Distance and estimated walking time.
- Step-by-step walking instructions.
- Additional metadata about the route.
No binary data output is involved.
Dependencies
- Requires an API key credential for the map service (referred generically as "an API key credential").
- The base URL for the API is configured via credentials.
- Network access to the map service endpoint is necessary.
Troubleshooting
- Invalid coordinate format: Ensure longitude and latitude are separated by a comma and have no more than 6 decimal places.
- Missing required parameters: Both origin and destination must be provided; otherwise, the request will fail.
- API authentication errors: Verify that the API key credential is correctly set up and has permissions for route planning.
- Rate limiting or quota exceeded: The map service may limit requests; monitor usage and upgrade plan if needed.
- Unexpected empty or incomplete route results: Check if the coordinates are valid and within supported regions.
Links and References
This summary focuses exclusively on the "路径规划" resource and the "步行路径规划" operation as requested.