Geokeo connects to a Nagent workspace with an API key. Once it is connected, agents can call 2 Geokeo actions: "Forward Geocoding" and "Reverse Geocoding Lookup". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Geokeo, with input parameters and output schema.
GEOKEO_FORWARD_GEOCODINGConvert an address or place name into geographic coordinates (latitude/longitude). Use this tool when you need to: - Find coordinates for a landmark (e.g., "Eiffel Tower", "Empire State Building") - Geocode a street address (e.g., "1600 Pennsylvania Avenue NW Washington DC") - Get location data for a city or region - Look up structured address information for a place Returns multiple results ranked by relevance, with coordinates, addresses, and OpenStreetMap links.
Input parameters
Address or place name to geocode. Can be a landmark, street address, city, or any location query. Maximum 50 characters.
Two-letter ISO 3166-1 alpha-2 country code to restrict search results to a specific country. For example: 'us' for United States, 'fr' for France.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GEOKEO_REVERSE_GEOCODINGConvert geographic coordinates (latitude/longitude) to a human-readable address. Use this tool when you have GPS coordinates and need to find the corresponding street address, city, country, or nearby points of interest. Returns multiple results sorted by distance from the input coordinates, including structured address components and OpenStreetMap links. Note: Returns status='ZERO_RESULTS' for coordinates in oceans or remote areas without mapped addresses.
Input parameters
API key for authentication; uses metadata if not provided
Latitude to reverse geocode, must be between -90 and 90
Longitude to reverse geocode, must be between -180 and 180
Response format, either 'json' or 'xml'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 2 Geokeo actions on Nagent: "Forward Geocoding" and "Reverse Geocoding Lookup". Forward Geocoding: Convert an address or place name into geographic coordinates (latitude/longitude). Each action is listed on this page with its input parameters and its output.
Geokeo connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Forward Geocoding takes 1 required input: q. It also takes 1 optional input: country. It returns data, error and successful.