APIs/Point

Point API

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

A GPS reading, a geotagged photo, or a pin dropped on a map only gives you a coordinate. /point turns that coordinate into a place: elevation, plus the country, state, and district it falls in, in one call instead of stitching /elevation and a reverse lookup together.

Out in the ocean, place fields come back null while elevation still returns. Lakes and rivers resolve normally, they belong to whatever country and state surround them. District codes cover US counties (FIPS), French departments (INSEE), and GB districts (GSS), each resolvable at /district/{code}.

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

Try it

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

// 200 · ~16ms · USA
{
  "latitude": 36.0726,
  "longitude": -79.792,
  "country": "US",
  "country_name": "United States",
  "state": "NC",
  "state_name": "North Carolina",
  "district": "37081",
  "district_name": "Guilford",
  "elevation": 253,
  "elevation_ft": 830,
  "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

SPEED

Fast from everywhere.

Median time for a core lookup to reach a real city, first byte back, measured live from 16 cities.

16ms

19ms

APAC

45ms

LatAm

20ms

127ms

See live status →

Create a free key Docs