Camino AI

Guide your AI agents through the real world with location intelligence
Join our community

Actions6

Overview

The node provides routing functionality by calculating a route between two geographic points defined by their latitude and longitude coordinates. It supports different modes of transportation such as car, bike, or foot, and optionally includes detailed route geometry useful for mapping applications.

This node is beneficial in scenarios where you need to generate directions or travel paths between locations, for example:

  • A delivery service calculating the best driving route from a warehouse to a customer.
  • A fitness app plotting a biking or walking route.
  • A travel planner providing step-by-step navigation instructions.

Properties

Name Meaning
Start Latitude The latitude coordinate of the starting point of the route (required).
Start Longitude The longitude coordinate of the starting point of the route (required).
End Latitude The latitude coordinate of the destination point of the route (required).
End Longitude The longitude coordinate of the destination point of the route (required).
Mode Mode of transport to use for routing. Options: Car, Bike, Foot. Default is Car.
Include Geometry Boolean flag indicating whether to include detailed route geometry data for mapping.

Output

The node outputs JSON data representing the calculated route between the specified start and end points. This typically includes information such as distance, duration, and optionally detailed geometry describing the path taken.

If the "Include Geometry" option is enabled, the output will contain detailed route shape data suitable for rendering on maps.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for accessing the Camino AI routing service.
  • The base URL for API requests is configured via the node's credentials/environment settings.
  • The node sends HTTP requests with JSON content type and expects JSON responses.

Troubleshooting

  • Missing or invalid coordinates: Ensure that all four coordinates (startLat, startLon, endLat, endLon) are provided and valid numbers.
  • API authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
  • Invalid mode value: Use only the supported transport modes: car, bike, or foot.
  • Network or service errors: Check network connectivity and the availability of the external routing service.
  • Empty or incomplete route data: If "Include Geometry" is enabled but no geometry is returned, verify that the route between points is possible with the selected mode.

Links and References

  • Camino AI Documentation (hypothetical link for reference)
  • General concepts of routing APIs and geo-coordinates handling can be found on platforms like Mapbox, Google Maps API documentation.

Discussion