apyhub
GEOLOCATION

Reverse Geocode US Coordinates API

What it does

Reverse Geocoding turns a latitude and longitude into a location lookup you can use in your app. Send lat and lon, and optionally set include_poi to include points of interest in the response.

Use Reverse Geocoding when you need to label map pins, show a user’s current area, or attach a human-readable place to a GPS event. It is a fit for mobile apps, fleet tracking dashboards, delivery workflows, and map-based analytics where coordinates alone are not enough.

The endpoint returns a JSON object containing the resolved location information. The response may include provider-specific location details and should be treated as structured location data rather than a fixed schema.

Keep your own coordinate checks close to the request: lat must be between -90 and 90, and lon between -180 and 180. That makes Reverse Geocoding useful as a lightweight backend step before storing, displaying, or enriching location records.

GET
Reverse geocode
https://api.eu.apyhub.com/dosvak/reverse-geocode

QUICKSTART

GUIDE

Quickstart

Returns a JSON object containing the resolved location information. The response may include provider-specific fields such as input coordinates, county information, geospatial metadata, and attribution details.

curl -X GET "https://api.eu.apyhub.com/dosvak/reverse-geocode?lat=34.0522&lon=-118.2437" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object. The schema does not declare any specific response fields, so the response shape may include provider-specific properties.

{
  "input": {
    "lat": 34.0522,
    "lon": -118.2437
  },
  "county": {
    "county_fips": "06037",
    "county_name": "Los Angeles County",
    "state_name": "California"
  },
  "geospatial_ready": false,
  "attribution": []
}
TRY ITLIVE · 10 ATOMS
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

Returns reverse-geocoding results for the provided latitude and longitude coordinates. The response contains structured location information and may include provider-specific fields.

Query Parameter(s)

AttributeTypeMandatoryDescription
latNumberYesLatitude. Must be between -90 and 90.
lonNumberYesLongitude. Must be between -180 and 180.
include_poiBooleanNoWhether to include points of interest. Default: false.

Response

Returns a JSON object containing the resolved location information. Since the provider may return additional location-specific fields, the response schema is intentionally flexible and should not be treated as a fixed field list.

Query parameters

Name
Type
Description
latREQUIRED
number
lonREQUIRED
number
include_poiOPTIONAL
boolean
DEFAULT false
▣ 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.