रिवर्स जियोकोडिंग

निर्देशांक दीजिए, सबसे पास का पता पाइए, या अगर आपको बस इतना ही चाहिए तो इलाका, क्षेत्र या देश।

पैरामीटर

उदाहरण

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/reverse?lat=41.8902&lon=12.4922&lang=it"

const url = new URL("https://api.mygeocode.com/v1/reverse");
url.searchParams.set("lat", 41.8902);
url.searchParams.set("lon", 12.4922);
url.searchParams.set("lang", "it");

const { result } = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(result ? result.formatted : "nothing nearby");

import requests

r = requests.get("https://api.mygeocode.com/v1/reverse",
                 params={"lat": 41.8902, "lon": 12.4922, "lang": "it"}, headers={"X-API-Key": "YOUR_KEY"}, timeout=10)
result = r.json()["result"]
print(result["formatted"] if result else "nothing nearby")

{
  "status": "ok",
  "lat": 41.8902,
  "lon": 12.4922,
  "result": {
    "formatted": "Piazza del Colosseo 1, 00184 Roma RM, Italia",
    "lat": 41.890251,
    "lon": 12.492373,
    "distance_m": 9,
    "type": "address",
    "precision": "house",
    "place_id": "it.addr.5d09aa31",
    "components": {
      "house_number": "1",
      "road": "Piazza del Colosseo",
      "suburb": "Municipio Roma I",
      "city": "Roma",
      "county": "Roma",
      "state": "Lazio",
      "postcode": "00184",
      "country": "Italia",
      "country_code": "it"
    }
  }
}

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

टिप्पणियाँ

• बड़ा distance_m एक संकेत है। किसी पार्क में स्थित बिंदु सबसे पास के पते से 300 m दूर हो सकता है; ऐसे में पता दिखाने के बजाय मोहल्ला दिखाना आम तौर पर बेहतर होता है।
• level=country लगभग एक मिलीसेकंड में जवाब देता है और "यह बिंदु किस देश में है" का जवाब देने का सबसे सस्ता तरीका है।
• समुद्र के बिंदु address स्तर पर null लौटाते हैं और, क्षेत्रीय जल के भीतर, country स्तर पर देश लौटाते हैं।

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

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

बल्क लुकअप

उसी पाथ पर coords के साथ एक JSON बॉडी POST करें, जो अधिकतम 100 [lat, lon] जोड़ियों का array हो, और जवाब में एक results array आता है जिसमें भेजे गए क्रम में हर जोड़ी की एक प्रविष्टि होती है। हर प्रविष्टि एक अनुरोध के रूप में गिनी जाती है, और बचे हुए कोटा से बड़ा बैच पूरा का पूरा अस्वीकार कर दिया जाता है।

$ curl -X POST "https://api.mygeocode.com/v1/reverse" -H "Content-Type: application/json" -d '{"coords": [[52.5163, 13.3777], [47.3769, 8.5417]]}'

एरर

400 invalid_request जब lat या lon गायब हो या सीमा से बाहर हो, या level सूचीबद्ध मानों में से एक न हो।