औज़ार
तीन कैलकुलेटर जो किसी URL से प्रश्न का उत्तर देते हैं और वही उत्तर विजेट के रूप में तथा JSON के रूप में लौटाते हैं। कोई खाता नहीं, कोई key नहीं, कोई शुल्क नहीं, और लाइसेंस आपको जो निकले उसे पुनः प्रकाशित करने देता है।
तीनों औज़ार
इस क्रम में रखे गए हैं कि जवाब किस चीज़ से बना है। पहला वही बताता है जो संचालक ने प्रकाशित किया, दूसरा पाँच में से एक हिस्सा दाख़िल समय-सारणी से लेता है, और तीसरा हर आँकड़ा खुद गिनता है।
फ़ेरी खोजक
मापा हुआइस मार्ग पर कौन-से जहाज़ चलते हैं, उन्हें कौन चलाता है, कितना समय लगता है और संचालक कितना लेता है।
मापा गया। हर पंक्ति 120 संचालकों द्वारा प्रकाशित 2,709 सैलिंग में से एक है, जिसमें प्रस्थान, पार करने का समय, जहाज़ और किराया वैसे ही हैं जैसे दाख़िल हुए। यह एक तिथि-अंकित स्नैपशॉट है, लाइव उपलब्धता नहीं।
स्टेशन तक पहुँचना और वहाँ प्रतीक्षा करना गिन लें तो यात्रा में सचमुच कितना समय लगता है।
पाँच में से एक घटक के लिए दाख़िल, बाक़ी के लिए निकाला गया। वाहन में बिताया समय 545 कॉरिडोर पर दाख़िल है और बाक़ी हर जगह निकाला गया, और टर्मिनल तक पहुँचना, उसमें प्रतीक्षा करना तथा दूसरे छोर पर वही दोनों हमेशा निकाले जाते हैं। किसी पंक्ति का लेबल उसके वाहन-भीतर घटक से तय होता है, उसके कुल से कभी नहीं।
कार्बन कैलकुलेटर
निकाला हुआएक यात्रा वायुमंडल को क्या कीमत चुकाती है, हर उस साधन के लिए जो उसे कर सकता है।
पूरी तरह निकाला गया। हर आँकड़ा 6 प्रकाशित कारकों में से एक को दो निर्देशांक जोड़ों से निकाली गई दूरी से गुणा करके बनता है। जहाँ कोई साधन उस कॉरिडोर पर चलता है, वहाँ दूरी वही लेग है। जहाँ नहीं चलता, वहाँ साधन को महावृत्त दूरी पर मॉडल किया जाता है, कोई यात्रा समय नहीं बताया जाता और पट्टी खोखली खींची जाती है।
हर जवाब किस पर टिका है
वही तीन शब्द जो डेटासेट भी इस्तेमाल करते हैं, क्योंकि कोई औज़ार अपने नीचे की पंक्तियों से अधिक मज़बूत कभी नहीं होता।
- मापा हुआ
- संचालक ने यह मान प्रकाशित किया और हमने उसे लिख लिया। कोई किराया, कोई प्रस्थान, पार करने का कोई समय।
- दाख़िल
- संचालक जो कहता है कि कोई सेवा क्या करेगी। यह एक योजना है, जिसे चली हुई किसी चीज़ से मिलाया नहीं गया।
- निकाला हुआ
- दूसरे मानों से गिना गया। निर्देशांकों के बीच की दूरी, उस पर लगाया गया प्रकाशित ग्राम मान, स्टेशन तक पहुँचने का अनुमानित समय।
तीन में से दो औज़ार निकाले हुए इनपुट पर टिके हैं, और कोई भी इसे छिपाता नहीं: कार्बन कैलकुलेटर मॉडल किए गए साधन को स्तंभ पर ही और API की प्रतिक्रिया में भी चिह्नित करता है, और द्वार-से-द्वार कैलकुलेटर हर हिस्से के साथ स्रोत की एक पंक्ति देता है जिसमें वह दिन लिखा होता है जिसके लिए संचालक ने समय-सारणी दाख़िल की थी।
तीन सतहें, एक ही जवाब
हर औज़ार तीनों करता है। इसी वजह से ये एक बार देख लेने भर के नहीं, बल्कि लिंक करने लायक हैं।
- सर्वर पर बनने वाला स्थायी लिंक
- फ़ॉर्म एक सादा GET है, इसलिए उसे भेजना एक नेविगेशन है और स्थिति पता-पट्टी में रहती है। जवाब देखने के लिए किसी स्क्रिप्ट की ज़रूरत नहीं, और इसका अर्थ यह भी है कि किसी जवाब का लिंक तब भी काम करता है जब उसे किसी लेख, किसी ईमेल या किसी क्रॉलर में चिपकाया जाए।
- अपने पृष्ठ पर लगाने लायक विजेट
- वही पैरामीटर, पर साइट के ढाँचे के बिना एक रूट पर। श्रेय और वापसी का लिंक फ़्रेम के भीतर ही हैं, प्रकाशक से जोड़ने को नहीं कहा जाता, और हर औज़ार पृष्ठ उसी स्थिति का एम्बेड कोड छापता है जो वह उस समय दिखा रहा होता है।
- एक सार्वजनिक JSON API
- बिना key या sign-up के खुला। एक संस्करणित प्रतिक्रिया आकार, body में और Link हेडर में लाइसेंस, cross-origin पठन की अनुमति, और हर उत्तर के हेडर में लौटाई गई दर-सीमा।
| औज़ार | स्थायी लिंक | विजेट | API |
|---|---|---|---|
| फ़ेरी खोजक | /tools/ferry-finder?from=ajaccio&to=toulon | /tools/ferry-finder/embed | /api/tools/ferry-finder |
| द्वार से द्वार तक, न कि सिर्फ़ वाहन में बीता समय | /tools/door-to-door?from=paris&to=london | /tools/door-to-door/embed | /api/tools/door-to-door |
| कार्बन कैलकुलेटर | /tools/co2?from=berlin&to=prague | /tools/co2/embed | /api/tools/co2 |
सीमा हर पते और हर इंस्टेंस के लिए प्रति मिनट 60 अनुरोध है, जो स्मृति में रखी जाती है। यह लूप में फँसी किसी स्क्रिप्ट को रोकती है। यह कोटा नहीं, शिष्टाचार है, और औज़ारों के पृष्ठ यही कहते हैं।
जवाबों का उपयोग
इनसे जो निकलता है वह CC BY 4.0 के तहत है, वही लाइसेंस जो इनके नीचे के डेटासेटों पर लागू है।
किसी आँकड़े को फिर से प्रकाशित कीजिए, उसे नए सिरे से बनाइए, विजेट को किसी व्यावसायिक लेख में लगाइए, API पर कोई उत्पाद खड़ा कीजिए। Orlero का नाम दीजिए और वापस लिंक कीजिए। पूरा लाइसेंस बस इतना ही है, और श्रेय ही वह कारण है जिसके चलते यह सब रखा नहीं, प्रकाशित किया गया है।
कोई जवाब उतना ही ताज़ा है जितनी उसके पीछे की झलक, इसलिए जिस दिन आपने उसे पढ़ा वह नहीं, बल्कि जो तिथि औज़ार आँकड़े के साथ दिखाता है वही उद्धृत कीजिए।