{
"destination_addresses" :
[
"7 E 54th St, New York, NY 10022, USA",
"34 St-Herald Sq, New York, NY 10001, USA"
],
"origin_addresses" :
[
"569 Vermont St, Brooklyn, NY 11207, USA"
],
"rows" :
[
{
"elements" :
[
{
"distance" :
{
"text" : "28.4 km",
"value" : 28415
},
"duration" :
{
"text" : "42 mins",
"value" : 2493
},
"status" : "OK"
},
{
"distance" :
{
"text" : "27.4 km",
"value" : 27384
},
"duration" :
{
"text" : "38 mins",
"value" : 2251
},
"status" : "OK"
}
]
}
],
"status" : "OK"
}
curl --location --request GET 'https://zylalabs.com/api/5240/distances+calculation+api/6720/distance+calculator?origins=Required&destinations=Required' --header 'Authorization: Bearer YOUR_API_KEY'
साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए दूरी की गणना API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)
डिस्टेंस कैलकुलेशन एपीआई उपयोगकर्ताओं को निर्दिष्ट उत्पत्ति और एक या अधिक गंतव्यों के बीच दूरी और यात्रा समय की गणना करने की अनुमति देता है। एक उत्पत्ति पते के साथ एक या अधिक गंतव्य पते डालकर, उपयोगकर्ता अपनी यात्रा की जरूरतों से संबंधित महत्वपूर्ण जानकारी प्राप्त कर सकते हैं
एपीआई को अनुरोध करने पर, उपयोगकर्ताओं को प्रत्येक यात्रा के बारे में विस्तृत जानकारी के साथ एक संरचित प्रतिक्रिया मिलती है। प्रतिक्रिया में गंतव्यों के पते की एक श्रृंखला और दी गई एकल उत्पत्ति पता शामिल होता है। इस प्रकार, उपयोगकर्ता आसानी से देख सकते हैं कि वे किस स्थान से जा रहे हैं
एपीआई “पक्तियों” का एक मैट्रिक्स उत्पन्न करता है, जहां प्रत्येक तत्व पूछे गए गंतव्यों के लिए होता है। प्रत्येक यात्रा के लिए, उपयोगकर्ताओं को प्रत्येक गंतव्य की दूरी जैसे महत्वपूर्ण मैट्रिक्स मिलते हैं, जो श्रव्य प्रारूप (जैसे, “28.4 किमी”) और गणनात्मक उपयोग के लिए संख्या मान (मीटर में) दोनों में प्रदान किए जाते हैं। यह लचीलापन उन अनुप्रयोगों के लिए आदर्श है जिन्हें उपयोगकर्ता के अनुकूल प्रारूप में जानकारी प्रदर्शित करने या बैकेंड गणनाओं के लिए आवश्यक है
इसके अलावा, एपीआई प्रत्येक मार्ग के लिए अनुमानित यात्रा समय टेक्स्ट और संख्या दोनों में शामिल है। यह उपयोगकर्ताओं को अपनी यात्रा को कुशलतापूर्वक योजना बनाने में मदद करता है, क्योंकि वे विभिन्न गंतव्यों तक पहुंचने के लिए आवश्यक समय की तुलना कर सकते हैं। स्थिति फ़ील्ड अनुरोध की सफलता की पुष्टि करता है, यह सुनिश्चित करता है कि उपयोगकर्ताओं को सटीक और विश्वसनीय डेटा प्राप्त होता है
सारांश में, डिस्टेंस कैलकुलेशन एपीआई कई उत्पत्तियों और गंतव्यों के बीच दूरी और अवधि की गणना के लिए एक संपूर्ण समाधान है, जिससे यह नेविगेशन, लॉजिस्टिक्स और यात्रा योजना अनुप्रयोगों के लिए एक अनिवार्य उपकरण बनता है। सटीक डेटा प्रदान करने की इसकी क्षमता एक आसान से समझने योग्य प्रारूप में इसे डेवलपर्स और अंतिम उपयोगकर्ताओं के लिए आवश्यक संसाधन बनाती है
इस एपीआई का उपयोग करने के लिए, उपयोगकर्ताओं को एक स्रोत अक्षांश और देशांतर के साथ-साथ एक या अधिक गंतव्य अक्षांश और देशांतर प्रदान करने होंगे
हर किसी के लिए विभिन्न योजनाएं हैं जिसमें छोटे मात्रा में अनुरोधों के लिए एक मुफ्त परीक्षण शामिल है लेकिन इसका प्रचार सेवा के दुरुपयोग को रोकने के लिए सीमित है
यह एपीआई एक आरंभिक अक्षांश और देशांतर को प्राप्त करता है, साथ ही कई गंतव्य समन्वय भी, और प्रत्येक मार्ग के लिए यात्रा की दूरी और अवधि प्रदान करता है
दूरी गणना एपीआई निर्दिष्ट मूल और गंतव्य समन्वयों के बीच यात्रा की दूरी और अवधि की गणना करता है जो नेविगेशन और योजना के लिए आवश्यक डेटा प्रदान करता है
महिने में एपीआई कॉलों की संख्या के अलावा कोई अन्य सीमाएँ नहीं हैं
प्रत्येक एंडपॉइंट एक संरचित प्रतिक्रिया लौटाता है जिसमें निर्दिष्ट origen और कई गंतव्यों के बीच यात्रा की दूरी और अवधि होती है डेटा में प्रत्येक मार्ग के लिए दूरी और अवधि के माप मान शामिल होते हैं साथ ही संबंधित पते भी होते हैं
प्रतिक्रिया में मुख्य क्षेत्रों में "गंतव्य पतों," "उद्गम पतों," "पंक्तियाँ," और "तत्व" शामिल हैं प्रत्येक "तत्व" में "दूरी," "अवधि," और "स्थिति" होती है जो प्रत्येक गंतव्य के लिए विस्तृत यात्रा जानकारी प्रदान करती है
उत्तर डेटा को एक मैट्रिक्स फॉर्मेट में व्यवस्थित किया गया है प्रत्येक "पंक्ति" उद्गम के अनुसार होती है जबकि प्रत्येक पंक्ति में "तत्व" प्रत्येक गंतव्य के लिए दूरी और अवधि को दर्शाते हैं जिससे तुलना करना आसान हो जाता है
उपयोगकर्ताओं को एक "उद्गम" पता और एक या एक से अधिक "गंतव्य" पतों को पैरामीटर के रूप में निर्दिष्ट करना चाहिए यह टेक्स्ट प्रारूप में प्रदान किया जा सकता है जिससे इनपुट में लचीलापन मिलता है
उपयोगकर्ता "elements" ऐरे से दूरी और अवधि के मान निकाल सकते हैं गणनाओं या प्रदर्शन के लिए पाठ प्रारूप उपयोगकर्ता इंटरफेस के लिए उपयोगी है जबकि संख्या के मान बैकेंड प्रोसेसिंग को सुविधाजनक बनाते हैं
विशिष्ट उपयोग के मामलों में लॉजिस्टिक्स के लिए मार्ग योजना, यात्रा कार्यक्रम निर्माण और नेविगेशन अनुप्रयोग शामिल हैं एपीआई उपयोगकर्ताओं को दूरी और यात्रा समय के आधार पर सर्वोत्तम मार्ग निर्धारित करने में मदद करता है
डेटा की सटीकता विश्वसनीय मानचित्रण स्रोतों से नियमित अपडेट और गुणवत्ता जांच के माध्यम से बनाए रखी जाती है यह सुनिश्चित करता है कि दूरी और अवधि वर्तमान सड़क स्थितियों और मार्गों को दर्शाते हैं
यदि उपयोगकर्ताओं को आंशिक या खाली परिणाम मिलते हैं तो उन्हें इनपुट पैरामीटर की सटीकता की जांच करनी चाहिए सुनिश्चित करें कि origen और गंतव्य पते मान्य हैं और सही ढंग से प्रारूपित हैं ताकि "NOT_FOUND" स्थितियों से बचा जा सके