NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Placekey connects to a Nagent workspace with an API key. Once it is connected, agents can call 4 Placekey actions, such as "Get Geocode From Address", "Get Placekey" and "Get placekey from address". 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 Placekey, with input parameters and output schema.
PLACEKEY_GET_GEOCODE_FROM_ADDRESSThis tool retrieves geocode information (latitude and longitude) for a given address using the Placekey API. It accepts address components (street_address, city, region, postal_code, iso_country_code) and returns geocode data including the unique Placekey identifier and location details.
Input parameters
City name
State/region code
Postal/ZIP code
Street address of the location
Two-letter country 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
PLACEKEY_GET_PLACEKEYTool to get a Placekey for a single location using address, coordinates, or POI details. Use when you need to obtain a unique identifier for a physical place with support for address fields, coordinates, location name, and optional metadata for enhanced matching.
Input parameters
The city where the place is located
The second-level administrative region (e.g., state in US)
Options to customize the response and matching behavior
The latitude of the place in WGS-84 coordinates
Custom identifier for this query. Will be echoed back in the response.
The longitude of the place in WGS-84 coordinates
The postal code for the place
The name of the place or business (POI name) for better matching
Additional metadata about the place to improve matching accuracy
The street address of the place
The ISO 2-letter country code (e.g., US, CA, GB)
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
PLACEKEY_GET_PLACEKEY_FROM_ADDRESSConvert a physical address into a unique Placekey identifier. The Placekey is a universal standard identifier for any physical place that helps in location matching, enrichment, and deduplication.
Input parameters
The city name
The state/region code (e.g., 'CA' for California)
The postal/ZIP code
Name of the location/business if available
The street address of the location
The two-letter ISO country code (e.g., 'US' for United 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
PLACEKEY_GET_PLACEKEYS_BULKGet Placekeys for multiple locations in bulk (up to 100 queries per request). All queries must have the same iso_country_code. Supports address, coordinates, and POI queries with optional query_id for tracking. Returns an array of Placekey results for each query.
Input parameters
Options to customize the Placekey response
Array of location queries. Maximum 100 queries per request. All queries must have the same iso_country_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
Agents can call 4 Placekey actions on Nagent, including "Get Geocode From Address", "Get Placekey" and "Get placekey from address". Get Geocode From Address: This tool retrieves geocode information (latitude and longitude) for a given address using the Placekey API. Each action is listed on this page with its input parameters and its output.
Placekey 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.
Get Geocode From Address takes 5 required inputs: city, region, postal_code, street_address and iso_country_code. It returns data, error and successful.