Describe a place in words; get its address and coordinates

GET/v1/resolve

A language model proposes the most likely US street address for the description and the index verifies it.
resolved.confidence is the model's own probability that the address is the place you described; resolved.verified
says whether the proposed house number exists in the index. results are ordinary geocode results for that address
with the usual accuracy_type. Slower than /v1/geocode (one model call, about a second) and metered at more than
one unit; repeat descriptions are answered from a cache. Results may be stored indefinitely.

PARAMETERS

qquery · string: A description of a place, e.g. 'Chiefs Stadium' or 'the Amtrak station in Wilmington DE'
fieldsquery · string: Comma-separated appends: census, cd, stateleg, school, timezone, or all
limitquery · integer: How many candidates to return, best first
e.g. 1

In the full reference

REQUEST

curl "https://api.geocode.net/v1/resolve" \
  -H "X-API-Key: YOUR_KEY"

import requests

r = requests.get("https://api.geocode.net/v1/resolve", headers={"X-API-Key": "YOUR_KEY"})
print(r.status_code, r.headers.get("X-Gw-Remaining"))
print(r.json())

const r = await fetch("https://api.geocode.net/v1/resolve", {
  headers: { "X-API-Key": "YOUR_KEY" }
});
console.log(r.status, r.headers.get("X-Gw-Remaining"));
console.log(await r.json());

RESPONSE

200Successful Response

{
  "query": "the Amtrak station in Wilmington DE",
  "resolved": {
    "place_name": "Joseph R. Biden Jr. Railroad Station",
    "address": "100 S French St, Wilmington, DE 19801",
    "confidence": 0.88,
    "verified": true,
    "source": "model",
    "model": "claude-opus-5-5",
    "cached": false
  },
  "results": [
    {
      "formatted": "100 S French ST, Wilmington, DE 19801",
      "components": {
        "number": "100",
        "predirectional": "S",
        "street": "French",
        "suffix": "ST",
        "city": "Wilmington",
        "county": "New Castle",
        "state": "DE",
        "zip": "19801",
        "country": "US"
      },
      "location": {
        "lat": 39.7367,
        "lng": -75.550995
      },
      "accuracy": 0.9,
      "accuracy_type": "rooftop",
      "source": "nad"
    }
  ]
}

Try it — sign in first