API Dokümantasyon - DrMap Türkiye

🚀 Giriş

DefineRota Elevation API, coğrafi koordinatlar için yükseklik verisi sağlayan RESTful bir servistir. SRTM 30m çözünürlüklü veriler ve bilinear interpolasyon ile yüksek hassasiyetli sonuçlar sunar.

💡 İpucu: API, tek bir istekte birden fazla koordinat sorgulamanıza olanak tanır. Bu özellik ile ağ gecikmelerini minimize edebilirsiniz.

🔐 Kimlik Doğrulama

Tüm API istekleri için geçerli bir token gereklidir. Token'ınızı iki şekilde gönderebilirsiniz:

1. URL Parametresi (Önerilen)

GET /v1/srtm30m?locations=39.925,32.866&token=YOUR_TOKEN

2. HTTP Header

X-API-Token: YOUR_TOKEN

⚠️ Uyarı: Token'ınızı asla istemci tarafı kodunda (JavaScript) açık olarak kullanmayın. Sunucu tarafında proxy kullanmanızı öneririz.

🌐 API Endpoint

GET /v1/srtm30m

Base URL: https://api.definerota.com

📋 Parametreler

Parametre	Tip	Zorunlu	Açıklama
locations	string	Zorunlu	Koordinatlar. Format: `lat,lng` veya çoklu: `lat1,lng1\|lat2,lng2`
token	string	Zorunlu	API erişim token'ınız

📤 Yanıt Formatı

API, JSON formatında yanıt döndürür:

✅ Başarılı Yanıt (200 OK)

{
  "status": "OK",
  "results": [
    {
      "dataset": "srtm30m",
      "elevation": 874.52,
      "location": {
        "lat": 39.925,
        "lng": 32.866
      }
    }
  ]
}
                

❌ Hata Yanıtı

{
  "status": "ERROR",
  "error": "Token gerekli",
  "code": 401
}
                

⚠️ Hata Kodları

200 OK - Başarılı 400 Bad Request - Geçersiz parametre 401 Unauthorized - Token gerekli/geçersiz 403 Forbidden - Domain/IP izni yok 429 Too Many Requests - Limit aşıldı

💻 Kod Örnekleri

JavaScript (Fetch)

const token = 'YOUR_TOKEN';
const lat = 39.925;
const lng = 32.866;

fetch(`https://api.definerota.com/v1/srtm30m?locations=${lat},${lng}&token=${token}`)
  .then(response => response.json())
  .then(data => {
    if (data.status === 'OK') {
      console.log('Yükseklik:', data.results[0].elevation);
    }
  });
            

Python (Requests)

import requests

token = 'YOUR_TOKEN'
lat, lng = 39.925, 32.866

response = requests.get(
    f'https://api.definerota.com/v1/srtm30m',
    params={'locations': f'{lat},{lng}', 'token': token}
)

data = response.json()
if data['status'] == 'OK':
    print('Yükseklik:', data['results'][0]['elevation'])
            

cURL

curl -X GET "https://api.definerota.com/v1/srtm30m?locations=39.925,32.866&token=YOUR_TOKEN"
            

Toplu Sorgu (Birden Fazla Koordinat)

# Koordinatları | ile ayırın
curl "https://api.definerota.com/v1/srtm30m?locations=39.925,32.866|41.015,28.979|38.423,27.142&token=YOUR_TOKEN"
            

⏱️ Rate Limiting

API kullanımınız paketinize göre limitlenir:

Paket	Günlük Limit	Aylık Limit	Koordinat/İstek
Başlangıç	500	10.000	20
Profesyonel	2.500	50.000	50
Kurumsal	10.000	250.000	100
Sınırsız	∞	∞	100

💡 İpucu: Limit aşımı durumunda 429 hata kodu alırsınız. Yanıtta kalan limitiniz hakkında bilgi bulunur.

📚 İçindekiler