▣ GEOLOCATION

US County Lookup by Coordinates API

What it does

US County Lookup by Coordinates converts latitude and longitude into the corresponding U.S. county and returns county-related information.. Send lat and lon as query parameters, and it returns a JSON response with enrichment data for that point.

Use Coordinate Enrichment when you already have geographic coordinates and need more context for them in your workflow. It fits mapping products, analytics pipelines, and location-aware features that need to attach additional information to a point without building your own lookup layer.

The service is intentionally simple at the request level: it accepts only lat and lon, both numeric values within standard coordinate ranges. The response schema is open-ended, so you should treat the returned JSON as structured enrichment data rather than a fixed set of fields.

If your application stores locations as coordinates but needs to display, segment, or route based on richer place context, Coordinate Enrichment gives you a direct lookup step you can plug into that flow.

GET

Coordinate enrichment

http://localhost:8080/dosvak/coordinate-enrichment

QUICKSTART

GUIDE

Quickstart

Look up enrichment data for a latitude/longitude pair using query parameters.

curl -X GET "http://localhost:8080/dosvak/coordinate-enrichment?lat=34.0522&lon=-118.2437" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing the input coordinates, county information, demographic statistics, and attribution details.

{
  "input": {
    "lat": 34.0522,
    "lon": -118.2437
  },
  "enrichment": {
    "county_fips": "06037",
    "county_name": "Los Angeles County",
    "state_name": "California",
    "population": 9757179,
    "median_household_income": "80794",
    "poverty_rate": "13.1",
    "unemployment_rate": "5.4"
  },
  "attribution": []
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Enriches a pair of geographic coordinates by looking up additional information for the provided latitude and longitude values. The input is read from query parameters and the success response schema is not yet defined beyond returning a JSON object.

Query Parameter(s)

Attribute	Type	Mandatory	Description
lat	Number	Yes	Latitude. Minimum `-90`, maximum `90`.
lon	Number	Yes	Longitude. Minimum `-180`, maximum `180`.

Response

The response includes the input coordinates, county information, demographic statistics, and attribution details.

Query parameters

Name

Type

Description

latREQUIRED

number

—

lonREQUIRED

number

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.