API của Cơ quan Công viên Quốc gia Hoa Kỳ

 (nps.gov)
1 điểm bởi GN⁺ 2024-01-23 | 1 bình luận | Chia sẻ qua WhatsApp
  • Các nhà phát triển muốn sử dụng dữ liệu công viên quốc gia trong ứng dụng, bản đồ hoặc website có thể lấy trực tiếp dữ liệu chính thức qua NPS Data API
  • Có thể tái sử dụng cùng một dữ liệu và nội dung không chỉ trên NPS.gov mà còn trong sản phẩm của nhà phát triển nội bộ và bên ngoài để cung cấp thông tin nhất quán
  • Phạm vi cung cấp bao gồm rộng rãi thông tin về tham quan, giáo dục và vận hành như cảnh báo công viên, khu cắm trại, sự kiện, giáo án, thông cáo báo chí, trung tâm du khách
  • Sau khi đăng ký API key, nhà phát triển có thể kiểm tra định dạng yêu cầu và tài nguyên để bắt đầu tích hợp
  • Các hạng mục sẽ được bổ sung trong tương lai có thể xem tại NPS API roadmap, giúp các nhóm xây dựng dịch vụ liên quan xem trước kế hoạch mở rộng dữ liệu

Vai trò của NPS Data API

  • NPS Data API được mở cho mọi nhà phát triển muốn sử dụng dữ liệu NPS trong dự án
  • API là tập hợp các yêu cầu để một ứng dụng có thể giao tiếp với ứng dụng khác
  • NPS Data API cho phép tạo dữ liệu một lần và tái sử dụng lặp lại trên nhiều sản phẩm
    • Đối tượng sử dụng gồm NPS.gov, nhà phát triển nội bộ và ứng dụng, bản đồ, website của nhà phát triển bên ngoài
    • Có thể tái sử dụng cùng một dữ liệu và nội dung bất kể chủ thể tạo ra sản phẩm là ai

Dữ liệu được cung cấp

  • Có thể xem các loại dữ liệu được cung cấp tại NPS API documentation
    • Alerts: Thông báo về nguy hiểm, rủi ro tiềm ẩn hoặc điều kiện thay đổi có thể ảnh hưởng đến việc tham quan công viên quốc gia
    • Articles, People, and Places: Tiêu đề, hình ảnh và mô tả ngắn của các bài viết nội dung được chia sẻ
    • Campgrounds: Thông tin về vị trí, liên hệ, giờ hoạt động, tiện nghi cơ sở, phí và khả năng tiếp cận của các khu cắm trại trong công viên quốc gia
    • Events: Ngày, giờ, phí và mô tả của các sự kiện tại công viên quốc gia
    • Lesson Plans: Mục tiêu, khối lớp, môn học, thời lượng và thông tin tiêu chuẩn của các giáo án liên quan đến công viên quốc gia mà giáo viên có thể dùng trong lớp học
    • News Releases: Tiêu đề, tóm tắt, liên kết và hình ảnh tùy chọn của các thông cáo báo chí về công viên quốc gia
    • Parks: Vị trí, liên hệ, giờ hoạt động, thông tin phí vào cửa và vé pass của từng công viên quốc gia cùng ít nhất 5 ảnh cho mỗi công viên
    • Visitor Centers: Vị trí, liên hệ và giờ hoạt động của các trung tâm du khách và các cơ sở tiếp xúc với khách tham quan khác trong công viên quốc gia

Điểm bắt đầu cho nhà phát triển và lộ trình

  • Nhà phát triển có thể đăng ký API key và kiểm tra định dạng yêu cầu cùng tài nguyên API tại NPS Data API website
  • Các tính năng đang được phát triển tiếp theo hoặc đang được xem xét bổ sung có thể xem tại NPS API roadmap

Bài viết liên quan

1 bình luận

 
GN⁺ 2024-01-23
Ý kiến trên Hacker News

  • Bản thân API thật sự rất tuyệt, nhưng lần cuối tôi nói chuyện với đội bảo trì nó có lẽ là khoảng năm 2020, khi đó họ đã thiếu nhân lực và chỉ ở trạng thái có thể sửa lỗi ở mức cơ bản
    Roadmap cũng chưa được cập nhật kể từ năm 2017, nên mức độ hữu dụng thực tế có thể tùy tình huống

    • Theo tuyên bố miễn trừ trách nhiệm ở cuối trang, thông tin trong roadmap NPS API chỉ mang tính tham khảo và không nên được dựa vào như một cam kết ràng buộc
      Việc ở chế độ bảo trì từ năm 2017 thì cũng ổn. Giao diện dự định sẽ được làm bằng Jquery UI
    • Tính năng thông báo thì ổn, nhưng phần lớn còn lại là dữ liệu tĩnh như trung tâm du khách hay kế hoạch bài học, nên có vẻ không cần phải là API; file JSON tĩnh là đủ
      Khu cắm trại cũng chỉ cung cấp dữ liệu tĩnh. Để hữu ích dưới dạng API, nó cần hiển thị tình trạng còn chỗ đặt trại và cung cấp cả endpoint đặt chỗ
      Tôi đã kỳ vọng có quyền truy cập API kiểu theo dõi vòng cổ gắn trên gấu còn sống. Tôi muốn xây một hệ thống tự động báo cho mình nếu tuyến di chuyển của gấu cắt ngang đường đi bộ đường dài của tôi
    • Có thể biết thông tin liên hệ của đội đó không? Ứng dụng NPS là một trong những ứng dụng tốt nhất tôi từng dùng, nên tôi muốn biết ai đã làm ra nó
    • Cái này không phải đến từ 18F sao? Chẳng phải đó là đội công nghệ cực kỳ tuyệt của phía Nhà Trắng à? Tôi tò mò không biết ngần ấy ngân sách chính phủ số đã đi đâu hết
    • Nhìn chung chắc là vậy. Thật tiếc là hỗ trợ ngân sách cho loại công việc này không tốt

  • Tôi đã sao chép dữ liệu này vào BigQuery. Làm vậy thì truy cập từ Jupyter notebook hoặc truy vấn SQL dễ hơn nhiều
    nps-public-data.nps_public_data

  • Thật tốt khi thứ này tồn tại. Tôi cũng tìm thấy GitHub có kho lưu trữ dữ liệu công khai. Có dự án hiện có nào dùng API này theo cách thú vị không?
    [1] https://github.com/nationalparkservice

    • GitHub chủ yếu là các repository cũ, nhưng Symbol Library vẫn còn hoạt động tích cực. Bản thân API dành cho nhà phát triển thì rất tốt

  • Nếu chỉ nhìn danh sách công viên quốc gia thì có vẻ chỉ có 61, nhưng thực tế là 63
    So với Wikipedia thì lý do khác biệt là National Park of American Samoa bị thiếu mọi chỉ định, còn Sequoia và Kings Canyon được gộp thành cùng một công viên
    Mục đó được đăng với parkCode: seki

  • Để tham khảo, nếu cần nhiều dữ liệu hơn thì có các API công khai dù không được tài liệu hóa. Có thể thấy chúng khi truy cập một số website NPS cụ thể

    • Đây có thể là một trường hợp dùng tốt cho loại extension tự động tạo đặc tả API trong khi bạn duyệt website: https://github.com/AndrewWalsh/openapi-devtools
    • Nghe cũng giống câu đùa rằng HTTP về mặt nghiêm ngặt cũng là một API. Tuy nhiên, một phần do ảnh hưởng của LLM, ngày càng nhiều website chống scraping, nên tôi nghĩ API rõ ràng sẽ ngày càng quan trọng và hữu ích hơn
    • Bạn có thể chia sẻ không?

  • Ở đây cũng có nhiều dữ liệu hay: https://irma.nps.gov/Stats/
    Tôi đã dùng nó để tạo trực quan hóa các chuyến thăm công viên quốc gia của mình: https://jordan-vincent.com/night-under-the-stars

  • Hay đấy. Hôm thứ Bảy, khi đang parse một bảng xem milepost nào trên Blue Ridge Parkway bị đóng, tôi đã nghĩ đúng nghĩa là ước gì có thứ như thế này

  • NPS API vẫn còn thiếu API đặt chỗ. Đó mới chính là động lực cốt lõi để thu hút các nhà phát triển tạo ra những trải nghiệm mới và hữu ích

    • Tất cả đặt chỗ đều được xử lý qua rec.gov
    • Tôi nghĩ việc này là có chủ ý. Có thể nghĩ ra nhiều lý do

  • Có vẻ không thấy thống kê khách tham quan. Đành vậy. Dữ liệu khách tham quan trong quá khứ có ở đây: https://irma.nps.gov/Stats/SSRSReports/Park%20Specific%20Rep...