Elevation API'ye genel bakış

Elevation API, dünya üzerindeki bir konum için yükseklik verileri veya yollarda bulunan örnek yükseklik verileri döndüren bir hizmettir.

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

Elevation API ile yükselti hassasiyeti olan etkinlikler, konumlandırma uygulamaları ya da rotalarda yükselti ve rakım değişiklikleri gibi düşük anket uygulamaları içeren müşterilerinizi desteklemek için uygulamalar geliştirebilirsiniz. Örneğin, yürüyüş, bisiklet veya tüplü dalış gibi aktiviteler için bir spor uygulamasını geliştirmek amacıyla rakım artışı ve kayıp verilerini sağlayabilirsiniz.

Elevation API ile yapabilecekleriniz

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

  • Belirli bir yerin yüksekliğini öğrenin.
  • Rota boyunca veya iki nokta arasında rakımdaki farkları hesaplayın.

Elevation API'nin işleyiş şekli

Elevation API, isteği ayrı konumlar olarak veya yol boyunca bir dizi konum şeklinde sağlanan enlem/boylam koordinatları ile kodlanan bir URL olarak kabul eder. Bu istek, örneğin Denver, Colorado merkezi için sorguları belirterek JSON biçiminde bir getiri 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 rakım belirler. Ayrıca, yükseklik farkı olmayan bir konumun rakımını hesaplar ve yükseklik verileri sağlayan en yakın dört konumdan elde edilen ortalamayı döndürür. Son olarak, konumun genel çözünürlüğünü belirler.

Kaynaklar

Aşağıdaki tabloda Elevation API üzerinden döndürülen kaynaklar ve döndürdüğü veriler özetlenmektedir.

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

Verileri bir veya daha fazla konum grubu veya yol boyunca bir seri olarak sağlayabilirsiniz. Kodlanmış koordinatlar da sağlayabilirsiniz. En fazla 512 koordinat iletebilirsiniz.

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ğer olarak döndürülebilir:

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

Elevation API nasıl kullanılır?

1 Hazır olun. Google Cloud projenizi ayarlayın ile başlayın ve sonraki kurulum talimatlarını tamamlayın.
2 Yükseltme isteğini deneyin Bir API anahtarınız olduktan 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şturma Projeyi oluşturduktan sonra yol boyunca konum verileri sağlayan bir istek deneyin. Ayrıntılar için Yol belirtme bölümüne bakın.
4 Yanıt vermeyle ilgili temel bilgileri anlama Uygulamanız için yükseklik verilerini kullanmaya hazırlanmak için yükseklik verisi yanıtlarını inceleyin. Ayrıntılar için Yükseklik yanıtları'na bakın.
5 Ayrıcalık verilerinizi kendi uygulamanıza ekleyin Spor etkinlikleri veya anket verileri gibi konuma dayalı uygulamaları geliştirmek için yükseklik verilerini kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

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

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

Sırada ne var?