1 points par GN⁺ 2024-01-23 | 1 commentaires | Partager sur WhatsApp
  • Les développeurs qui souhaitent exploiter des données des parcs nationaux dans des applications, des cartes ou des sites web peuvent récupérer directement les données officielles via la NPS Data API
  • Les mêmes données et contenus peuvent être réutilisés non seulement sur NPS.gov, mais aussi dans des produits développés en interne ou en externe, afin de fournir des informations cohérentes
  • Le périmètre couvre largement des informations de visite, d’éducation et d’exploitation, notamment les alertes des parcs, les campings, les événements, les plans de cours, les communiqués de presse et les centres d’accueil des visiteurs
  • Après avoir enregistré une clé API, les développeurs peuvent consulter le format des requêtes et les ressources pour commencer l’intégration
  • Les éléments qui seront ajoutés par la suite sont consultables dans la roadmap de l’API NPS, ce qui permet aux équipes qui créent des services liés d’anticiper les plans d’extension des données

Rôle de la NPS Data API

  • La NPS Data API est ouverte à tous les développeurs souhaitant utiliser des données du NPS dans leurs projets
  • Une API est un ensemble d’exigences permettant à une application de communiquer avec une autre
  • La NPS Data API permet de créer les données une seule fois et de les réutiliser dans plusieurs produits
    • Cela concerne NPS.gov ainsi que les applications, cartes et sites web de développeurs internes et externes
    • Les mêmes données et contenus peuvent être réutilisés quel que soit l’auteur du produit

Données fournies

  • Les types de données disponibles peuvent être consultés dans la documentation de l’API NPS
    • Alerts : annonces sur les dangers, risques potentiels et changements de conditions susceptibles d’affecter la visite des parcs nationaux
    • Articles, People, and Places : titres, images et courtes descriptions d’articles de contenu partagé
    • Campgrounds : emplacement, coordonnées, horaires d’ouverture, équipements, tarifs et informations d’accessibilité des campings des parcs nationaux
    • Events : date, heure, tarif et description des événements des parcs nationaux
    • Lesson Plans : objectifs, niveau scolaire, matière, durée et informations sur les standards de plans de cours liés aux parcs nationaux que les enseignants peuvent utiliser en classe
    • News Releases : titre, résumé, lien et image facultative des communiqués de presse des parcs nationaux
    • Parks : emplacement, coordonnées, horaires d’ouverture, droits d’entrée et informations sur les pass, avec au moins cinq photos pour chaque parc national
    • Visitor Centers : emplacement, coordonnées et horaires d’ouverture des centres d’accueil des visiteurs et autres infrastructures de contact avec le public dans les parcs nationaux

Point de départ pour les développeurs et roadmap

  • Les développeurs peuvent enregistrer une clé API et consulter le format des requêtes ainsi que les ressources de l’API sur le site de la NPS Data API
  • Les fonctionnalités en cours de développement ou à l’étude sont visibles dans la roadmap de l’API NPS

1 commentaires

 
GN⁺ 2024-01-23
Commentaires sur Hacker News
  • L’API elle-même est vraiment excellente, mais la dernière fois que j’ai parlé à l’équipe qui la maintient, probablement vers 2020, elle manquait déjà de personnel et ne pouvait guère faire plus que corriger des bugs.
    La feuille de route n’a pas non plus été mise à jour depuis 2017, donc son utilité réelle peut varier selon les cas.

    • D’après la clause de non-responsabilité en bas de page, les informations de la feuille de route de l’API NPS ne sont fournies qu’à titre indicatif et ne doivent pas être considérées comme un engagement contraignant.
      Qu’elle soit en mode maintenance depuis 2017, ça me va. L’interface est prévue pour être faite avec jQuery UI.
    • La fonction d’alertes est correcte, mais la plupart du reste relève de données statiques, comme les centres d’accueil ou les plans de cours ; il n’y a pas vraiment besoin d’une API, des fichiers JSON statiques suffiraient.
      Les terrains de camping ne fournissent eux aussi que des données statiques. Pour être utile sous forme d’API, il faudrait afficher la disponibilité des emplacements et fournir aussi un endpoint de réservation.
      J’espérais un accès API à quelque chose comme le suivi par collier de vrais ours. J’aimerais créer un système qui me prévienne automatiquement si le trajet d’un ours croise mon itinéraire de randonnée.
    • Tu saurais comment contacter cette équipe ? L’application NPS est l’une des meilleures applis que j’aie jamais utilisées, et j’aimerais savoir qui l’a faite.
    • Ça ne viendrait pas de 18F ? Ce n’était pas l’équipe tech vraiment impressionnante côté Maison-Blanche ? Je me demande où est passé tout ce budget pour l’administration numérique.
    • C’est probablement globalement ça. C’est dommage, car ce genre de travail est mal financé.
  • J’ai copié ces données dans BigQuery. Comme ça, elles sont bien plus faciles d’accès depuis des notebooks Jupyter ou des requêtes SQL.
    nps-public-data.nps_public_data

  • C’est bien que ça existe. J’ai aussi trouvé un GitHub avec des archives de données publiques. Y a-t-il des projets existants qui utilisent cette API de manière intéressante ?
    [1] https://github.com/nationalparkservice

    • Sur GitHub, ce sont surtout d’anciens dépôts, mais la Symbol Library est encore active. L’API développeur elle-même est excellente.
  • Si on regarde seulement la liste des parcs nationaux, on a l’impression qu’il n’y en a que 61, alors qu’en réalité il y en a 63.
    En comparant avec Wikipedia, la différence vient du fait qu’il manque une désignation pour National Park of American Samoa, et que Sequoia et Kings Canyon sont regroupés comme un seul parc.
    L’entrée correspondante est publiée avec parkCode: seki.

  • Pour info, si vous avez besoin de plus de données, il existe des API publiques mais non documentées. On peut les découvrir en visitant certains sites web du NPS.

    • Cela pourrait être un bon cas d’usage pour ce type d’extension qui génère automatiquement une spécification d’API pendant que l’on parcourt un site web : https://github.com/AndrewWalsh/openapi-devtools
    • Ça ressemble un peu à la blague selon laquelle HTTP est aussi, à strictement parler, une API. Cela dit, avec l’effet des LLM, de plus en plus de sites luttent contre le scraping ; les API explicites vont donc probablement devenir encore plus importantes et utiles.
    • Tu peux les partager ?
  • Il y a aussi beaucoup de bonnes données ici : https://irma.nps.gov/Stats/
    Je m’en suis servi pour créer ma visualisation des visites de parcs nationaux : https://jordan-vincent.com/night-under-the-stars

  • Sympa. Samedi, j’étais justement en train de parser un tableau indiquant quels mileposts étaient fermés sur la Blue Ridge Parkway, et je me disais littéralement qu’un truc comme ça serait pratique.

  • Il manque encore une API de réservation à l’API NPS. C’était précisément l’incitation clé pour attirer les développeurs et leur permettre de créer de nouvelles expériences utiles.

    • Les réservations passent toutes par rec.gov.
    • Je pense que c’est intentionnel. Plusieurs raisons me viennent à l’esprit.
  • Je ne vois pas les statistiques de fréquentation. Tant pis. Les données historiques de fréquentation sont ici : https://irma.nps.gov/Stats/SSRSReports/Park%20Specific%20Rep...