/elevation/at-point

Click to copy

Returns the elevation from a given input coordinate.

Returns the elevation in meters at a given longitude and latitude within the WGS84 coordinate system.

By default the elevation is measured with respect to the Earth's mean sea level. It takes into account the local variations in gravity and provides a consistent vertical reference.

If the relativeTo query parameter is set to ellipsoid, the elevation will be measured with respect to the ellipsoid. This is a mathematical model that approximates the shape of the Earth. It does not consider local variations in gravity and is commonly used in GPS positioning.

Note: You cannot permanently store elevations. Please see the Terms of use.

Query parameters

NameTypeRequiredDefault valueDescription

number

The longitude of the specified point.

number

The latitude of the specified point.

string

meanSeaLevel

The reference position (datum) from which to measure elevation.

string

The authentication token, used to access the elevation service.

string

json

Optional, case-sensitive parameter to specify the format in which responses are given. Can either be json or pjson.

lon

The longitude of the specified point.

Minimum
-179.99
Maximum
179.99

lat

The latitude of the specified point.

Minimum
-85.05
Maximum
85.05

relativeTo

The reference position (datum) from which to measure elevation. The valid values are:

  • meanSeaLevel: The elevation above or below the WGS84 geoid reference surface, which is approximately the mean sea level. It takes into account the local variations in gravity and provides a consistent vertical reference.
  • ellipsoid: Ellipsoidal height is measured with respect to an ellipsoid, which is a mathematical model that approximates the shape of the Earth. It does not consider local variations in gravity and is commonly used in GPS positioning.
Default
meanSeaLevel
Enumerated values
meanSeaLevel
Click to copy
ellipsoid
Click to copy

token

The authentication token, used to access the elevation service.

The token parameter can be either an API Key or short-lived token.

Alternatively, you can supply a token in the request header with one of the following keys using the "Bearer" scheme:

  • Authorization: Bearer <YOUR_TOKEN>
  • X-Esri-Authorization: Bearer <YOUR_TOKEN>

The provided token must be created from an ArcGIS Location Platform account and have the necessary premium:user:elevation privilege to use the elevation service.

Developer guide: To learn more, go to Security and authentication.

f

Optional, case-sensitive parameter to specify the format in which responses are given. Can either be json or pjson.

Default
json
Enumerated values
json
Click to copy
pjson
Click to copy

Examples

Request

Use dark colors for code blocksCopy
1
2
3
# You can also use wget
curl -X GET https://elevation-api.arcgis.com/arcgis/rest/services/elevation-service/beta/elevation/at-point?lon=-179.99&lat=-85.05 \
  -H 'Accept: application/json'

Response

Response to a request for the elevation at a specified point.

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "elevationInfo": {
    "relativeTo": "meanSeaLevel"
  },
  "result": {
    "point": {
      "spatialReference": {
        "wkid": 4326
      },
      "x": -117.194769,
      "y": 34.057289,
      "z": 396
    }
  }
}
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "elevationInfo": {
    "relativeTo": "meanSeaLevel"
  },
  "result": {
    "point": {
      "spatialReference": {
        "wkid": 4326
      },
      "x": 86.925278,
      "y": 27.988333,
      "z": 8744
    }
  }
}
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "elevationInfo": {
    "relativeTo": "ellipsoid"
  },
  "result": {
    "point": {
      "spatialReference": {
        "wkid": 4326
      },
      "x": -3.1837516,
      "y": 51.4822346,
      "z": 59
    }
  }
}
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "elevationInfo": {
    "relativeTo": "ellipsoid"
  },
  "result": {
    "point": {
      "spatialReference": {
        "wkid": 4326
      },
      "x": -111.093244,
      "y": 45.6830173,
      "z": 1452
    }
  }
}

400 Response

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
{
  "error": {
    "code": 400,
    "message": "string",
    "details": [
      "string"
    ],
    "restInfoUrl": "https://elevation-api.arcgis.com/arcgis/rest/info"
  }
}
StatusMeaningDescriptionSchema

200

OK

Response to a request for the elevation at a specified point.

Inline

400

Bad Request

Invalid query parameters / Incorrect portal item type.

Error

401

Unauthorized

Authentication Error. The API key or token is missing, invalid or expired.

Error

403

Forbidden

The requested resource cannot be accessed because of incorrect sharing permissions.

Error

5XX

Unknown

An error occurred on the server.

Error

Response details

Status Code 200

NameTypeRequiredRestrictionsDescription

elevationInfo

object

none

A structure containing human readable metadata about the specified point.

relativeTo

string

none

The reference position (datum) from which to measure elevation. The valid values are:

  • meanSeaLevel: The elevation above or below the WGS84 geoid reference surface, which is approximately the mean sea level. It takes into account the local variations in gravity and provides a consistent vertical reference.
  • ellipsoid: Ellipsoidal height is measured with respect to an ellipsoid, which is a mathematical model that approximates the shape of the Earth. It does not consider local variations in gravity and is commonly used in GPS positioning.

result

object

none

A structure containing a point including an elevation value (defined as Z).

point

none

A geometry point referring to a location on a map.

spatialReference

object

none

The spatial reference system the point is relative to.

wkid

number

none

The Well-Known ID (WKID) value of the spatial reference.

x

number

none

The X coordinate which is measured along the east/west axis.

y

number

none

The Y coordinate which is measured along the north/south axis.

z

number

none

The Z coordinate represents the vertical position of a point above or below a reference level, such as sea level (in meters, rounded to the nearest meter).

Enumerated Values

relativeTo
meanSeaLevel
Click to copy
ellipsoid
Click to copy

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.