Geocode a US address
geocode_addressTurn a US street address into lat/lng plus the normalized address, using the US Census geocoder. The returned lat/lng can be passed to fetch_location, fetch_batch, proximity or parcel_enrich, which also accept the address directly and geocode it the same way. Output: lat, lng, normalized_address, accuracy (1 for a single match, lower when several candidates matched), accuracy_type and precision_note. Points are placed along the street from the house-number range, not on the rooftop, so they can be off on large rural lots. Cost: Free (0 lookups), up to 10,000 geocodes per key per day. Behavior: read-only (no side effects); needs an API key or OAuth; each call counts toward the per-minute request limit (Free 10, Starter 60, Pro 300). Works with an empty balance; each call queries the Census geocoder live with a 30 s timeout, and the 10,000 per day cap resets at 00:00 UTC. Errors: address_not_found when nothing matches, daily_cap_reached (resets 00:00 UTC), upstream_unavailable (retryable).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | US street address with house number, street, city and state (e.g. '350 5th Ave, New York, NY 10118'). PO boxes and a bare city or ZIP do not geocode. |