Elevation API'ye genel bakış

Elevation API, dünya üzerindeki bir konum için yükseklik verileri veya yollar boyunca örneklenmiş yükseklik verileri döndüren bir hizmettir.

Elevation API'yi neden kullanmalısınız?

Elevation API ile müşterilerinizi yüksekliğe duyarlı etkinlikler, konumlandırma uygulamaları veya rota boyunca yükselti ve irtifa değişiklikleri içeren düşük anket uygulamaları ile destekleyecek uygulamalar geliştirebilirsiniz. Örneğin, yürüyüş, bisiklet veya tüplü dalış gibi aktiviteler için bir spor uygulamasını geliştirmek üzere irtifa kazancı ve kayıp verileri sağlayabilirsiniz.

Elevation API ile neler yapabilirsiniz?

Elevation API ile uygulamalarınıza veya haritaya yükseklik verileri ekleyebilirsiniz. Örneğin:

  • Belirli bir yerin yüksekliğini öğrenin.
  • Bir rota üzerinde veya iki nokta arasındaki rakım farklarını hesaplayın.

Elevation API'nin işleyiş şekli

Elevation API, istekleri enlem/boylam koordinatlarıyla kodlanmış URL olarak veya ayrı konumlar olarak ya da bir yol boyunca konum dizisi şeklinde kabul eder. Bu istek, örneğin, Kolorado, Denver'ın merkezi için yükseltmeyi sorgulayarak 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 koordinatlara ilişkin yükseklik elde eder. Ayrıca, rakımı olmayan bir konumun yüksekliğinin interpolasyonunu yaparak, rakım verileri sağlayan en yakın dört konumdan ortalama getiri sağlar. Son olarak, konumun genel çözünürlüğünü belirler.

Kaynaklar

Aşağıdaki tabloda, Elevation API üzerinden kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmektedir.

Veri kaynakları Döndürülen veriler İade biçimi
Enlem/boylam koordinatları

Verileri bir veya daha fazla konum kümesi ya da yol boyunca seri olarak sağlayabilirsiniz. Kodlanmış koordinatlar da sağlayabilirsiniz. En fazla 512 koordinat aktarın.

Elevation API, yerel ortalama deniz seviyesine (LMSL) göre metre cinsinden yükseklik sağlar. Yükseklik, aşağıda belirtildiği gibi pozitif veya negatif değerler olarak döndürülebilir:

  • Pozitif değerler, yüzey konumları veya yüksek rakımlı göllerin alt kısmı dahil olmak üzere LMSL'nin üzerindeki konumları belirtir.
  • Negatif değerler, yüzeydeki veya okyanus tabanındaki konumlar dahil olmak üzere LMSL'nin altında olan konumları belirtir.
  • Çözünürlük, veri noktası ile yükseklik arasındaki mesafeyi metre cinsinden gösterir.
  • JSON
  • XML

Elevation API nasıl kullanılır?

1 Hazırlanın. Google Cloud projenizi oluşturma işlemiyle başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Yükseltme isteği deneyin API anahtarınızı oluşturduktan sonra Elevation API'yi doğrudan tarayıcınızdan test etmeye başlayabilirsiniz. Ayrıntılar için Başlangıç kılavuzundaki Örnek istekler bölümüne bakın.
3 Daha karmaşık bir istek oluşturun Bir proje oluşturduktan sonra yol boyunca konum verisi sağlayan bir isteği deneyin. Ayrıntılar için Yolları belirtme bölümüne bakın.
4 Yanıtlarla ilgili temel bilgileri anlama Uygulamanız için yükseklik verilerini kullanmaya hazırlanmak amacıyla yükseklik verisi yanıtlarını inceleyin. Ayrıntılar için Yükseklik yanıtları bölümüne bakın.
5 Yükseklik verilerini kendi uygulamanıza dahil edin. Yükseklik verilerini, spor faaliyetleri için kullanılan uygulamalar veya anket verileri gibi konuma dayalı uygulamaları geliştirmek için kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından birini kullanarak bu API'yi istediğiniz dilde çağırın:

Java İstemcisi, Python İstemcisi, Go İstemcisi ve Google Haritalar Hizmetleri için Node.js İstemcisi, Apache 2.0 Lisansı altında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları GitHub'dan indirin. Burada kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?