NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Geocodio connects to a Nagent workspace with an API key. Once it is connected, agents can call 7 Geocodio actions, such as "Get Sample Coordinates for Batch Reverse Geocode", "Batch Reverse Geocode" and "Delete Geocodio List". 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 Geocodio, with input parameters and output schema.
GEOCODIO_BATCH_REVERSE_GEOCODETool to batch reverse geocode up to 10,000 coordinates in one request. Use when you need addresses for many lat/lon pairs.
Input parameters
Max number of candidate results per input; 0 means no limit. Must be non-negative.
Comma-separated data-append codes to include (e.g., 'cd,stateleg').
List of 'latitude,longitude' strings. Latitude first. Up to 10,000 items.
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
GEOCODIO_DELETE_LISTPermanently deletes a Geocodio spreadsheet list by its ID. Use this to cancel a processing list job or remove a completed list. This action is destructive and cannot be undone. The list_id must be obtained from the lists API or from when the list was created.
Input parameters
The unique numeric ID of the Geocodio list to delete. Obtain this from the lists API (GET /lists) or from the response when creating a list.
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
GEOCODIO_GEOCODE_BATCHTool to batch geocode up to 10,000 addresses to coordinates in one request. Use when you need to convert multiple addresses to lat/lon coordinates. Optionally calculates distances to specified destinations for each geocoded result.
Input parameters
Maximum number of results to return per address; 0 means no limit. Must be non-negative.
Comma-separated list of data-append codes to include (e.g., 'cd,timezone').
List of address strings to geocode. Up to 10,000 addresses.
Array of destination locations for distance calculation. Each destination can be a coordinate string ('lat,lng' or 'lat,lng,id') or a geocodable address string.
Distance calculation mode. Defaults to 'driving'.
Unit of measurement for distance filtering. Defaults to 'miles'.
Field to sort destinations by. Defaults to 'distance'.
Sort order for destinations. Defaults to 'asc'.
Maximum number of destinations to return per geocoded result.
Maximum distance filter (in specified units).
Maximum duration filter in seconds (only applies to driving mode).
Minimum distance filter (in specified units).
Minimum duration filter in seconds (only applies to driving mode).
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
GEOCODIO_GEOCODE_GOOGLE_MAPS_COMPATIBLETool to geocode addresses using Google Maps-compatible API format. Use when you need a drop-in replacement for Google Maps Geocoding API for US and Canada addresses.
Input parameters
Your Geocodio API key
Latitude,longitude pair (for reverse geocoding). Required if address is not provided.
Address to geocode (for forward geocoding). Required if latlng is not provided.
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
GEOCODIO_GET_COORDINATES_FOR_BATCH_REVERSE_GEOCODEUtility tool that returns a predefined list of sample US coordinates (latitude,longitude strings). Use this to obtain ready-to-use coordinate inputs for the batch reverse geocode action. The coordinates cover well-known US landmarks across different cities and states.
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
GEOCODIO_SINGLE_GEOCODETool to forward geocode a single address. Use when you need coordinates and metadata for one address.
Input parameters
Full address string to geocode; required if components not used
City name
Maximum number of results; 0 means no limit
State or province code
County name
Comma-separated list of data appends to include (e.g. 'timezone,cd')
If 'simple', returns a flattened response schema
Street address component
Country context; USA or Canada
Secondary street address (unit etc)
Postal (ZIP) code
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
GEOCODIO_SINGLE_REVERSE_GEOCODETool to reverse geocode a single coordinate. Use when you need to convert one lat,lng to an address.
Input parameters
Latitude of the coordinate, between -90 and 90
Longitude of the coordinate, between -180 and 180
Maximum number of results to return; 0 means no limit (default no limit)
Comma-separated list of data append codes to include (e.g., 'stateleg,timezone')
Change output format; only valid value is 'simple' for a simplified response
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 7 Geocodio actions on Nagent, including "Get Sample Coordinates for Batch Reverse Geocode", "Batch Reverse Geocode" and "Delete Geocodio List". Get Sample Coordinates for Batch Reverse Geocode: Utility tool that returns a predefined list of sample US coordinates (latitude,longitude strings). Each action is listed on this page with its input parameters and its output.
Geocodio 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.
It returns data, error and successful.