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 by interacting with a spatial data service. Specifically, the Get Place Context operation under the Spatial resource retrieves contextual information about a geographic location based on latitude and longitude coordinates. This can include details such as nearby places, environmental context, and optionally current weather conditions and forecasts.

This node is beneficial in scenarios where you want to enrich location data with additional context for applications like travel planning, local recommendations, environmental analysis, or augmented reality experiences. For example, a travel app could use this node to provide users with detailed information about their current location, including nearby points of interest and weather forecasts.

Properties

Name Meaning
Latitude The latitude coordinate of the location to query.
Longitude The longitude coordinate of the location to query.
Options Additional optional parameters to customize the query:
- Context Extra textual context to refine the place context query.
- Include Weather Boolean flag to include current weather and forecast data in the response.
- Radius Search radius around the given coordinates, in meters (default 500).
- Time Time parameter to specify when the context applies; supports point in time (e.g., "2020-01-01"), since (e.g., "2020.."), or range (e.g., "2020..2024").
- Weather Forecast Type Type of weather forecast to include if weather is requested; options are "Daily" or "Hourly".

Output

The node outputs JSON data containing the contextual information about the specified location. This includes:

  • Details about the place context derived from the latitude and longitude.
  • If requested, current weather conditions and forecast data according to the selected forecast type.
  • Other metadata related to the spatial environment within the specified radius and time frame.

If binary data were involved (e.g., images or maps), it would be summarized here, but this node focuses on JSON responses.

Dependencies

  • Requires an API key credential for authenticating requests to the Camino AI service.
  • The base URL for API requests is configured via credentials/environment variables.
  • The node sends HTTP requests with JSON payloads and expects JSON responses.

Troubleshooting

  • Missing or invalid API credentials: Ensure that a valid API key or authentication token is configured in the node credentials.
  • Invalid latitude or longitude values: Coordinates must be valid numbers within their respective ranges (-90 to 90 for latitude, -180 to 180 for longitude).
  • Incorrect time format: The time property must follow the expected formats ("YYYY-MM-DD", "YYYY..", or "YYYY..YYYY").
  • Network or API errors: Check connectivity and verify that the base URL and headers are correctly set.
  • Empty or unexpected responses: Verify that the location actually has contextual data available and that optional parameters like radius and context are appropriate.

Links and References

Discussion