Elevation API'ye genel bakış
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Elevation API, Elevation API,
dünyadaki bir konumu veya yollar boyunca örneklenmiş yükseklik verilerini görebilirsiniz.
Elevation API'yi neden kullanmalısınız?
Elevation API ile yüksek kalite puanına sahip dinleyicilerinizin
yüksekliğe duyarlı aktiviteler, konumlandırma uygulamaları veya az sayıda anket çalışması yapan müşteriler
rotalar boyunca yükselti ve yükselti değişiklikleri içeren uygulamalar Örneğin,
rakım kazanç ve kayıp verilerini sağlayarak bu tür aktiviteler için bir spor uygulamasını iyileştirebilir
tüplü dalış gibi farklı spor etkinlikleri ekleyebilirsiniz.
Elevation API ile yapabilecekleriniz
Elevation API ile her bir konumdaki yükseklik verilerini
üzerinde değişiklik yapabilirsiniz. Örneğin:
- Belirli bir yerin yüksekliğini öğrenin.
- Bir rota boyunca veya iki rota arasındaki yükseklik farklarını hesaplayın
puan.
Elevation API'nin işleyiş şekli
Elevation API, istekleri enlem/boylam koordinatlarına sahip kodlanmış bir URL olarak kabul eder
tek tek konumlar olarak veya bir yol üzerindeki bir dizi konum olarak verilir. Bu istek,
örneğin, Colorado'daki Denver şehir merkezi için yüksekliği sorgulayıp JSON biçiminde bir dönüş belirtir.
https://maps.googleapis.com/maps/api/elevation/json
?locations=39.7391536%2C-104.9847034
&key=YOUR_API_KEY
Hizmet, sağlanan koordinatlar için yüksekliği türetir. Aynı zamanda
yükseklik olmayan bir yerin rakımını gösterir. Bu yükseklik, dört noktadan döndürülen bir ortalamayı gösterir
rakım verileri sağlayan en yakın konumlar. Son olarak, genel olarak
konum çözünürlüğü.
Kaynaklar
Aşağıdaki tabloda,
Elevation API'yi döndürüyor.
| Veri kaynakları |
Döndürülen veriler |
İade biçimi |
| Enlem/boylam koordinatları
Verileri, bir veya daha fazla konumdan oluşan bir küme ya da bir yol üzerindeki bir seri olarak sağlayabilirsiniz. Siz
da kodlanmış koordinatlar sağlayabilir. 512'ye kadar koordinat iletin.
|
Elevation API, göreli metre cinsinden yükseklik sağlar
yerel ortalama deniz seviyesine (LMSL) göre. Yükseklik pozitif olarak döndürülebilir
değerleri veya negatif değerlere sahip olacaktır:
- Pozitif değerler, LMSL'nin üzerindeki konumları belirtir.
yüzey konumları veya yüksek rakımlı göllerin altları gibi.
- Negatif değerler, aşağıdakiler de dahil olmak üzere ÖYS'nin altında olan konumları belirtir.
veya okyanus tabanında bulunan konumları
ayarlamanızı sağlar.
- Çözünürlük, veri noktası ile
metre cinsinden yükseklik.
|
|
Elevation API nasıl kullanılır?
| 1 |
Kurulumu tamamlayın. |
Ayarlarınızı
Google Cloud projesi
ve kurulumu tamamlayın
lütfen unutmayın. |
| 2 |
Yükseltme isteğinde bulunma |
API anahtarınız olduğunda Elevation API'yi doğrudan şuradan test etmeye başlayabilirsiniz:
tarayıcınız. Örnek istekler bölümünü inceleyin
Başlangıç kılavuzunda bulabilirsiniz.
|
| 3 |
Daha karmaşık bir istek oluşturma |
Proje ayarlarını tamamladığınızda,
yol'a dokunun. Yol belirlemebölümünü inceleyin.
inceleyebilirsiniz.
|
| 4 |
Yanıtlarla ilgili temel bilgileri anlama |
Uygulamanızda yükseklik verilerini kullanmaya hazırlanmak için yükseklik verileriyle ilgili yanıtları inceleyin. Görüntüleyin
Yükseltme yanıtları
inceleyebilirsiniz.
|
| 5 |
Yükseklik verilerini kendi uygulamanıza ekleyin! |
Yükseklik verilerini, spor uygulamaları gibi konuma dayalı uygulamaları iyileştirmek için kullanabilirsiniz
anket verileri için
kullanılabilir.
|
Kullanılabilir istemci kitaplıkları
Bu API'yi şu dilde çağırın:
aşağıdaki istemci kitaplıklarından birini kullanarak seçiminizi yapın:
Google Haritalar için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi
Hizmetler, topluluk tarafından desteklenen istemci kitaplıklarıdır ve
Apache 2.0 Lisansı.
Bu uygulamaları GitHub'dan indirin. Burada yükleme talimatlarını ve örnek kodu da bulabilirsiniz.
Sırada ne var?
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
