Point API

Country, state, county, and timezone at a coordinate.

Give it a latitude and longitude to resolve the country, state, county and timezone at that point. Paid plans include terrain elevation and a compact nearest-city summary.

Out in the ocean, place fields come back null. Requested deep can still return terrain elevation. 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.

LookupCopy link

GET /point?lat={lat}&lon={lon}API Explorer ↗

Country, state, county and timezone for a point

Parameters

latnumber · query · required

Latitude

lonnumber · query · required

Longitude

formatstring · query · optional

Optional geojson returns a Feature: exact [longitude, latitude] geometry and the same selected facts in properties. Content-Type: application/geo+json. Omit for ordinary JSON.

Values: geojson

langstring · query · optional

Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.

Length: 2 to 64 characters

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.point(39.77, -104.9);
console.log(result);
Example responsePaid plan
{
  "latitude": 39.77,
  "longitude": -104.9,
  "county": "08031",
  "county_name": "Denver",
  "state": "CO",
  "state_name": "Colorado",
  "country": "US",
  "country_name": "United States",
  "timezone": "America/Denver",
  "elevation": 1610,
  "elevation_ft": 5282,
  "city": {
    "name": "Denver",
    "name_local": null,
    "type": "city",
    "state": "CO",
    "state_name": "Colorado",
    "country": "US",
    "country_name": "United States",
    "latitude": 39.76185,
    "longitude": -104.881105,
    "distance": 1.85,
    "distance_mi": 1.15,
    "id": "city_ccvrzq54e65m"
  },
  "electoral": {
    "code": "0801",
    "name": "Congressional District 1",
    "congress": 119
  }
}

Response fields

latitudeLink to latitudenumber
Input latitude
longitudeLink to longitudenumber
Input longitude
countyLink to countystring or null
County code (US county FIPS, FR INSEE department, GB GSS, null elsewhere)
county_nameLink to county_namestring or null
County or equivalent area name
stateLink to statestring or null
State / ADM1 code
state_nameLink to state_namestring or null
State / ADM1 name
countryLink to countrystring or null
ISO2 country code (null over open ocean)
country_nameLink to country_namestring or null
Country name
timezoneLink to timezonestring or null
IANA timezone containing the coordinate; a nautical zone over open ocean, or null when unresolved

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

Included dataCopy link

Paid plans automatically include elevation and a compact nearest city. Existing accounts retain their current profile access. Every plan includes the timezone.

Paid plan fields

cityLink to cityobject or null
Compact nearest-city identity and location, including distance and distance_mi; null when no city is within 200 km
electoralLink to electoralobject or null
Electoral area in the national lower-house or sole legislative chamber, with code, name and congress; null without a supported exact match
electoral.codeLink to electoral.codestring
Opaque code at the exact input coordinates, qualified by its country and current boundary edition. Preserve the exact string, including letters and leading zeros; it is not a globally unique or permanent identifier. Current coverage is US congressional districts for the 119th Congress: two-digit state FIPS plus two-digit district. Preserves leading zeros; 00 is at-large, 98 is a delegate district, and 99 is unsupported. The electoral object is null outside supported US boundaries, on a boundary, with multiple matches, or when data is unavailable. Separate from the administrative county
electoral.nameLink to electoral.namestring or null
Official electoral area name; null when a verified name is unavailable. Current US coverage returns the literal Census name for the 119th Congress. Separate from the administrative county_name
electoral.congressLink to electoral.congressnumber or null
US-only Congress number: 119 for current supported US electoral areas; null otherwise, including non-US national legislatures
elevationLink to elevationnumber or null
Elevation in meters (null if unavailable)
elevation_ftLink to elevation_ftnumber or null
Elevation in feet (null if unavailable)

In a mobile appCopy link

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 }

Display languageCopy link

Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Existing geographic display labels with a stable source identifier, including nested records. Country names are covered; other place names use separately sourced translations when available.

Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.

Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.

Content-Language identifies languages used in translated display fields and known English fallbacks. Display language is available on API 2.1.0; requests selecting frozen 1.0.0 retain their original contract. See API versions.

33 display language choices

Language tagLanguage
enEnglish
arالعربية
cacatalà
hrhrvatski
csčeština
dadansk
nlNederlands
fisuomi
frfrançais
deDeutsch
elΕλληνικά
heעברית
hiहिन्दी
humagyar
idIndonesia
ititaliano
ja日本語
ko한국어
msMelayu
nbnorsk bokmål
plpolski
ptportuguês
roromână
ruрусский
zh-Hans简体中文
skslovenčina
esespañol
svsvenska
thไทย
zh-Hant繁體中文
trTürkçe
ukукраїнська
viTiếng Việt