Panoramica dell'API Elevation
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Elevation è un servizio che restituisce i dati di altitudine per
un luogo sulla Terra o dati di elevazione campionati lungo percorsi.
Perché utilizzare l'API Elevation
Con l'API Elevation, puoi sviluppare applicazioni per supportare i tuoi
Clienti con attività sensibili all'elevazione, applicazioni di posizionamento o sondaggi con limitazioni
applicazioni che includono dislivelli e dislivelli lungo i percorsi. Ad esempio:
puoi fornire dati relativi alla perdita e al dislivello per migliorare un'applicazione sportiva per attività come
ad esempio trekking, ciclismo o immersioni.
Cosa puoi fare con l'API Elevation
Con l'API Elevation, puoi includere dati di altitudine nei
applicazioni o su una mappa. Ad esempio:
- Visualizza l'altitudine di un determinato luogo.
- Calcola le differenze di elevazione lungo un percorso o tra due
punti.
Come funziona l'API Elevation
L'API Elevation accetta una richiesta come URL codificato con coordinate di latitudine/longitudine
fornite come posizioni discrete o come una serie di posizioni lungo un percorso. Questa richiesta
Ad esempio, esegue query sull'elevazione del centro di Denver, in Colorado, specificando un ritorno in formato JSON.
https://maps.googleapis.com/maps/api/elevation/json
?locations=39.7391536%2C-104.9847034
&key=YOUR_API_KEY
Il servizio ricava l'elevazione per le coordinate fornite. Inoltre, esegue l'interpolazione
l'altitudine per una località senza altitudine, fornendo una media restituita dai quattro
località più vicine che forniscono dati di altitudine. Infine, determina il livello
risoluzione del luogo.
Risorse
La tabella seguente riassume le risorse disponibili tramite
API Elevation insieme ai dati che restituisce.
| Risorse di dati |
Dati restituiti |
Formato di reso |
| Coordinate di latitudine/longitudine
I dati possono essere forniti come un insieme di una o più località o come serie lungo un percorso. Tu
può anche fornire coordinate codificate. Puoi inserire fino a 512 coordinate.
|
L'API Elevation fornisce l'elevazione in metri relativa
al livello medio del mare locale (LMSL). L'elevazione può essere restituita come positiva
valori negativi o negativi, come indicato di seguito:
- I valori positivi indicano posizioni superiori all'SGAL,
comprese le posizioni in superficie o i fondali di laghi ad alta quota.
- I valori negativi indicano le località al di sotto del sistema SGAL, tra cui
luoghi sulla superficie o sul fondale oceanico.
- Risoluzione indica la distanza tra il punto dati e
di altitudine, in metri.
|
|
Come utilizzare l'API Elevation
| 1 |
Configurazione. |
Inizia con l'articolo Configura il tuo
Progetto Google Cloud
e completare la configurazione
istruzioni che seguono. |
| 2 |
Prova una richiesta di elevazione |
Una volta ottenuta una chiave API, puoi iniziare a testare l'API Elevation direttamente da
nel browser. Vedi Richieste di esempio
nella Guida introduttiva per maggiori dettagli.
|
| 3 |
Scrivere una richiesta più complessa |
Una volta creato un progetto, prova a effettuare una richiesta che fornisca i dati sulla posizione insieme a
del tuo percorso di apprendimento. Consulta la sezione Specifica dei percorsi
per maggiori dettagli.
|
| 4 |
Nozioni di base sulle risposte |
Esplora le risposte dei dati di altitudine per prepararti a utilizzare i dati di altitudine per la tua app. Consulta
Risposte relative all'elevazione
per maggiori dettagli.
|
| 5 |
Incorpora i dati di altitudine nella tua app. |
Puoi utilizzare i dati di altitudine per migliorare le app basate sulla posizione, come le app per lo sport
attività o per i dati dei sondaggi.
|
Librerie client disponibili
Chiama questa API nella lingua di
la tua scelta tramite una delle seguenti librerie client:
Client Java, client Python, client Go e client Node.js per Google Maps
I servizi sono librerie client supportate dalla community, open source secondo
Licenza Apache 2.0.
Scaricale da GitHub, dove puoi trovare anche le istruzioni per l'installazione e il codice di esempio.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eThe Elevation API provides elevation data for locations on Earth, enabling applications with elevation-sensitive features.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve elevation for single points or calculate elevation differences along paths, useful for activities like hiking or biking.\u003c/p\u003e\n"],["\u003cp\u003eThe API accepts latitude/longitude coordinates and returns elevation data in meters relative to local mean sea level, with resolution information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access the Elevation API through various client libraries (Java, Python, Go, Node.js) and integrate it into their applications.\u003c/p\u003e\n"],["\u003cp\u003eTo get started, set up a Google Cloud project, try sample requests, and explore the documentation for detailed usage instructions.\u003c/p\u003e\n"]]],[],null,["The Elevation API is a service that returns elevation data for\na location on the earth, or sampled elevation data along paths.\n\nWhy use the Elevation API\n\nWith the Elevation API, you can develop applications to support your\ncustomers with elevation-sensitive activities, positioning applications, or low-surveying\napplications that include elevations and elevation changes along routes. For example,\nyou can provide elevation gain and loss data to enhance a sports application for activities such\nas hiking, biking, or scuba diving.\n\nWhat you can do with the Elevation API\n\nWith the Elevation API, you can include elevation data in your\napplications or on a map. For example:\n\n- Get the **elevation** for a particular place.\n- Calculate the **differences** in elevation along a route or between two points.\n\nHow the Elevation API works The Elevation API accepts a request as an encoded URL with latitude/longitude coordinates provided as either discrete locations, or as a series of locations along a path. This request, for example, queries elevation for the center of Denver, Colorado, specifying a return in JSON format. \n\n```scdoc\n https://maps.googleapis.com/maps/api/elevation/json\n ?locations=39.7391536%2C-104.9847034\n &key=YOUR_API_KEY\n```\n\nThe service derives the elevation for the provided coordinates. It also interpolates\nelevation for a location without elevation, providing an average returned from the four\nnearest locations that do provide elevation data. Finally, it determines the overall\nresolution for the location.\n\nResources\n\nThe following table summarizes the resources available through the\nElevation API along with the data it returns.\n\n| Data resources | Data returned | Return format |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| **Latitude/longitude coordinates** You can provide data as a set of one or more locations, or as a series along a path. You can also provide encoded coordinates. Pass up to 512 coordinates. | The Elevation API provides **elevation in meters** relative to the **local mean sea level** (LMSL). Elevation can be returned as positive or negative values as indicated below: - **Positive values** indicate locations above LMSL, including surface locations or the bottom of high-altitude lakes. - **Negative values** indicate locations that are below LMSL, including locations on the surface or the ocean floor. - **Resolution** indicates the distance between the data point and the elevation, in meters. | - JSON - XML |\n\nHow to use the Elevation API\n\n|---|---------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/elevation/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try an elevation request** | Once you have an API key, you can start testing out the Elevation API directly from your browser. See [Sample requests](/maps/documentation/elevation/start#sample-request) in the *Getting started* guide for details. |\n| 3 | **Compose a more complex request** | Once you are set up with a project, try a request that supplies a location data along a path. See [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths) for details. |\n| 4 | **Understand response basics** | Explore the elevation data responses to prepare to use elevation data for your app. See [Elevation responses](/maps/documentation/elevation/requests-elevation#ElevationResponses) for details. |\n| 5 | **Incorporate elevation data into your own app!** | You can use elevation data to enhance location-based apps, such as apps for sports activities or for survey data. |\n\nAvailable client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n\n- **Start using the Elevation API** : Go to [Set up your\n Google Cloud project](/maps/documentation/elevation/cloud-setup).\n- **Try getting path-based elevation data** : Go to [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths)\n- **Follow best practices** : Go to [Web Service\n Best Practices](/maps/documentation/elevation/web-service-best-practices)."]]
