Skip to main content

Heimdall Point

Convert your coordinates into structured, tabular datasets ready for modeling.

API Specifications​

Endpoint​

POST https://point.heimdallapp.org/point/v1/api/process

Request Headers​

  • x-api-key - API key that is issued when the endpoint is configured.
  • x-username - Username associated with your account.
tip

All request headers are required.

Lost Key

API keys are issued one time and cannot be retrieved. If you lose your API key, please disable the endpoint on the Heimdall Point page and reconfigure to get a new API key.

Request Body​

  • lat - the latitude of the coordinate
  • lng - the longitude of the coordinate
warning

Both latitude and longitude are required and should be entered as numbers, without quotes.

Response Object​

  • timezone - The timezone the coordinate is located in
  • country - The country the coordinate is located in
  • country_code - The shortened country code
  • city - The nearest city to the coordinate
  • distance_to_nearest_city - The distance between the coordinate and the nearest city, in miles
  • county - The county the coordinate is located in
  • state - The state the coordinate is located in
  • postal_code - The postal code for the region the coordinate is located in
  • importance - The Wikipedia page rank for the location
  • elevation - The elevation at the location of the coordinate, in meters
422 Unprocessable Entity

You will receive a 422 error if your request body structure is incorrect.

Sample Request​

Use the below sample request in Python to get started.

warning

You need to fill in your specific header values and replace the latitude and longitude values with your own.

Python Request
import requests

url = 'https://point.heimdallapp.org/point/v1/api/process'
headers = {
    'X-api-key': 'YOUR-API-KEY',
    'X-username': 'YOUR-USERNAME',
}

data = {
    "lat": "Add latitude value here",
    "lng": "Add longitude value here" 
}
    
response = requests.post(url, headers=headers, json=data)