Camino AI

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

Actions6

Overview

The node "Camino AI" provides location intelligence capabilities, allowing users to guide AI agents through real-world spatial data. Specifically, the Plan Journey operation under the Spatial resource enables users to create a journey plan by specifying multiple waypoints and constraints such as time budget, transport mode, and preferences. This operation is useful for applications like route planning, travel itinerary creation, or logistics optimization where multiple stops and user preferences need to be considered.

Practical examples:

  • Planning a walking tour with specific points of interest.
  • Creating a delivery route with time constraints.
  • Generating a customized journey based on user preferences like scenic routes or avoiding highways.

Properties

Name Meaning
Waypoints A collection of waypoints for the journey. Each waypoint requires:
- Latitude: The latitude coordinate of the waypoint.
- Longitude: The longitude coordinate of the waypoint.
- Purpose: The reason or description for this waypoint.
Options Additional constraints and preferences for the journey:
- Time Budget A string representing the maximum allowed time for the journey.
- Transport Mode The mode of transport to use (e.g., walking, driving).
- Preferences A comma-separated list of preferences that influence the journey planning (e.g., avoid tolls, prefer scenic routes). These are split into an array internally.

Output

The node outputs JSON data representing the planned journey. This typically includes details such as the ordered list of waypoints, estimated times, distances, and possibly routing information depending on the underlying API response.

If binary data is output (not indicated in the provided code), it would likely represent map images or route files, but no explicit binary output handling is shown here.

Dependencies

  • Requires an API key credential for the Camino AI service.
  • The base URL for API requests is configured via credentials/environment variables.
  • The node sends requests with JSON payloads containing waypoints and constraints.

Troubleshooting

  • Missing or invalid API key: Ensure the API key credential is correctly configured and valid.
  • Invalid waypoint coordinates: Latitude must be between -90 and 90; longitude between -180 and 180.
  • Empty waypoints list: At least one waypoint must be provided.
  • Incorrect format for preferences: Preferences should be a comma-separated string; improper formatting may cause errors.
  • Time budget format issues: Ensure the time budget string matches expected formats (e.g., "2h", "30m").
  • Network or API errors: Check connectivity and API service status.

Links and References

Discussion