Geocode address
Use before weather or distance tools. Nominatim is free but requires a descriptive User-Agent contact email.
What this tool does
Customers describe locations in words: a street address, a neighbourhood or a postcode. Other tools, such as weather and distance, need coordinates. This tool turns an address into latitude and longitude using OpenStreetMap’s Nominatim service, so your agent can take the next step. Nominatim is free but asks every app to send a descriptive User-Agent with a contact email, and it has fair-use limits, so it suits normal chat volumes rather than bulk lookups.
Example conversation
Customer
Do you cover 14 Park Lane, Croydon?
Tool callgeocode_address
address: 14 Park Lane, Croydon
AI agent
Let me check where that is. That address is in South London, about 6 miles from our depot.
Customer
Great, can someone come tomorrow?
AI agent
Yes, we cover Croydon. I have a 10 AM or 2 PM slot tomorrow. Which works for you?
Example only. Tool calls are shown so you can see when the agent uses this template. Your agent’s wording depends on your prompt and business information.
Who uses it
- Plumbers, electricians and HVAC companies checking whether an address is in their service area.
- Real estate agents confirming where a property or viewing address is.
- Delivery and moving businesses preparing a distance or travel estimate.
Setup
- Open Create agent or Edit agent and add a custom tool.
- Copy the fields below and replace your-contact@example.com in the User-Agent header with a real contact email.
- Respect Nominatim usage policy (no heavy bulk geocoding). For production volume, consider a paid geocoder.
Copy into custom tool form
Copy each value into the matching field when you add a custom tool on the create or edit agent page. Replace any YOUR_… placeholders with your real credentials.
Tool name
Description
Endpoint URL
Paste into Endpoint URL (https:// is added automatically).
HTTP method
Tool inputs (all)
Tool input: address
Input name
Input type
Input description
Reference value
Use this as the request query or body value and choose “Tool input” in the form.
Request query (all)
Field name
Field value
Field name
Field value
Field name
Field value
Headers (all)
Header values are encrypted when stored. Replace placeholders with your real secrets.
Header name
Header value
