फ़ॉरवर्ड जियोकोडिंग

टेक्स्ट को निर्देशांकों में बदलें। किसी भी भाषा में पूरे पते, अधूरे पते, पिन कोड, जगहों के नाम और रुचि के स्थान स्वीकार करता है।

पैरामीटर

उदाहरण

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/forward?q=Dam+1,+Amsterdam&countries=nl&limit=1"

const url = new URL("https://api.mygeocode.com/v1/forward");
url.searchParams.set("q", "Dam 1, Amsterdam");
url.searchParams.set("countries", "nl");
url.searchParams.set("limit", "1");

const data = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(data.results[0]);

import requests

r = requests.get("https://api.mygeocode.com/v1/forward",
                 params={"q": "Dam 1, Amsterdam", "countries": "nl", "limit": 1}, headers={"X-API-Key": "YOUR_KEY"}, timeout=10)
print(r.json()["results"][0])

{
  "status": "ok",
  "query": "Dam 1, Amsterdam",
  "results": [
    {
      "formatted": "Dam 1, 1012 JS Amsterdam, Netherlands",
      "lat": 52.373119,
      "lon": 4.893604,
      "type": "address",
      "precision": "house",
      "confidence": 0.98,
      "place_id": "nl.addr.c21d40e8",
      "components": {
        "house_number": "1",
        "road": "Dam",
        "neighbourhood": "Centrum",
        "city": "Amsterdam",
        "state": "North Holland",
        "state_code": "NH",
        "postcode": "1012 JS",
        "country": "Netherlands",
        "country_code": "nl"
      },
      "bounds": { "north": 52.373519, "south": 52.372719, "east": 4.894204, "west": 4.893004 }
    }
  ]
}

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

कंपोनेंट कुंजियाँ

केवल लागू होने वाली कुंजियाँ मौजूद होती हैं। हर देश में यही कुंजियाँ इस्तेमाल होती हैं।

टिप्पणियाँ

• परिणाम कॉन्फ़िडेंस, सटीकता और निकटता के मेल से क्रमबद्ध होते हैं। जब तक आप कोई चयन सूची नहीं दिखा रहे, पहला परिणाम ही इस्तेमाल करें।
• जब किसी ज्ञात सड़क पर मकान नंबर नहीं मिलता, तो परिणाम में type: street और precision: street होता है, और जहाँ डेटा अनुमति देता है वहाँ नंबर इंटरपोलेट किया जाता है। अगर यह आपके लिए मायने रखता है तो precision जाँचें।
• सिर्फ़ पिन कोड भी q के रूप में ठीक हैं। केवल पिन कोड वाले काम के लिए पिन कोड एंडपॉइंट तेज़ है और डाक प्राधिकरण का जगह का नाम लौटाता है।
• किसी जगह के लिए उस लिपि से अलग लिपि में क्वेरी (मान लीजिए किसी जापानी पते के लिए सिरिलिक) काम करती है, लेकिन रिस्पॉन्स की लिपि lang तय करता है।

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

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

बल्क लुकअप

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

$ curl -X POST "https://api.mygeocode.com/v1/forward" -H "Content-Type: application/json" -d '{"queries": ["Brandenburg Gate, Berlin", "Bahnhofstrasse 1, Zurich"]}'

एरर

400 invalid_request जब न q, न कोई संरचित फ़ील्ड और न place_id मौजूद हो, जब limit 1 से 10 के बाहर हो, या जब bounds या proximity गलत रूप में हो। बाकी के लिए त्रुटियाँ देखें।