Point API

Everything at a latitude/longitude: elevation, country, state, district.

Give it a latitude and longitude, get back everything: elevation, and the country, state, and district that contain that point. One call instead of stitching /elevation and a reverse lookup together.

Out in the ocean, place fields come back null and elevation still returns. Lakes and rivers are not a special case, they belong to whatever country and state surround them. Only need elevation? /elevation stays the focused tool.

Lookup

GET

api.parseapi.com/point?lat={lat}&lon={lon}

Elevation, country, state, and district for a point

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

{
  "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

Got a district code back? Resolve it at /district/{code}.

Deep

?deep=true adds the nearest city and the timezone at this point. Free on every plan.

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

{
  "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,
  "deep": {
    "city": {
      "name": "Denver",
      "local_name": null,
      "state": "CO",
      "state_name": "Colorado",
      "country": "US",
      "latitude": 39.76185,
      "longitude": -104.881105,
      "elevation": 1597,
      "elevation_ft": 5240,
      "population": 729019,
      "timezone": "America/Denver",
      "distance": 1.85,
      "distance_mi": 1.15,
      "id": "city_ccvrzq54e65m"
    },
    "timezone": {
      "timezone": "America/Denver",
      "name": "Mountain Time",
      "abbreviation": "MDT",
      "offset": "-06:00",
      "offset_minutes": -360,
      "dst": true,
      "next_dst": {
        "at": "2026-11-01T08:00:00.000Z",
        "dst": false,
        "offset": "-07:00",
        "abbreviation": "MST"
      }
    }
  }
}

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

In a mobile app

Ship an app key and the Swift or Kotlin SDK. They send your bundle ID as X-App-Id. Coordinates from the device, place and elevation back.

import ParseAPI

let parse = try ParseAPI("parse_app_...")
let point = try await parse.point(lat, lon, deep: true)

import com.parseapi.ParseAPI

val parse = ParseAPI("parse_app_...", appId = BuildConfig.APPLICATION_ID)
val point = parse.point(lat, lon, deep = true)

Questions? Email