Back to all tools
Free / no key

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

  1. Open Create agent or Edit agent and add a custom tool.
  2. Copy the fields below and replace your-contact@example.com in the User-Agent header with a real contact email.
  3. 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

geocode_address

Description

Convert a street address or place name into latitude and longitude using OpenStreetMap Nominatim. Use before weather or distance tools when you only have an address.

Endpoint URL

Paste into Endpoint URL (https:// is added automatically).

nominatim.openstreetmap.org/search

HTTP method

GET

Tool inputs (all)

1. address (string) Full address or place name to geocode

Tool input: address

Input name

address

Input type

string

Input description

Full address or place name to geocode

Reference value

Use this as the request query or body value and choose “Tool input” in the form.

{{address}}

Request query (all)

q: {{address}} format: json limit: 1

Field name

q

Field value

{{address}}

Field name

format

Field value

json

Field name

limit

Field value

1

Headers (all)

Header values are encrypted when stored. Replace placeholders with your real secrets.

User-Agent: CXWizard-Agent/1.0 (your-contact@example.com)

Header name

User-Agent

Header value

CXWizard-Agent/1.0 (your-contact@example.com)