Camino AI

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

Actions6

Overview

The node "Camino AI" provides advanced location intelligence capabilities by querying points of interest (POI) using natural language or specific OpenStreetMap (OSM) element IDs. It is designed to help users find places, landmarks, or other geographic features based on flexible search criteria.

Typical use cases include:

  • Finding nearby amenities such as "coffee shops near me" by specifying a location and radius.
  • Retrieving detailed information about specific OSM elements by their IDs.
  • Generating ranked and paginated results with optional human-readable summaries.
  • Filtering results by time ranges or limiting the number of returned items.

This node is beneficial for applications involving geospatial data enrichment, location-based recommendations, travel planning, or integrating AI-driven geographic queries into workflows.

Properties

Name Meaning
Query Type Type of query to perform. Options:
• Natural Language Query — Query using natural language (e.g., "coffee near me").
• OSM IDs — Query specific OSM elements by their IDs.
Query (Required if Query Type is Natural Language) The natural language search string describing what to find, e.g., "coffee near me".
Latitude (For Natural Language queries) Latitude coordinate for the center point of the search area.
Longitude (For Natural Language queries) Longitude coordinate for the center point of the search area.
Radius (For Natural Language queries) Search radius in meters around the specified latitude and longitude.
OSM IDs (Required if Query Type is OSM IDs) Comma-separated list of OSM element IDs to query, e.g., "node/123,way/456" or just numeric IDs like "123456789".
Options Additional options to customize the query:
• Generate Answer (boolean): Whether to generate a human-readable answer summary.
• Limit (number): Max number of results to return.
• Offset (number): Pagination offset.
• Rank Results (boolean): Use AI to rank results by relevance.
• Time (string): Time filter parameter supporting formats like "2020-01-01" (specific date), "2020.." (since date), or "2020..2024" (date range).

Output

The node outputs JSON data containing the results of the POI query. The structure typically includes an array of matched points of interest with details such as names, locations, types, and metadata depending on the query parameters.

If the "Generate Answer" option is enabled, the output will also contain a human-readable summary answering the query.

No binary data output is indicated by the source code or properties.

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's credentials.
  • Invalid query parameters: For natural language queries, latitude and longitude must be valid numbers; for OSM ID queries, ensure IDs are correctly formatted and separated by commas.
  • Empty or no results: Adjust the radius, limit, or query terms to broaden the search. Check if the queried OSM IDs exist.
  • Pagination issues: When using offset and limit, verify that offset is not beyond the total number of available results.
  • Time filter format errors: Use correct date formats as described ("YYYY-MM-DD", "YYYY..", or "YYYY..YYYY").
  • API errors or rate limits: Monitor API usage and handle error messages returned from the Camino AI service accordingly.

Links and References

Discussion