Tools / Geocoder
GET Powered by Farun Search API

Geocoder

Search any address, landmark, or POI — get back coordinates, match type, confidence score, and the full structured response the API returns.

Search

Options

Quick examples

Search a place to see results on the map

How it works

From a name to coordinates — in a single request.

Geocoding converts human-readable place names, addresses, and POI queries into precise coordinates. The confidence score tells you how certain the match is — essential for production use where ambiguous queries need to be handled gracefully.

01

Type a query

Enter any address, landmark, business name, or area. Use the region bias to prioritise results from a specific country.

02

Inspect results

Each result shows the matched name, coordinates, confidence score, and match type. Click any result to see the full API response.

03

Copy and use

Copy coordinates directly to clipboard or copy the full JSON response. The curl snippet shows the exact API call you'd make in production.

Response fields

What the API returns.

Every geocoding result includes enough structured metadata to drive UI display, route planning, and validation logic — without additional lookups.

lon, lat

WGS84 coordinates for the matched feature. Pass directly to routing, isochrone, or map pin APIs.

confidence

0.0–1.0 match confidence. Use this to decide whether to auto-accept a result or ask the user to confirm.

match_type

What was matched: address, poi, postcode, region, or country. Use to validate that the result type is appropriate for your use case.

name

Display name of the matched place. Use this in your UI — not the raw query string.

address

Structured address components: street, city, state, country, postcode. Use for display or address normalisation.

bbox

Bounding box for the matched feature. Use to fit the map view to the result rather than zooming to a single point.

Integrate the API

Add place search to your product.

The Farun Search API returns the same structured response this tool displays. Free tier includes 1,000 requests/month — no credit card required.