ऊँचाई लुकअप

एक या कई बिंदुओं के लिए औसत समुद्र तल से ऊँचाई, मीटर में।

पैरामीटर

जो लंबी सूचियाँ URL में नहीं समा सकतीं, उनके लिए एंडपॉइंट JSON बॉडी {"locations": [[lat, lon], ...]} के साथ POST भी स्वीकार करता है।

उदाहरण

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/elevation?locations=36.2381,-116.8175|31.5590,35.4732"

const points = [[36.2381, -116.8175], [31.5590, 35.4732]];
const url = new URL("https://api.mygeocode.com/v1/elevation");
url.searchParams.set("locations", points.map((p) => p.join(",")).join("|"));

const { results } = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
results.forEach((r) => console.log(r.elevation_m));

import requests

points = [(36.2381, -116.8175), (31.5590, 35.4732)]
locations = "|".join(f"{lat},{lon}" for lat, lon in points)
r = requests.get("https://api.mygeocode.com/v1/elevation", params={"locations": locations}, headers={"X-API-Key": "YOUR_KEY"}, timeout=10)
for item in r.json()["results"]:
    print(item["elevation_m"])

{
  "status": "ok",
  "results": [
    { "lat": 36.2381, "lon": -116.8175, "elevation_m": -82.0, "resolution_m": 463.8 },
    { "lat": 31.559, "lon": 35.4732, "elevation_m": -416.0, "resolution_m": 463.8 }
  ]
}

रिस्पॉन्स फ़ील्ड

टिप्पणियाँ

• मान 15 आर्क-सेकंड ग्रिड (लगभग 460 m) के सबसे पास वाले सेल से आते हैं, जो वैश्विक है और ज़मीन तथा समुद्री तल दोनों को कवर करता है। किसी एक बिंदु की सटीक ऊँचाई के बजाय आसपास के इलाके की ऊँचाई की अपेक्षा करें: प्रोफ़ाइल, जलग्रहण क्षेत्र, रेडियो पाथ और जाँच के लिए ठीक, किसी एक इमारत या संकरी चोटी के लिए बहुत मोटा। ऊर्ध्वाधर सटीकता आम तौर पर हल्के ढलान वाले इलाके में कुछ मीटर और खड़े पहाड़ों में दसियों मीटर के भीतर होती है।
• अंतर्देशीय जल निकायों (झीलें, जलाशय) के ऊपर मान सतह की ऊँचाई होता है।
• ऊँचाई बदलती नहीं है। परिणामों को जितनी देर चाहें कैश करें।
• Google Elevation, Bing Elevations और Open-Elevation अनुरोध फ़ॉर्मैट ड्रॉप-इन होस्ट पर उपलब्ध हैं।

यही लुकअप दूसरे प्रदाताओं के फ़ॉर्मैट में

अगर आपके पास इनमें से किसी प्रदाता के लिए पहले से लिखा कोड है, तो उसे रखें: ड्रॉप-इन होस्ट वही पाथ और पैरामीटर स्वीकार करता है और उस प्रदाता के रिस्पॉन्स ढाँचे में जवाब देता है, जिसके पीछे यही एंडपॉइंट होता है। ड्रॉप-इन कैसे काम करते हैं देखें।

एरर

400 invalid_request जब न कोई बिंदु दिया गया हो और न locations, जब कोई निर्देशांक सीमा से बाहर हो या गलत रूप में हो, जब 100 से ज़्यादा बिंदु हों, या जब samples, rows या cols से 100 से ज़्यादा बनें। 503 backend_unavailable जब ऊँचाई सेवा जवाब न दे; कुछ भी गिना नहीं जाता।