/elevation/at-many-points

Returns elevations for up to 100 input coordinates.

Returns elevations in meters at given longitudes and latitudes within the WGS84 coordinate system.

The order of the points returned by this request will be the same as the order of the points passed in the coordinates parameter.

If the distance between the furthest West and furthest East coordinate exceeds 50km, the service will return a 400 HTTP response as the distance between these points is too large.

If the distance between the furthest North and furthest South coordinate exceeds 50km, the service will return a 400 HTTP response as the distance between these points is too large.

If any of the points are otherwise invalid, a 400 HTTP response will be returned.

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 parameter in the body 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.

The Post Body content type must be either:

• JSON with content type of application/json, or
• form URL encoded key-value pairs with content type application/x-www-form-urlencoded.

The following parameters are used to fetch elevations for multiple coordinates:

coordinates

• (Required) 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]]

f

• (Optional) Case-sensitive parameter to specify the format in which responses are given. Can either be json or pjson.

relativeTo

• (Optional) 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.

token

• (Optional) The authentication token, used to access the elevation service. Alternatively, you can supply a token in the request header with either the Authorization or X-Esri-Authorization key, using the "Bearer" scheme.

Body parameter

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
  "token": "My token",
  "relativeTo": "meanSeaLevel",
  "f": "json",
  "coordinates": [
    [
      31.134167,
      29.979167
    ],
    [
      31.130833,
      29.976111
    ],
    [
      31.128333,
      29.9725
    ]
  ]
}

1
2
3
4
5
6
7
8
9
10
token: My token
relativeTo: meanSeaLevel
f: json
coordinates:
  - - 31.134167
    - 29.979167
  - - 31.130833
    - 29.976111
  - - 31.128333
    - 29.9725

Examples

Request

1
2
3
4
5
# You can also use wget
curl -X POST https://elevation-api.arcgis.com/arcgis/rest/services/elevation-service/beta/elevation/at-many-points \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: API_KEY'

Response

Response to a request for the elevations at specified points. There will be one response point for each point

in the request. The order of these points will match the order of the points in the request.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "elevationInfo": {
    "relativeTo": "meanSeaLevel"
  },
  "result": {
    "points": [
      {
        "spatialReference": {
          "wkid": 4326
        },
        "x": 31.134167,
        "y": 29.979167,
        "z": 82
      },
      {
        "spatialReference": {
          "wkid": 4326
        },
        "x": 31.130833,
        "y": 29.976111,
        "z": 90
      },
      {
        "spatialReference": {
          "wkid": 4326
        },
        "x": 31.128333,
        "y": 29.9725,
        "z": 74
      }
    ]
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
{
  "elevationInfo": {
    "relativeTo": "ellipsoid"
  },
  "result": {
    "points": [
      {
        "spatialReference": {
          "wkid": 4326
        },
        "x": 116.5655434,
        "y": 40.4334671,
        "z": 483
      },
      {
        "spatialReference": {
          "wkid": 4326
        },
        "x": 116.5642703,
        "y": 40.4331226,
        "z": 502
      },
      {
        "spatialReference": {
          "wkid": 4326
        },
        "x": 116.5646503,
        "y": 40.4378045,
        "z": 452
      },
      {
        "spatialReference": {
          "wkid": 4326
        },
        "x": 116.5650703,
        "y": 40.4404094,
        "z": 482
      },
      {
        "spatialReference": {
          "wkid": 4326
        },
        "x": 116.5642957,
        "y": 40.4408222,
        "z": 495
      },
      {
        "spatialReference": {
          "wkid": 4326
        },
        "x": 116.5697131,
        "y": 40.4324535,
        "z": 437
      }
    ]
  }
}

400 Response

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

Response details

Status Code 200

Enumerated Values