Get Started

Notice: Elevation API

Notice:
With the launch of Google Maps Platform, new customers will need to contact
sales for
access to the Maps Elevation API. Keyless users who are currently using
this API, please make sure you sign up for a Google Cloud account and
enable the Maps Elevation API as soon as possible.

The Elevation API provides elevation data for all locations on the
surface of the earth, including depth locations on the ocean floor (which
return negative values).

Sample request and response

You access the Elevation API through an HTTP interface, with
requests constructed as a URL string, using latitude/longitude coordinates to
identify the locations or path vertices. Requests must include your API key.

The following example requests the elevation for Denver, Colorado, the
"Mile High City", in JSON format:

You can test this by entering the URL into your web browser (be sure to replace
‘YOUR_API_KEY’ with your actual API key).
The response includes the elevation at that point, in meters, along with
the resolution value (the maximum distance between data points from which the
elevation was interpolated, in meters).

Authentication, quotas, pricing, and policies

Activate the API and get an API key

To use the Elevation API, you must first activate the API in the
Google Cloud Platform Console and obtain the proper authentication credentials. You need to
provide an API key in each request (or a
client ID if you have a
Premium Plan).

The
Elevation API developer guide is intended for website and
mobile developers who want to use elevation data within maps provided by one of the
Google Maps Platform APIs. It provides an introduction to using the API and reference
material on the available parameters.