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
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.point(39.77, -104.9);
console.log(result);{
"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 tag | Language |
|---|---|
| en | English |
| ar | العربية |
| ca | català |
| hr | hrvatski |
| cs | čeština |
| da | dansk |
| nl | Nederlands |
| fi | suomi |
| fr | français |
| de | Deutsch |
| el | Ελληνικά |
| he | עברית |
| hi | हिन्दी |
| hu | magyar |
| id | Indonesia |
| it | italiano |
| ja | 日本語 |
| ko | 한국어 |
| ms | Melayu |
| nb | norsk bokmål |
| pl | polski |
| pt | português |
| ro | română |
| ru | русский |
| zh-Hans | 简体中文 |
| sk | slovenčina |
| es | español |
| sv | svenska |
| th | ไทย |
| zh-Hant | 繁體中文 |
| tr | Türkçe |
| uk | українська |
| vi | Tiếng Việt |