फ़ॉरवर्ड जियोकोडिंग API
कोई पता, किसी जगह का नाम, पिन कोड या "Kings Cross के पास कॉफ़ी शॉप" जैसा मोटा विवरण भेजें और बदले में निर्देशांक, साफ़ किया हुआ पता, उसके हिस्से, एक बाउंडिंग बॉक्स और एक सटीकता स्तर पाएँ, जो बताता है कि उस बिंदु पर कितना भरोसा किया जा सकता है।
उदाहरण
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/forward?q=221B+Baker+Street,+London&limit=1"मुक्त रूप से लिखा टेक्स्ट काम करता है। अगर आपके पास पहले से अलग-अलग हिस्से हैं, तो संरचित क्वेरी भी काम करती है: street=221B Baker Street&city=London&country=gb। country=gb,ie से परिणामों को एक या अधिक देशों तक सीमित करें, proximity=lat,lon से उन्हें किसी बिंदु की ओर झुकाएँ, या bounds से किसी बॉक्स की ओर।
{
"status": "ok",
"query": "221B Baker Street, London",
"results": [
{
"formatted": "221B Baker Street, London NW1 6XE, United Kingdom",
"lat": 51.523767,
"lon": -0.158555,
"type": "address",
"precision": "house",
"confidence": 0.97,
"components": {
"house_number": "221B",
"road": "Baker Street",
"neighbourhood": "Marylebone",
"city": "London",
"state": "England",
"postcode": "NW1 6XE",
"country": "United Kingdom",
"country_code": "gb"
},
"bounds": { "north": 51.523917, "south": 51.523617, "east": -0.158305, "west": -0.158805 }
}
]
}आपको क्या वापस मिलता है
| फ़ील्ड | अर्थ |
|---|---|
formatted | पूरा पता, उसी तरह लिखा हुआ जैसे वह देश पते लिखता है। |
lat, lon | दशमलव डिग्री, WGS 84। अधिकतम छह दशमलव अंक। |
type | किससे मिलान हुआ: address, street, postcode, city, region, country या poi। |
precision | house, street, postcode या admin। कवरेज देखें। |
confidence | 0 से 1 तक। क्वेरी को देखते हुए हमें कितना यकीन है कि यही वह जगह है जो आपका मतलब था। यह सटीकता स्तर से स्वतंत्र है: किसी शहर की क्वेरी का मिलान admin सटीकता पर 1 विश्वास के साथ हो सकता है। |
components | हिस्सों में बँटा पता, हर देश में एक जैसे कुंजी नामों के साथ। केवल वही हिस्से मौजूद होते हैं जो वास्तव में हैं। |
bounds | मिलान किए गए फ़ीचर का बाउंडिंग बॉक्स: इमारत, सड़क, पिन कोड क्षेत्र या शहर। |
इसका उपयोग कहाँ होता है
ग्राहकों के पते साफ़ करना
साइन अप के समय जियोकोड करें और ग्राहक ने जो टाइप किया उसके साथ formatted और components सहेजें। precision: street से नीचे की किसी भी चीज़ को अस्वीकार करें और ग्राहक से जाँचने को कहें।
रिकॉर्ड को मैप पर दिखाना
दुकानों या संपत्तियों के पतों वाली CSV को 50 प्रति सेकंड की दर से बैच में चलाएँ और उन्हें मैप पर दिखाएँ। bounds फ़ील्ड हर एक के लिए सही ज़ूम देता है।
जगह के आधार पर खोज
"Hackney में फ़्लैट" को एक बाउंडिंग बॉक्स में बदलें और उससे अपने डेटाबेस में क्वेरी करें। type बताता है कि उपयोगकर्ता ने शहर, सड़क या इमारत टाइप की।
सटीकता
मकान स्तर के परिणाम इस पर निर्भर करते हैं कि उस देश के लिए पता डेटा मौजूद है या नहीं, और यह हर जगह मौजूद नहीं है। कवरेज पेज 249 देशों और क्षेत्रों में से हर एक में हमारा सबसे अच्छा स्तर बताता है। जहाँ हम मकान नंबर का मिलान नहीं कर पाते, वहाँ हम सड़क पर, फिर पिन कोड पर, फिर इलाके पर लौटते हैं, और precision फ़ील्ड बताता है कि कौन सा। हम कभी भी किसी देश के केंद्र बिंदु को पते के रूप में नहीं लौटाते।
कीमत और सीमाएँ
एक कॉल एक अनुरोध है, चाहे वह कितने भी परिणाम लौटाए (limit के साथ अधिकतम 10)। हर कुंजी को प्रतिदिन 2,500 मुफ़्त अनुरोध मिलते हैं; उसके बाद प्रीपेड क्रेडिट से हर अनुरोध के €0.0001, या Unlimited कुंजी पर कुछ नहीं (€50 प्रति माह)। मूल्य निर्धारण का विवरण।
किसी दूसरे प्रदाता से माइग्रेट कर रहे हैं? Google, Bing, HERE, Mapbox और अन्य ड्रॉप-इन होस्ट फ़ॉरवर्ड जियोकोडिंग अनुरोधों का जवाब उन्हीं प्रदाताओं के फ़ॉर्मैट में देते हैं।