Types

CoordinatesProperty

1
2
3
4
5
6
7
8
9
10
11
12
13
14
[
  [
    31.134167,
    29.979167
  ],
  [
    31.130833,
    29.976111
  ],
  [
    31.128333,
    29.9725
  ]
]

Array of (longitude, latitude) pairs in the WGS84 spatial reference. Maximum size of 100 coordinates.

The order of each pair must be:

• longitude in the range -179.99 to 179.99 representing the east/west or x-axis
• latitude in the range -85.05 to 85.05 representing the north/south or y-axis

For example: [[31.134167, 29.979167], [31.130833, 29.976111], [31.128333, 29.9725]]

Elevation

1
2
3
4
5
6
7
8
9
10
11
{
  "point": {
    "spatialReference": {
      "wkid": 4326,
      "vcsWkid": 105700
    },
    "x": 86.925278,
    "y": 27.988333,
    "z": 8743.9
  }
}

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

Properties

ElevationInfo

1
2
3
{
  "relativeTo": "meanSeaLevel"
}

A structure containing human readable metadata about the specified point.

Properties

Enumerated values

relativeTo

Elevations

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "points": [
    {
      "spatialReference": {
        "wkid": 4326,
        "vcsWkid": 105700
      },
      "x": 86.925278,
      "y": 27.988333,
      "z": 8743.9
    }
  ]
}

A structure containing a collection of points which contain elevation values (defined as Z).

When returned from a request to the /elevation/at-many-points endpoint, the order of the points will match the order of the points in the request.

Properties

Error

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

Properties

error properties

Enumerated values

code

Format

1
"json"

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

Type

string

Required

false

Restrictions

none

Enumerated values

anonymous

Point

1
2
3
4
5
6
7
8
9
{
  "spatialReference": {
    "wkid": 4326,
    "vcsWkid": 105700
  },
  "x": 86.925278,
  "y": 27.988333,
  "z": 8743.9
}

A geometry point referring to a location on a map.

Properties

spatialReference properties

RelativeToProperty

1
"meanSeaLevel"

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. This reference surface 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. This ellipsoid does not consider local variations in gravity and is commonly used in GPS positioning.

Type

string

Required

false

Restrictions

none

Default value

meanSeaLevel

Enumerated values

anonymous

TokenProperty

1
"MyToken"

Deprecated: The token parameter in the POST body has been deprecated. Use the authorization header with the Bearer scheme. For more information see HTTP authorization headers.

The authentication token, used to access the elevation service.

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

This parameter is required unless you supply an access 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.

Type

string

Required

false

Restrictions

none