Başla

Elevation API, okyanus yüzeyindeki derin konumlar (negatif değerler döndüren) dahil olmak üzere, dünya yüzeyindeki tüm konumların rakım verilerini sunar.

Bu hizmet, istemci taraflı Maps JavaScript API'nin bir parçası olarak veya Java İstemcisi, Python İstemcisi, Go İstemcisi ve Google Haritalar Hizmetleri için Node.js İstemcisi ile sunucu tarafında da kullanılabilir.

Örnek istek ve yanıt

Elevation API'ye bir HTTP arayüzü aracılığıyla erişirsiniz. URL arayüzü, istekleri URL dizesi şeklinde oluşturulur ve konumları veya yol noktalarını belirlemek için enlem/boylam koordinatlarını kullanır. İstekler API anahtarınızı içermelidir.

Aşağıdaki örnekte JSON biçiminde "Mile High City" olan Denver, Colorado için yükseklik gösterilmektedir:

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

CURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

JavaScript

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Ruby

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Poster

OpenAPI spesifikasyonu, bir Postman koleksiyonu olarak da mevcuttur.

Postman'da çalıştır

Bunu web tarayıcınıza URL'yi girerek test edebilirsiniz (YOUR_API_KEY yerine gerçek API anahtarınızı girdiğinizden emin olun). Yanıt, o noktadaki yüksekliğin metre cinsinden değerini, çözünürlük değeriyle birlikte (rakımların metre cinsinden belirtildiği, veri noktaları arasındaki maksimum mesafe) içerir.

İstek URL'leri ve kullanılabilir parametreler oluşturma ve yanıtı anlama hakkında daha fazla bilgi için geliştirici kılavuzuna bakın.

Aşağıda örnek bir yanıt verilmiştir:

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

OpenAPI spesifikasyonu

Bu API için OpenAPI spesifikasyonu yayınlanmış olup GitHub'da mevcuttur.

OpenAPI Spesifikasyonunu al

Postman Koleksiyonu

OpenAPI spesifikasyonu, bir Postman koleksiyonu olarak da mevcuttur.

Postman'da çalıştır

İstemci kitaplıklarımızla kodlamaya başlayın

İstemci kitaplıkları, kimlik doğrulama, istek kısıtlama ve otomatik yeniden deneme gibi genel görevlerin basit ve yerel uygulamalarını sağlayarak Google Haritalar web hizmeti API'leriyle geliştirmeyi kolaylaştırır. Elevation API; Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi'nde kullanılabilir.

Kimlik doğrulama, kota, fiyatlandırma ve politikalar

Kimlik doğrulama

Elevation API'yi kullanmak için önce API'yi etkinleştirip uygun kimlik doğrulama bilgilerini almanız gerekir. Daha fazla bilgi için Google Haritalar Platformu'nu Kullanmaya Başlama bölümüne bakın.

Kotalar ve fiyatlandırma

Elevation API için belirlenen kotalar ve fiyatlandırma ile ilgili ayrıntılar için kullanım ve faturalandırma sayfasına göz atın.

Politikalar

Elevation API kullanımı, API politikalarına uygun olmalıdır.

Daha fazla bilgi

Elevation API ile daha fazla şey yapabilirsiniz. Örneğin, yükseklik verilerini birden fazla konumdan isteme. Daha fazla örnek ve diğer ayrıntılar için Elevation API geliştirici kılavuzuna göz atın.

Elevation API geliştirici kılavuzu, yükseklik verilerini Google Haritalar Platformu API'lerinden biri tarafından sağlanan haritalarda kullanmak isteyen web sitesi ve mobil geliştiriciler için hazırlanmıştır. Mevcut parametrelerde API ve referans materyalin kullanımına dair bir giriş sunar.