You're all set!

To start developing, please head over to our developer documentation.

Activate the Google Maps Elevation API

To get you started we'll guide you through the Google Developers Console to do a few things first:

  1. Create or choose a project
  2. Activate the Google Maps Elevation API
  3. Create appropriate keys

Getting Started

The Google Maps 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).

This service is also available as part of the client-side Google Maps JavaScript API, or for server-side use with the Java Client, Python Client, Go Client and Node.js Client for Google Maps Services.

Sample request and response

You access the Google Maps 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:,-104.9847034&key=YOUR_API_KEY

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).

View the developer's guide for more information about building request URLs and available parameters and understanding the response.

Below is a sample response, in JSON:

   "results" : [
         "elevation" : 1608.637939453125,
         "location" : {
            "lat" : 39.73915360,
            "lng" : -104.98470340
         "resolution" : 4.771975994110107
   "status" : "OK"

Start coding with our client libraries

Client libraries make developing with the Google Maps web service APIs easier by providing simple, native implementations of common tasks, such as authentication, request throttling and automatic retry. The Google Maps Elevation API is available in the Java Client, Python Client, Go Client and Node.js Client for Google Maps Services.

Authentication, quotas, and policies

Activate the API and get an API key

To use the Google Maps Elevation API, you must first activate the API in the Google API 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).

Click the button below to flow through a process where you will:

  1. Create or select a project
  2. Enable the API
  3. Get an API key
Get a Key

Learn more about authentication credentials.


Review the usage limits page for details on the quotas set for the Google Maps Elevation API.


Use of the Google Maps Elevation API must be in accordance with the API policies.

Learn more

There’s more you can do with the Elevation API, like requesting elevation data from multiple locations and creating elevation charts. See the Elevation API developer’s guide for more examples and other details.

Send feedback about...

Google Maps Elevation API
Google Maps Elevation API
Need help? Visit our support page.