米国国立公園局サービス API

 (nps.gov)
1 ポイント 投稿者 GN⁺ 2024-01-23 | 1件のコメント | WhatsAppで共有
  • 国立公園データをアプリ・地図・ウェブサイトで活用したい開発者は、NPS Data API を通じて公式データを直接取得できる
  • 同じデータとコンテンツを NPS.gov だけでなく、社内・社外の開発者製品でも再利用でき、一貫した情報提供が可能になる
  • 提供範囲には、公園アラート、キャンプ場、イベント、授業計画、プレスリリース、ビジターセンターなど、訪問・教育・運営に関する情報が幅広く含まれる
  • 開発者は API キー を登録したうえで、リクエスト形式とリソースを確認し、連携を開始できる
  • 今後追加される項目は 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: 国立公園のビジターセンターおよびその他の来訪者向け接点施設の位置、連絡先、営業時間

開発者向けの出発点とロードマップ

  • 開発者は NPS Data API website で API キー を登録し、リクエスト形式と API リソースを確認できる
  • 次に開発中、または追加検討中の機能は 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 ノートブックや SQL クエリからずっとアクセスしやすい
    nps-public-data.nps_public_data

  • こういうものが存在していてうれしい。公開データアーカイブがある GitHub も見つけた。この API を面白く使っている既存プロジェクトはあるのだろうか？
    [1] https://github.com/nationalparkservice

    • GitHub はほとんど古いリポジトリだが、Symbol Library はまだ活発だ。開発者向け API 自体は素晴らしい

  • 国立公園の一覧だけを見ると61件しかないように見えるが、実際には63件ある
    Wikipedia と比べてみると、差が出る理由は National Park of American Samoa には指定がまったく入っておらず、Sequoia and 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...