API ของหน่วยงานอุทยานแห่งชาติสหรัฐฯ

 (nps.gov)
1 คะแนน โดย GN⁺ 2024-01-23 | 1 ความคิดเห็น | แชร์ทาง WhatsApp
  • นักพัฒนาที่ต้องการนำข้อมูลอุทยานแห่งชาติไปใช้ในแอป แผนที่ หรือเว็บไซต์ สามารถดึงข้อมูลทางการได้โดยตรงผ่าน NPS Data API
  • สามารถนำข้อมูลและคอนเทนต์ชุดเดียวกันกลับมาใช้ซ้ำได้ทั้งบน NPS.gov และในผลิตภัณฑ์ของนักพัฒนาทั้งภายในและภายนอก เพื่อให้ ข้อมูลมีความสอดคล้องกัน
  • ขอบเขตข้อมูลที่ให้บริการครอบคลุมอย่างกว้างขวาง ทั้งประกาศแจ้งเตือนอุทยาน จุดกางเต็นท์ กิจกรรม แผนการสอน ข่าวประชาสัมพันธ์ ศูนย์บริการนักท่องเที่ยว และข้อมูลด้านการเยี่ยมชม การศึกษา และการดำเนินงาน
  • นักพัฒนาสามารถเริ่มเชื่อมต่อได้หลังจากลงทะเบียน API key และตรวจสอบรูปแบบคำขอรวมถึงรีซอร์สต่างๆ
  • รายการที่จะเพิ่มในอนาคตสามารถดูได้จาก NPS API roadmap ทำให้ทีมที่สร้างบริการเกี่ยวข้องสามารถตรวจสอบแผนการขยายข้อมูลล่วงหน้าได้

บทบาทของ NPS Data API

  • NPS Data API เปิดให้ใช้งาน สำหรับนักพัฒนาทุกคนที่ต้องการใช้ข้อมูล NPS ในโปรเจกต์
  • API คือ ชุดข้อกำหนด ที่ทำให้แอปพลิเคชันหนึ่งสามารถสื่อสารกับอีกแอปพลิเคชันหนึ่งได้
  • NPS Data API ช่วยให้สร้างข้อมูลเพียงครั้งเดียวแล้วนำไปใช้ซ้ำได้ในหลายผลิตภัณฑ์
    • ใช้ได้กับ NPS.gov แอป แผนที่ และเว็บไซต์ของนักพัฒนาภายในและภายนอก
    • ไม่ว่าผู้สร้างผลิตภัณฑ์จะเป็นใคร ก็สามารถใช้ข้อมูลและคอนเทนต์ชุดเดียวกันซ้ำได้

ข้อมูลที่ให้บริการ

  • สามารถตรวจสอบประเภทข้อมูลที่ให้บริการได้ที่ NPS API documentation
    • Alerts: ประกาศเกี่ยวกับอันตราย ความเสี่ยงที่อาจเกิดขึ้น หรือสภาพที่เปลี่ยนแปลงซึ่งอาจส่งผลต่อการเยี่ยมชมอุทยานแห่งชาติ
    • Articles, People, and Places: ชื่อบทความ รูปภาพ และคำอธิบายสั้นๆ ของบทความคอนเทนต์ที่เผยแพร่ร่วมกัน
    • Campgrounds: ข้อมูลตำแหน่ง ที่ติดต่อ เวลาทำการ สิ่งอำนวยความสะดวก ค่าธรรมเนียม และการเข้าถึงของจุดกางเต็นท์ในอุทยานแห่งชาติ
    • Events: วันที่ เวลา ค่าธรรมเนียม และคำอธิบายของกิจกรรมในอุทยานแห่งชาติ
    • Lesson Plans: เป้าหมาย ระดับชั้น วิชา ระยะเวลา และข้อมูลมาตรฐานของแผนการสอนเกี่ยวกับอุทยานแห่งชาติที่ครูสามารถใช้ในชั้นเรียนได้
    • News Releases: ชื่อเรื่อง บทคัดย่อ ลิงก์ และรูปภาพเพิ่มเติมตามตัวเลือกของข่าวประชาสัมพันธ์อุทยานแห่งชาติ
    • Parks: ข้อมูลตำแหน่ง ที่ติดต่อ เวลาทำการ ข้อมูลค่าธรรมเนียมเข้าอุทยานและบัตรผ่าน รวมถึงภาพถ่ายอย่างน้อย 5 ภาพของแต่ละอุทยานแห่งชาติ
    • Visitor Centers: ข้อมูลตำแหน่ง ที่ติดต่อ และเวลาทำการของศูนย์บริการนักท่องเที่ยวและจุดบริการผู้มาเยือนอื่นๆ ในอุทยานแห่งชาติ

จุดเริ่มต้นสำหรับนักพัฒนาและโรดแมป

  • นักพัฒนาสามารถลงทะเบียน API key และตรวจสอบรูปแบบคำขอรวมถึงรีซอร์สของ API ได้ที่ NPS Data API website
  • ฟีเจอร์ที่กำลังพัฒนาหรืออยู่ระหว่างการพิจารณาเพิ่มเติมสามารถดูได้ที่ NPS API roadmap

บทความที่เกี่ยวข้อง

1 ความคิดเห็น

 
GN⁺ 2024-01-23
ความคิดเห็นจาก Hacker News

  • ตัว API เองเจ๋งมากจริง ๆ แต่ครั้งสุดท้ายที่คุยกับทีมที่ดูแลมันน่าจะราวปี 2020 ตอนนั้นก็ขาดคนอยู่แล้ว และอยู่ในสภาพที่ทำได้แค่แก้บั๊กประมาณนั้น
    โรดแมปก็ไม่ได้อัปเดตมาตั้งแต่ปี 2017 ดังนั้นความใช้ได้จริงอาจขึ้นอยู่กับสถานการณ์

    • ตามข้อความปฏิเสธความรับผิดชอบด้านล่างของหน้า ระบุว่าข้อมูลใน โรดแมป NPS API มีไว้เพื่ออ้างอิงเท่านั้น และไม่ควรยึดถือเป็นคำมั่นสัญญาที่มีผลผูกพัน
      อยู่ในโหมดบำรุงรักษามาตั้งแต่ปี 2017 ก็โอเคนะ อินเทอร์เฟซมีแผนจะทำด้วย Jquery UI
    • ฟีเจอร์แจ้งเตือนก็ดีอยู่ แต่ส่วนใหญ่ที่เหลือเป็น ข้อมูลสแตติก อย่างศูนย์บริการนักท่องเที่ยวหรือแผนการสอน เลยไม่จำเป็นต้องเป็น API ไฟล์ JSON แบบสแตติกก็น่าจะพอ
      แคมป์กราวนด์ก็ให้แค่ข้อมูลสแตติกเหมือนกัน ถ้าจะให้มีประโยชน์ในรูปแบบ API ควรแสดงสถานะว่ายังจองจุดกางเต็นท์ได้ไหม และมีเอนด์พอยต์สำหรับจองด้วย
      ตอนแรกหวังว่าจะมี API สำหรับเข้าถึงอะไรอย่างการติดตามปลอกคอหมีที่ยังมีชีวิตอยู่ อยากทำระบบที่แจ้งเตือนอัตโนมัติเมื่อเส้นทางเดินของหมีตัดกับเส้นทางไฮกิงของฉัน
    • พอจะรู้ช่องทางติดต่อทีมนั้นไหม? แอป NPS เป็นหนึ่งในแอปที่ดีที่สุดเท่าที่เคยใช้มา เลยอยากรู้ว่าใครเป็นคนทำ
    • อันนี้ไม่ได้มาจาก 18F เหรอ? ไม่ใช่ทีมเทคโนโลยีสุดเจ๋งฝั่งทำเนียบขาวเหรอ? สงสัยว่างบ รัฐบาลดิจิทัล ก้อนใหญ่พวกนั้นหายไปไหนหมด
    • โดยรวมก็น่าจะเป็นอย่างนั้น น่าเสียดายที่งานประเภทนี้มักได้ การสนับสนุนงบประมาณ ไม่ดีนัก

  • คัดลอกข้อมูลนี้ไปไว้ใน BigQuery แล้ว แบบนี้จะเข้าถึงได้ง่ายขึ้นมากจาก Jupyter notebook หรือ SQL query
    nps-public-data.nps_public_data

  • ดีที่มีของแบบนี้อยู่ หา GitHub ที่มีคลังข้อมูลสาธารณะเจอด้วย มีโปรเจกต์เดิมที่ใช้ API นี้ได้น่าสนใจบ้างไหม?
    [1] https://github.com/nationalparkservice

    • GitHub ส่วนใหญ่เป็นรีโพซิทอรีเก่า ๆ แต่ Symbol Library ยัง active อยู่ ส่วน developer API เองก็ยอดเยี่ยม

  • ถ้าดูแค่รายชื่ออุทยานแห่งชาติจะเหมือนมีแค่ 61 แห่ง แต่จริง ๆ แล้วมี 63 แห่ง
    พอลองเทียบกับ Wikipedia สาเหตุที่ต่างกันคือ National Park of American Samoa ไม่มีการกำหนดชื่อประเภทใด ๆ และ Sequoia กับ Kings Canyon ถูกนับรวมเป็นอุทยานเดียวกัน
    รายการนั้นถูกใส่ไว้ด้วย parkCode: seki

  • เผื่อเป็นข้อมูล ถ้าต้องการข้อมูลมากกว่านี้ ยังมี API ที่แม้ไม่ได้ทำเอกสารไว้แต่เปิดสาธารณะอยู่ สามารถดูได้เมื่อเข้าเว็บไซต์ NPS บางเว็บ

    • นี่อาจเป็นกรณีใช้งานที่เหมาะกับส่วนขยายแบบนี้ ซึ่งช่วยสร้างสเปก API ให้อัตโนมัติระหว่างที่ท่องเว็บไซต์: https://github.com/AndrewWalsh/openapi-devtools
    • ฟังดูเหมือนมุกว่า HTTP ก็ถือเป็น API ในทางเทคนิคเหมือนกัน แต่ด้วยอิทธิพลของ LLM ด้วย เว็บจำนวนมากขึ้นเรื่อย ๆ กำลังรับมือกับการสแครป ดังนั้น API แบบชัดเจน น่าจะยิ่งสำคัญและมีประโยชน์มากขึ้นในอนาคต
    • แชร์ให้ได้ไหม?

  • ที่นี่ก็มีข้อมูลดี ๆ เยอะ: https://irma.nps.gov/Stats/
    ผมใช้มันทำ วิชวลไลเซชันการเยือนอุทยานแห่งชาติ ของตัวเอง: https://jordan-vincent.com/night-under-the-stars

  • ดีเลย เมื่อวันเสาร์กำลังพาร์สตารางดูว่าไมล์โพสต์ไหนบน Blue Ridge Parkway ถูกปิด แล้วก็คิดอยู่พอดีว่าอยากให้มีอะไรแบบนี้จริง ๆ

  • ใน NPS API ยังขาด API สำหรับการจอง อยู่ นั่นแหละคือแรงจูงใจหลักที่จะดึงนักพัฒนาให้มาสร้างประสบการณ์ใหม่ ๆ ที่มีประโยชน์

    • การจองทั้งหมดดำเนินการผ่าน rec.gov
    • ผมคิดว่านี่เป็นเรื่องตั้งใจ มีเหตุผลหลายอย่างที่พอนึกออก

  • ดูเหมือนจะไม่มีสถิติผู้เข้าชม ช่วยไม่ได้ ข้อมูลผู้เข้าชมย้อนหลังอยู่ที่นี่: https://irma.nps.gov/Stats/SSRSReports/Park%20Specific%20Rep...