Elevation

LocationElevationRequest interface

google.maps.LocationElevationRequest interface

An elevation request sent by the ElevationService containing the list of discrete coordinates (LatLngs) for which to return elevation data.

Properties
locations optional

Type:  Array<LatLng|LatLngLiteral> optional

The discrete locations for which to retrieve elevations.

PathElevationRequest interface

google.maps.PathElevationRequest interface

An elevation query sent by the ElevationService containing the path along which to return sampled data. This request defines a continuous path along the earth along which elevation samples should be taken at evenly-spaced distances. All paths from vertex to vertex use segments of the great circle between those two points.

Properties
samples

Type:  number

Required. The number of equidistant points along the given path for which to retrieve elevation data, including the endpoints. The number of samples must be a value between 2 and 512 inclusive.
path optional

Type:  Array<LatLng|LatLngLiteral> optional

The path along which to collect elevation values.

ElevationResult interface

google.maps.ElevationResult interface

The result of an ElevationService request, consisting of the set of elevation coordinates and their elevation values. Note that a single request may produce multiple ElevationResults.

Properties
elevation

Type:  number

The elevation of this point on Earth, in meters above sea level.
resolution

Type:  number

The distance, in meters, between sample points from which the elevation was interpolated. This property will be missing if the resolution is not known. Note that elevation data becomes more coarse (larger resolution values) when multiple points are passed. To obtain the most accurate elevation value for a point, it should be queried independently.
location optional

Type:  LatLng optional

The location of this elevation result.

ElevationStatus constants

google.maps.ElevationStatus constants

The status returned by the ElevationService upon completion of an elevation request. Specify these by value, or by using the constant's name. For example, 'OK' or google.maps.ElevationStatus.OK.

Access by calling const {ElevationStatus} = await google.maps.importLibrary("elevation").
See Libraries in the Maps JavaScript API.

Constants
INVALID_REQUEST The request was invalid.
OK The request did not encounter any errors.
OVER_QUERY_LIMIT The webpage has gone over the requests limit in too short a period of time.
REQUEST_DENIED The webpage is not allowed to use the elevation service.
UNKNOWN_ERROR The elevation request could not be successfully processed, yet the exact reason for the failure is not known.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-03-02 UTC.