Fetch facts for one location
fetch_locationGet public-data facts (terrain, flood, wildfire, weather, soils, power grid, utilities, demographics and more) for one US location. The place is lat+lng or a street address; the facts are a preset, a list of field names, or both combined. Sibling tools: fetch_batch takes the same fields for many places in one call, proximity returns nearest features with distances, parcel_enrich returns the property record, and search_fields or list_presets find field names. Output: fields keyed by name, each with value, unit, status (ok; absent = no data at this point; failed = temporary source error), source and confidence, plus the resolved location and attributions. Cost: 1 lookup per started block of 50 delivered fields (a 135-field preset is 3); nothing when no field returns data. 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). Values cached within each field's refresh interval return at once; other places query live sources, waiting up to max_wait_s, and calls over 2 s count toward the slow-lookup limit (Free 5, Starter 20, Pro 60 per minute). Errors: invalid_locator (both or neither of lat+lng and address), coord_out_of_bounds (outside the US), no_fields_requested, preset_unknown (lists known presets), fields_unknown (lists the bad names), fields_too_many. Plan limits return rate_limited (with retry_after_s), daily_cap_reached or quota_exhausted.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | WGS84 latitude in decimal degrees (e.g. 30.2672), paired with lng. Give lat+lng or address, exactly one of the two. | |
| lng | No | WGS84 longitude in decimal degrees (e.g. -97.7431, negative in the US), paired with lat. | |
| detail | No | compact (default): value, unit, status, source and confidence per field. full: the complete record per field, adding license, attribution, vintage and notes. Same cost. | compact |
| fields | No | Exact, case-sensitive field names from list_presets or search_fields (e.g. ['nfhl_flood_zone', 'elevation']). Combined with preset when both are given; up to 50 names that are not already in the preset. Unknown names fail the whole call with fields_unknown. | |
| preset | No | Exact preset name from list_presets (e.g. 'flood_risk', 'terrain', 'solar_siting'). Its fields are added to fields; large presets cost more than 1 lookup (1 per 50 delivered fields). | |
| address | No | US street address with city and state (e.g. '350 5th Ave, New York, NY'), geocoded by the US Census geocoder along the street. An alternative to lat+lng; giving both is an invalid_locator error. | |
| max_wait_s | No | Seconds to wait for slow live sources before returning those fields as failed; default 10 s, capped at 15 s on Free and 30 s on paid plans. Optional. |