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, specifically for spatial relationships in this context. The "Calculate Relationship" operation under the "Spatial" resource calculates spatial relationships between two geographic points defined by their latitude and longitude coordinates.

This operation is useful when you want to understand how two locations relate to each other in terms of distance, direction, travel time, or a descriptive summary. Practical examples include:

  • Calculating the driving distance and estimated travel time between a user's current location and a destination.
  • Determining the cardinal direction from one point to another (e.g., north-east).
  • Generating a textual description of the relationship between two places for user-friendly display in apps or reports.

Properties

Name Meaning
Start Latitude Starting point latitude coordinate (required number).
Start Longitude Starting point longitude coordinate (required number).
End Latitude Ending point latitude coordinate (required number).
End Longitude Ending point longitude coordinate (required number).
Include Information to include in the response. Options: Distance, Direction, Travel Time, Description. Multiple can be selected.

Output

The output JSON contains the requested spatial relationship information between the start and end points. Depending on the "Include" property selection, the output may contain:

  • Distance: Numeric value representing the distance between the two points.
  • Direction: Textual representation of the direction from start to end (e.g., "northwest").
  • Travel Time: Estimated travel time between the points, likely in seconds or minutes.
  • Description: A human-readable description summarizing the relationship.

If binary data were involved (not indicated here), it would typically represent map images or route files, but this node focuses on JSON data describing spatial relationships.

Dependencies

  • Requires an API key credential for the Camino AI service.
  • Needs configuration of the base URL environment variable for the Camino API endpoint.
  • The node sends requests with JSON bodies containing the coordinates and requested fields.

Troubleshooting

  • Invalid Coordinates: Ensure latitude values are between -90 and 90, and longitude values between -180 and 180. Invalid inputs may cause errors or unexpected results.
  • Missing API Key or Incorrect Credentials: The node requires a valid API key credential; missing or invalid credentials will result in authentication errors.
  • Network Issues: Connectivity problems to the configured API endpoint will cause request failures.
  • Unsupported Include Options: Selecting no options or invalid options in the "Include" property might lead to empty or error responses.
  • Error Messages: Common errors may include HTTP 401 Unauthorized (check API key), 400 Bad Request (check input parameters), or 500 Internal Server Error (try again later).

Links and References

Discussion