Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Yükseklik istekleri ve yanıtları

Yükseklik istekleri

Elevation API istekleri bir URL dizesi olarak oluşturulur. API, dünyadaki konumlar için yükseklik verileri döndürür. Konum verilerini iki şekilde belirtebilirsiniz:

Bir veya daha fazla locations kümesi olarak.
path boyunca birbirine bağlı noktalar dizisi olarak.

Bu yaklaşımların her ikisinde de konumları veya yol köşelerini belirlemek için enlem/boylam koordinatları kullanılır. Bu belgede, Elevation API URL'lerinin gerekli biçimi ve kullanılabilir parametreler açıklanmaktadır.

Elevation API, tek noktalı sorgular için mümkün olan en yüksek doğrulukta veriler döndürür. Birden fazla konum içeren toplu sorgular, özellikle konumlar birbirinden uzaksa verilerin bir kısmı düzeltildiğinden daha az doğru veriler döndürebilir.

Elevation API isteği şu biçimde olur:

https://maps.googleapis.com/maps/api/elevation/outputFormat?parameters

Burada outputFormat aşağıdaki değerlerden biri olabilir:

json (önerilir), çıktının JavaScript Object Notation (JSON) biçiminde olduğunu gösterir veya
xml, XML'deki çıktıyı gösterir ve <ElevationResponse> düğümü içinde sarmalanır.

Not: URL'lerin geçerli olması için uygun şekilde kodlanması gerekir. Ayrıca, tüm web hizmetleri için URL'ler 16.384 karakterle sınırlıdır. URL'lerinizi oluştururken bu sınıra dikkat edin. Farklı tarayıcıların, proxy'lerin ve sunucuların URL karakter sınırlarının da farklı olabileceğini unutmayın.

API anahtarı kullanan istekler için HTTPS gereklidir.

İstek parametreleri

Yükseklik API'sine yapılan istekler, isteğin ayrı konumlar için mi yoksa sıralı bir yol için mi olduğuna bağlı olarak farklı parametreler kullanır. Ayrı konumlar için yükseklik istekleri, istekte iletilen belirli konumlara ilişkin verileri döndürür. Yollar için ise yükseklik istekleri, verilen yol boyunca örneklenir.

Tüm URL'lerde standart olduğu gibi, parametreler "ve" işareti (&) kullanılarak ayrılır. Parametrelerin listesi ve olası değerleri aşağıda belirtilmiştir.

Tüm istekler

key -- (zorunlu) Uygulamanızın API anahtarı. Bu anahtar, kota yönetimi amacıyla uygulamanızı tanımlar. Anahtar alma hakkında bilgi edinin.

Konum istekleri

locations (zorunlu), yükseklik verilerinin döndürüleceği yerleri tanımlar. Bu parametre, virgülle ayrılmış {enlem,boylam} çifti olarak tek bir konum (ör. "40.714728,-73.998672") veya dizi ya da kodlanmış çoklu çizgi olarak iletilen birden fazla enlem/boylam çifti alır. Bu parametre için 512 puan sınırı vardır. Daha fazla bilgi için aşağıdaki Konum Belirtme bölümüne bakın.

Örneklenen yol istekleri

path (zorunlu), yükseklik verilerinin döndürüleceği bir dünya yolu tanımlar. Bu parametre, yeryüzünün yüzeyinde bir yolu tanımlayan iki veya daha fazla sıralı {enlem,boylam} çifti kümesini tanımlar. Bu parametre, aşağıda açıklanan samples parametresiyle birlikte kullanılmalıdır. Bu parametre için 512 puan sınırı vardır. Daha fazla bilgi için aşağıdaki Yolları Belirtme bölümüne bakın.
samples (zorunlu), bir yol boyunca yükseklik verilerinin döndürüleceği örnek noktaların sayısını belirtir. samples parametresi, verilen path değerini yol boyunca eşit mesafede bulunan sıralı bir nokta kümesine böler.

Konumları belirtme

Konum istekleri, locations parametresi kullanılarak belirtilir. Bu parametre, enlem/boylam değerleri olarak iletilen belirli konumlar için yükseklik isteklerini gösterir.

locations parametresi aşağıdaki bağımsız değişkenleri alabilir:

Tek bir koordinat: locations=40.714728,-73.998672
Dikey çizgi ("|") karakteriyle ayrılmış bir koordinat dizisi: locations=40.714728,-73.998672|-34.397,150.644
Encoded Polyline Algorithm kullanılarak kodlanmış bir dizi koordinat: locations=enc:gfo}EtohhU

Enlem ve boylam koordinat dizeleri, virgülle ayrılmış bir metin dizesindeki rakamlar kullanılarak tanımlanır. Örneğin, "40.714728,-73.998672" geçerli bir locations değeridir. Enlem ve boylam değerleri, yeryüzünde geçerli bir konuma karşılık gelmelidir. Enlemler -90 ile 90 arasında herhangi bir değeri alabilirken boylam değerleri -180 ile 180 arasında herhangi bir değeri alabilir. Geçersiz bir enlem veya boylam değeri belirtirseniz isteğiniz hatalı istek olarak reddedilir.

Dizide veya kodlanmış çoklu çizgi içinde 512 koordinata kadar iletebilirsiniz. Bu sırada geçerli bir URL oluşturmaya devam edebilirsiniz. Birden fazla koordinat iletilirken döndürülen verilerin doğruluğunun, tek bir koordinat için veri isteğinde bulunulduğunda elde edilen verilerin doğruluğundan daha düşük çözünürlüklü olabileceğini unutmayın. "locations" veya "path" parametrelerinde 512 noktayı ya da koordinatı aşmak INVALID_REQUEST yanıtı döndürür.

Yolları belirtme

Örneklenmiş yol istekleri, path ve samples parametreleri kullanılarak belirtilir. Bu parametreler, belirli aralıklarla bir yol boyunca yükseklik verileri isteğini gösterir. locations parametresinin kullanıldığı konumsal isteklerde olduğu gibi, path parametresi de bir dizi enlem ve boylam değeri belirtir. Ancak konumsal bir isteğin aksine, path sıralı bir köşe kümesi belirtir. Yalnızca köşe noktalarında yükseklik verileri döndürmek yerine, yol istekleri samples sayısı temel alınarak yolun uzunluğu boyunca örneklenir (uç noktalar dahil).

path parametresi aşağıdaki bağımsız değişkenlerden birini alabilir:

Dikey çizgi ("|") karakteriyle ayrılmış, virgülle ayrılmış iki veya daha fazla koordinat metni dizisi: path=40.714728,-73.998672|-34.397,150.644
Encoded Polyline Algorithm kullanılarak kodlanmış koordinatlar: path=enc:gfo}EtohhUxD@bAxJmGF

Enlem ve boylam koordinat dizeleri, virgülle ayrılmış bir metin dizesindeki rakamlar kullanılarak tanımlanır. Örneğin, "40.714728,-73.998672|-34.397, 150.644" geçerli bir path değeridir. Enlem ve boylam değerleri, yeryüzünde geçerli bir konuma karşılık gelmelidir. Enlemler -90 ile 90 arasında herhangi bir değeri alabilirken boylam değerleri -180 ile 180 arasında herhangi bir değeri alabilir. Geçersiz bir enlem veya boylam değeri belirtirseniz isteğiniz kötü istek olarak reddedilir.

Yükseklik yanıtları

Dikey çizgi ("|") karakteriyle ayrılmış, virgülle ayrılmış iki veya daha fazla koordinat metni dizisi: path=40.714728,-73.998672|-34.397,150.644
Encoded Polyline Algorithm kullanılarak kodlanmış koordinatlar: path=enc:gfo}EtohhUxD@bAxJmGF

Enlem ve boylam koordinat dizeleri, virgülle ayrılmış bir metin dizesindeki rakamlar kullanılarak tanımlanır. Örneğin, "40.714728,-73.998672|-34.397, 150.644" geçerli bir path değeridir. Enlem ve boylam değerleri, yeryüzünde geçerli bir konuma karşılık gelmelidir. Enlemler -90 ile 90 arasında herhangi bir değeri alabilirken boylam değerleri -180 ile -180 arasında herhangi bir değeri alabilir. Geçersiz bir enlem veya boylam değeri belirtirseniz isteğiniz kötü istek olarak reddedilir.

Yükseklik yanıtları

Yükseklik hizmeti, her geçerli istek için istek URL'sinde belirtilen biçimde bir yükseklik yanıtı döndürür.

ElevationResponse

Alan	Zorunlu	Tür	Açıklama
`results`	required	Array<ElevationResult>	Daha fazla bilgi için ElevationResult sayfasına bakın.
`status`	required	ElevationStatus	Daha fazla bilgi için ElevationStatus sayfasını inceleyin.
`error_message`	isteğe bağlı	dize	Hizmet `OK` dışında bir durum kodu döndürdüğünde yanıt nesnesinde ek bir `error_message` alanı olabilir. Bu alan, verilen durum kodunun nedenleri hakkında daha ayrıntılı bilgiler içerir. Bu alan her zaman döndürülmez ve içeriği değişebilir.

ElevationStatus

Hizmet tarafından döndürülen durum kodları.

OK, API isteğinin başarılı olduğunu gösterir.
DATA_NOT_AVAILABLE, giriş konumları için kullanılabilir veri olmadığını gösterir.
INVALID_REQUEST, API isteğinin yanlış biçimlendirildiğini gösterir.
OVER_DAILY_LIMIT aşağıdakilerden herhangi birini gösteriyorsa:
- API anahtarı eksik veya geçersiz.
- Hesabınızda faturalandırma etkinleştirilmemiştir.
- Kullanıcı tarafından belirlenen kullanım sınırı aşıldı.
- Belirtilen ödeme yöntemi artık geçerli değil (örneğin, kredi kartının süresi dolmuş).
OVER_QUERY_LIMIT, isteği gönderenin kotayı aştığını gösterir.
REQUEST_DENIED API'nin isteği tamamlamadığını gösterir.
UNKNOWN_ERROR bilinmeyen bir hata olduğunu gösterir.

Durum kodu OK dışında bir değer olduğunda, Elevation yanıt nesnesinde ek bir error_message alanı olabilir. Bu alan, verilen durum kodunun nedenleri hakkında daha ayrıntılı bilgiler içerir.

Yanıtta aşağıdaki öğeleri içeren bir results dizisi bulunur:

ElevationResult

Alan	Zorunlu	Tür	Açıklama
`elevation`	required	sayı	Konumun metre cinsinden yüksekliği.
`location`	required	LatLngLiteral	Yükseklik verilerinin hesaplandığı konumun bir yer öğesi. Yol isteklerinde, konum öğeleri kümesinin yol boyunca örneklenen noktaları içereceğini unutmayın. Daha fazla bilgi için LatLngLiteral sayfasına bakın.
`resolution`	isteğe bağlı	sayı	Yüksekliğin enterpolasyonla hesaplandığı veri noktaları arasındaki maksimum mesafeyi gösteren değer (metre cinsinden). Çözünürlük bilinmiyorsa bu özellik eksik olur. Birden fazla nokta iletildiğinde yükseklik verilerinin daha kaba (daha büyük çözünürlük değerleri) hale geldiğini unutmayın. Bir nokta için en doğru yükseklik değerini elde etmek istiyorsanız bu noktayı bağımsız olarak sorgulamanız gerekir.

LatLngLiteral

Ondalık derece cinsinden enlem ve boylam ile belirli bir konumu açıklayan nesne.

Alan	Zorunlu	Tür	Açıklama
`lat`	required	sayı	Ondalık derece cinsinden enlem
`lng`	required	sayı	Ondalık derece cinsinden boylam

Konuma bağlı yükseklik örnekleri

Aşağıdaki örnekte, "Mile High City" (Deniz Seviyesinden Yüksek Şehir) olarak bilinen Denver, Colorado'nun rakımı isteniyor:

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'

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>

Aşağıdaki örnekte birden fazla yanıt (Denver, CO ve Death Valley, CA için) gösterilmektedir.

Bu istekte, JSON output işaretinin kullanımı gösterilmektedir:

URL

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

cURL

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

Bu istekte, XML output işaretinin kullanımı gösterilmektedir:

https://maps.googleapis.com/maps/api/elevation/xml?locations=39.7391536,-104.9847034|36.455556,-116.866667&key=YOUR_API_KEY

Örnek JSON ve XML yanıtlarını görmek için aşağıdaki sekmeleri seçin.

JSON

      
{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
      {
        "elevation": -52.79492568969727,
        "location": { "lat": 36.455556, "lng": -116.866667 },
        "resolution": 19.08790397644043,
      },
    ],
  "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>
 <result>
  <location>
   <lat>36.4555560</lat>
   <lng>-116.8666670</lng>
  </location>
  <elevation>-52.7949257</elevation>
  <resolution>19.0879040</resolution>
 </result>
</ElevationResponse>

Aşağıdaki örneklerde, ABD'nin en yüksek ve en alçak noktaları olan Whitney Dağı (CA) ile Badwater (CA) arasında düz bir çizgi path boyunca yükseklik verileri istenmektedir. Üç nokta samples istiyoruz. Bu nedenle iki uç nokta ve yarı yol noktası dahil edilir.

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?path=36.578581%2C-118.291994%7C36.23998%2C-116.83171
  &samples=3
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?path=36.578581%2C-118.291994%7C36.23998%2C-116.83171&samples=3&key=YOUR_API_KEY'

JSON

      
{
  "results":
    [
      {
        "elevation": 4411.94189453125,
        "location": { "lat": 36.578581, "lng": -118.291994 },
        "resolution": 19.08790397644043,
      },
      {
        "elevation": 1372.8359375,
        "location": { "lat": 36.41150289067028, "lng": -117.5602607523847 },
        "resolution": 9.543951988220215,
      },
      {
        "elevation": -84.51690673828125,
        "location": { "lat": 36.23998, "lng": -116.83171 },
        "resolution": 9.543951988220215,
      },
    ],
  "status": "OK",
}

XML

      
<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>36.5785810</lat>
   <lng>-118.2919940</lng>
  </location>
  <elevation>4411.9418945</elevation>
  <resolution>19.0879040</resolution>
 </result>
 <result>
  <location>
   <lat>36.4115029</lat>
   <lng>-117.5602608</lng>
  </location>
  <elevation>1372.8359375</elevation>
  <resolution>9.5439520</resolution>
 </result>
 <result>
  <location>
   <lat>36.2399800</lat>
   <lng>-116.8317100</lng>
  </location>
  <elevation>-84.5169067</elevation>
  <resolution>9.5439520</resolution>
 </result>
</ElevationResponse>

Yükseklik istekleri ve yanıtları