GET /point?lat={lat}&lon={lon}

Point API

Pass a coordinate. Get elevation plus the place it falls in.

Try it

country

ISO2 country code (null over open ocean)

state

State / ADM1 code

district

District code (US county FIPS, FR INSEE department, GB GSS, null elsewhere)

elevation

Elevation in meters (null if unavailable)

deep.city

Nearest city (same shape as /city?lat=&lon=, includes distance and distance_mi). Null when no city is within 200 km

deep.timezone

IANA timezone at this point (same shape as /timezone). Nautical Etc/GMT zone over open ocean

1

Pass lat and lon

A GPS reading, a photo, a pin on a map.

2

Get the admin

Country, state, district, plus elevation.

3

Resolve the district

FIPS, INSEE, or GSS on the district path.

One coordinate.

Elevation and the place. Every plan.

250
countries & territories resolved
5,308
states & provinces
3,680
districts resolved
30m
elevation resolution

A GPS reading, a geotagged photo, or a pin dropped on a map only gives you a coordinate. /point turns that into elevation plus the country, state, and district it falls in, in one call. Admin layers come from official boundaries.

Lakes and rivers resolve to the country and state around them. District codes cover US counties (FIPS), French departments (INSEE), and GB districts (GSS), each resolvable at /district/{code}.

RESPONSE

$ curl "https://api.parseapi.com/point?lat=39.77&lon=-104.9" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~34ms US · ~101ms worldwide
{
  "latitude": 39.77,
  "longitude": -104.9,
  "country": "US",
  "country_name": "United States",
  "state": "CO",
  "state_name": "Colorado",
  "district": "08031",
  "district_name": "Denver",
  "elevation": 1610,
  "elevation_ft": 5282,
  "resolution": 30
}

Response fields

latitude
Input latitude
longitude
Input longitude
country
ISO2 country code (null over open ocean)
country_name
Country name
state
State / ADM1 code
state_name
State / ADM1 name
district
District code (US county FIPS, FR INSEE department, GB GSS, null elsewhere)
district_name
District / ADM2 name
elevation
Elevation in meters (null if unavailable)
elevation_ft
Elevation in feet (null if unavailable)
resolution
Approx elevation grid spacing in meters

Deep fields

deep.city
Nearest city (same shape as /city?lat=&lon=, includes distance and distance_mi). Null when no city is within 200 km
deep.timezone
IANA timezone at this point (same shape as /timezone). Nautical Etc/GMT zone over open ocean

QUESTIONS

What do I pass?
Latitude and longitude. A GPS reading, a geotagged photo, a pin on a map.
What comes back?
Country, state, district, and elevation for any coordinate.
Does elevation come back?
Yes. Same 30m grid as /elevation. Meters and feet. Ocean comes back negative, below sea level.
How is this different from /elevation?
/point is the hub. Place plus elevation. /elevation is the grid alone.
How do I resolve the district?
FIPS, INSEE, or GSS on the district path.
What does deep add?
Nearest city, and the timezone at this point.

SPEED

How long /point takes.

US

18ms

EU

28ms

APAC

39ms

LatAm

16ms

ME

94ms

See live status →

Coverage

Country and elevation, worldwide. Same 30m grid as /elevation.

  • elevationElevationPole to pole. Ocean comes back negative.
  • countryCountry250 countries and territories. Null over open ocean.
  • stateStateAdmin divisions in 229 countries.
  • districtDistrictUS, France, and Great Britain.

See what time zone you are in, or what county you are in.

Get startedDocs