अमेरिकी National Park Service API

 (nps.gov)
1 पॉइंट द्वारा GN⁺ 2024-01-23 | 1 टिप्पणियां | WhatsApp पर शेयर करें
  • जो डेवलपर national park डेटा को apps, maps और websites में इस्तेमाल करना चाहते हैं, वे NPS Data API के जरिए आधिकारिक डेटा सीधे प्राप्त कर सकते हैं
  • इसी डेटा और कंटेंट को सिर्फ NPS.gov ही नहीं, बल्कि internal और external developer products में दोबारा इस्तेमाल करके एकसमान जानकारी प्रदान की जा सकती है
  • उपलब्ध दायरे में park alerts, campgrounds, events, lesson plans, news releases, visitor centers आदि जैसे visit, education और operations से जुड़ी व्यापक जानकारी शामिल है
  • डेवलपर API key रजिस्टर करने के बाद request format और resources देखकर integration शुरू कर सकते हैं
  • आगे जो आइटम जोड़े जाएंगे, उन्हें NPS API roadmap में देखा जा सकता है, इसलिए संबंधित services बनाने वाली टीमें पहले से data expansion plan देख सकती हैं

NPS Data API की भूमिका

  • NPS Data API उन सभी डेवलपर्स के लिए खुला है जो NPS डेटा को अपने प्रोजेक्ट में इस्तेमाल करना चाहते हैं
  • API एक application द्वारा दूसरी application से communication करने के लिए requirements का set है
  • NPS Data API डेटा को एक बार बनाने और उसे कई products में बार-बार इस्तेमाल करने की सुविधा देता है
    • इसका उपयोग NPS.gov, internal developers और external developers के apps, maps और websites में किया जा सकता है
    • product बनाने वाला कोई भी हो, वही डेटा और कंटेंट दोबारा इस्तेमाल किया जा सकता है

उपलब्ध डेटा

  • NPS API documentation में उपलब्ध data types देखे जा सकते हैं
    • Alerts: national park यात्रा को प्रभावित कर सकने वाले खतरों, संभावित जोखिमों और बदली हुई परिस्थितियों की सूचना
    • Articles, People, and Places: shared content articles के title, images और छोटे description
    • Campgrounds: national park campgrounds की location, contact details, operating hours, facility amenities, fees और accessibility जानकारी
    • Events: national park events की date, time, fees और description
    • Lesson Plans: teachers के लिए classroom में उपयोग योग्य national park lesson plans के objectives, grade level, subject, duration और standards की जानकारी
    • News Releases: national park press releases के title, abstract, links और optional images
    • Parks: प्रत्येक national park की location, contact details, operating hours, entrance fee/pass जानकारी और हर park की कम से कम 5 photos
    • Visitor Centers: national park visitor centers और अन्य visitor contact facilities की location, contact details और operating hours

डेवलपर के लिए शुरुआत और roadmap

  • डेवलपर NPS Data API website पर API key रजिस्टर करके request format और API resources देख सकते हैं
  • अगली जो features development में हैं या अतिरिक्त समीक्षा में हैं, उन्हें NPS API roadmap में देखा जा सकता है

संबंधित पढ़ाई

1 टिप्पणियां

 
GN⁺ 2024-01-23
Hacker News टिप्पणियाँ

  • API खुद वाकई शानदार है, लेकिन आख़िरी बार जब मैंने इसे मेंटेन करने वाली टीम से बात की थी, शायद 2020 के आसपास, तब भी उनके पास स्टाफ़ की कमी थी और वे बस bug fixes तक ही सीमित थे
    roadmap भी 2017 के बाद अपडेट नहीं हुआ है, इसलिए इसकी वास्तविक उपयोगिता स्थिति के अनुसार अलग हो सकती है

    • पेज के नीचे दिए गए disclaimer के मुताबिक NPS API roadmap की जानकारी सिर्फ़ संदर्भ के लिए है, और इसे किसी बाध्यकारी वादे के तौर पर नहीं माना जाना चाहिए
      2017 से maintenance mode में होना ठीक है। interface को Jquery UI में बनाने की योजना है
    • notification फीचर ठीक है, लेकिन बाकी ज़्यादातर चीज़ें visitor center या lesson plan जैसी static data हैं, जिनके लिए API की ज़रूरत नहीं लगती; static JSON files ही काफ़ी लगती हैं
      campgrounds भी सिर्फ़ static data देते हैं। API के रूप में सच में उपयोगी होने के लिए इसे campsite reservation availability दिखानी चाहिए और reservation endpoint भी देना चाहिए
      मैं तो live bear collar tracking जैसी API access की उम्मीद कर रहा था। मैं ऐसा सिस्टम बनाना चाहता हूँ जो भालुओं की movement path मेरे hiking route को काटे तो मुझे अपने-आप बता दे
    • क्या आपको उस टीम का संपर्क पता है? NPS app अब तक इस्तेमाल किए गए ऐप्स में सबसे बेहतरीन है, इसलिए जानना चाहता हूँ कि इसे किसने बनाया
    • क्या यह 18F से नहीं आया था? वही White House वाली बहुत शानदार tech team? सोचता हूँ कि इतना सारा digital government budget आख़िर गया कहाँ
    • शायद ज़्यादातर मामलों में ऐसा ही होगा। अफ़सोस है कि इस तरह के काम के लिए budget support अच्छा नहीं मिलता

  • मैंने इस डेटा को BigQuery में कॉपी कर लिया है। इससे Jupyter notebook या SQL query में इसे एक्सेस करना बहुत आसान हो जाता है
    nps-public-data.nps_public_data

  • अच्छा है कि ऐसी चीज़ मौजूद है। मुझे public data archive वाला GitHub भी मिला। क्या इस API का कोई दिलचस्प इस्तेमाल करने वाला मौजूदा project है?
    [1] https://github.com/nationalparkservice

    • GitHub पर ज़्यादातर repositories पुरानी हैं, लेकिन Symbol Library अब भी active है। developer API खुद बेहतरीन है

  • राष्ट्रीय उद्यानों की सूची देखने पर ऐसा लगता है कि सिर्फ़ 61 हैं, लेकिन वास्तव में 63 हैं
    Wikipedia से तुलना करने पर फ़र्क़ की वजह यह लगती है कि National Park of American Samoa में कोई designation नहीं है, और Sequoia and Kings Canyon को एक ही park के रूप में जोड़ा गया है
    वह item parkCode: seki के नाम से दर्ज है

  • जानकारी के लिए, अगर आपको और डेटा चाहिए, तो कुछ undocumented लेकिन public API भी हैं। किसी खास NPS वेबसाइट पर जाएँ तो उन्हें देखा जा सकता है

    • वेबसाइट ब्राउज़ करते समय अपने-आप API spec बना देने वाले ऐसे extension के लिए यह अच्छा use case हो सकता है: https://github.com/AndrewWalsh/openapi-devtools
    • यह थोड़ा उस मज़ाक जैसा भी लगता है कि सख़्ती से देखें तो HTTP भी एक API है। लेकिन LLM के प्रभाव की वजह से भी, ज़्यादा से ज़्यादा वेबसाइटें scraping के ख़िलाफ़ जा रही हैं, इसलिए explicit API आगे और भी महत्वपूर्ण और उपयोगी होंगे
    • क्या आप साझा कर सकते हैं?

  • यहाँ भी बहुत अच्छा डेटा है: https://irma.nps.gov/Stats/
    इसका इस्तेमाल करके मैंने अपना national park visit visualization बनाया: https://jordan-vincent.com/night-under-the-stars

  • बढ़िया। शनिवार को मैं Blue Ridge Parkway पर कौन-से mileposts बंद थे, इसकी तालिका parse कर रहा था, और सचमुच सोच रहा था कि काश ऐसा कुछ होता

  • NPS API में अभी भी reservation API नहीं है। डेवलपर्स को नए और उपयोगी experiences बनाने के लिए आकर्षित करने वाला यही सबसे बड़ा प्रोत्साहन था

    • reservations सब rec.gov के ज़रिए संभाली जाती हैं
    • मुझे लगता है यह जानबूझकर ऐसा रखा गया है। इसके कई कारण सूझते हैं

  • visitor statistics दिख नहीं रहे। खैर। पुराना visitor data यहाँ है: https://irma.nps.gov/Stats/SSRSReports/Park%20Specific%20Rep...