API del Servicio de Parques Nacionales de EE. UU.

 (nps.gov)
1 puntos por GN⁺ 2024-01-23 | 1 comentarios | Compartir por WhatsApp
  • Los desarrolladores que quieran usar datos de parques nacionales en apps, mapas o sitios web pueden obtener datos oficiales directamente con la NPS Data API
  • Es posible reutilizar los mismos datos y contenidos no solo en NPS.gov, sino también en productos de desarrolladores internos y externos para ofrecer información consistente
  • El alcance incluye ampliamente información de visita, educación y operación, como alertas de parques, campamentos, eventos, planes de clase, comunicados de prensa y centros de visitantes
  • Los desarrolladores pueden comenzar la integración registrando una API key y revisando el formato de las solicitudes y los recursos disponibles
  • Los próximos elementos que se añadirán pueden consultarse en el NPS API roadmap, por lo que los equipos que crean servicios relacionados pueden revisar con anticipación los planes de expansión de datos

El papel de la NPS Data API

  • La NPS Data API está abierta a cualquier desarrollador que quiera usar datos del NPS en sus proyectos
  • Una API es un conjunto de requisitos para que una aplicación se comunique con otra
  • La NPS Data API permite crear los datos una vez y reutilizarlos repetidamente en varios productos
    • Se usa en NPS.gov, así como en apps, mapas y sitios web de desarrolladores internos y externos
    • Sin importar quién cree el producto, se pueden reutilizar los mismos datos y contenidos

Datos disponibles

  • En la documentación de la API del NPS se pueden consultar los tipos de datos disponibles
    • Alerts: avisos sobre peligros, riesgos potenciales o cambios en las condiciones que puedan afectar la visita a los parques nacionales
    • Articles, People, and Places: títulos, imágenes y descripciones breves de artículos de contenido compartido
    • Campgrounds: ubicación, contacto, horarios, servicios, tarifas e información de accesibilidad de los campamentos en parques nacionales
    • Events: fecha, hora, tarifas y descripción de eventos en los parques nacionales
    • Lesson Plans: objetivos, grado escolar, materia, duración y estándares de planes de clase relacionados con parques nacionales que los docentes pueden usar en clase
    • News Releases: título, resumen, enlace e imagen opcional de comunicados de prensa de parques nacionales
    • Parks: ubicación, contacto, horarios, información de entrada y pases, además de al menos 5 fotos por cada parque nacional
    • Visitor Centers: ubicación, contacto y horarios de centros de visitantes y otros puntos de atención al visitante en parques nacionales

Punto de partida para desarrolladores y hoja de ruta

  • Los desarrolladores pueden registrar una API key y revisar el formato de las solicitudes y los recursos de la API en el sitio de la NPS Data API website
  • Las funciones que están en desarrollo o en revisión para añadirse después pueden verse en el NPS API roadmap

Lecturas relacionadas

1 comentarios

 
GN⁺ 2024-01-23
Comentarios de Hacker News

  • La API en sí está realmente genial, pero la última vez que hablé con el equipo que la mantenía, probablemente por 2020, ya les faltaba personal y estaban en un punto donde apenas podían corregir bugs
    La hoja de ruta tampoco se ha actualizado desde 2017, así que su utilidad real puede variar según la situación

    • Según el descargo de responsabilidad al pie de la página, la información de la hoja de ruta de la API de NPS es solo de referencia y no debe tomarse como un compromiso vinculante
      Que esté en modo de mantenimiento desde 2017 está bien. Planean hacer la interfaz con Jquery UI
    • La función de alertas está bien, pero casi todo lo demás son datos estáticos como centros de visitantes o planes de clase, así que no necesita ser una API y parecería suficiente con archivos JSON estáticos
      Los campamentos también solo ofrecen datos estáticos. Para que realmente sea útil como API, tendría que mostrar disponibilidad de campamentos y ofrecer incluso un endpoint de reservas
      Yo esperaba acceso API a algo como el rastreo de collares de osos vivos. Quisiera crear un sistema que me avise automáticamente si la ruta de un oso cruza mi ruta de senderismo
    • ¿Sabes cómo contactar a ese equipo? La app de NPS es de las mejores que he usado, así que me gustaría saber quién la hizo
    • ¿Esto no salió de 18F? ¿No era ese el equipo tecnológico genial de la Casa Blanca? Me pregunto adónde se fue todo ese presupuesto de gobierno digital
    • Seguramente sí. Es una lástima que este tipo de trabajo no reciba buen apoyo presupuestario

  • Copié estos datos a BigQuery. Así quedan mucho más accesibles desde notebooks de Jupyter o consultas SQL
    nps-public-data.nps_public_data

  • Qué bueno que exista algo así. También encontré un GitHub con archivos públicos de datos. ¿Habrá proyectos existentes que usen esta API de forma interesante?
    [1] https://github.com/nationalparkservice

    • GitHub tiene en su mayoría repositorios viejos, pero la Symbol Library sigue activa. La API para desarrolladores en sí es excelente

  • Si solo ves la lista de parques nacionales, parece que fueran solo 61, pero en realidad son 63
    Comparándolo con Wikipedia, la diferencia se debe a que al National Park of American Samoa le falta cualquier designación, y Sequoia y Kings Canyon aparecen agrupados como un solo parque
    Ese registro aparece con parkCode: seki

  • Como referencia, si necesitas más datos, hay APIs públicas que no están documentadas. Puedes confirmarlo visitando ciertos sitios web de NPS

    • Esto podría ser un buen caso para usar una extensión como esta, que genera automáticamente una especificación API mientras navegas por un sitio: https://github.com/AndrewWalsh/openapi-devtools
    • Suena un poco al chiste de que HTTP, técnicamente, también es una API. Aun así, con el impacto de los LLM, cada vez más sitios web están resistiéndose al scraping, así que las APIs explícitas probablemente serán cada vez más importantes y útiles
    • ¿Lo podrías compartir?

  • Aquí también hay buenos datos: https://irma.nps.gov/Stats/
    Usé esto para crear mi visualización de visitas a parques nacionales: https://jordan-vincent.com/night-under-the-stars

  • Está buenísimo. El sábado estaba parseando una tabla para ver qué mileposts estaban cerrados en Blue Ridge Parkway, y literalmente pensaba que ojalá existiera algo así

  • A la API de NPS todavía le falta una API de reservas. Ese era justamente el incentivo clave para atraer a desarrolladores a crear experiencias nuevas y útiles

    • Todas las reservas se gestionan a través de rec.gov
    • Yo diría que eso es intencional. Se me ocurren varias razones

  • No parece incluir estadísticas de visitantes. Ni modo. Los datos históricos de visitantes están aquí: https://irma.nps.gov/Stats/SSRSReports/Park%20Specific%20Rep...