API Layanan Taman Nasional AS

 (nps.gov)
1 poin oleh GN⁺ 2024-01-23 | 1 komentar | Bagikan ke WhatsApp
  • Pengembang yang ingin memanfaatkan data taman nasional di aplikasi, peta, dan situs web dapat mengambil data resmi secara langsung melalui NPS Data API
  • Data dan konten yang sama dapat digunakan ulang tidak hanya di NPS.gov tetapi juga di produk pengembang internal maupun eksternal untuk menyediakan informasi yang konsisten
  • Cakupan yang disediakan meliputi secara luas informasi kunjungan, pendidikan, dan operasional seperti peringatan taman, perkemahan, acara, rencana pelajaran, siaran pers, dan pusat pengunjung
  • Pengembang dapat mulai melakukan integrasi setelah mendaftarkan API key serta memeriksa format permintaan dan resource yang tersedia
  • Item yang akan ditambahkan ke depan dapat dilihat di NPS API roadmap, sehingga tim yang membangun layanan terkait dapat meninjau rencana perluasan data terlebih dahulu

Peran NPS Data API

  • NPS Data API terbuka bagi semua pengembang yang ingin menggunakan data NPS dalam proyek mereka
  • API adalah sekumpulan persyaratan agar satu aplikasi dapat berkomunikasi dengan aplikasi lain
  • NPS Data API memungkinkan data dibuat satu kali lalu digunakan berulang di berbagai produk
    • Ditujukan untuk NPS.gov, pengembang internal, serta aplikasi, peta, dan situs web milik pengembang eksternal
    • Data dan konten yang sama dapat digunakan ulang terlepas dari siapa yang membuat produknya

Data yang tersedia

  • Jenis data yang tersedia dapat dilihat di NPS API documentation
    • Alerts: pemberitahuan tentang bahaya, potensi bahaya, dan perubahan kondisi yang dapat memengaruhi kunjungan ke taman nasional
    • Articles, People, and Places: judul, gambar, dan deskripsi singkat dari artikel konten bersama
    • Campgrounds: lokasi, kontak, jam operasional, fasilitas, biaya, dan informasi aksesibilitas untuk perkemahan taman nasional
    • Events: tanggal, waktu, biaya, dan deskripsi acara taman nasional
    • Lesson Plans: tujuan, tingkat kelas, mata pelajaran, durasi, dan informasi standar dari rencana pelajaran terkait taman nasional yang dapat digunakan guru di kelas
    • News Releases: judul, ringkasan, tautan, dan gambar opsional dari siaran pers taman nasional
    • Parks: lokasi, kontak, jam operasional, informasi biaya masuk dan pass, serta minimal 5 foto untuk setiap taman nasional
    • Visitor Centers: lokasi, kontak, dan jam operasional pusat pengunjung taman nasional serta fasilitas titik kontak pengunjung lainnya

Titik awal pengembang dan roadmap

  • Pengembang dapat mendaftarkan API key dan memeriksa format permintaan serta resource API di NPS Data API website
  • Fitur yang sedang dikembangkan berikutnya atau masih dalam peninjauan tambahan dapat dilihat di NPS API roadmap

Bacaan terkait

1 komentar

 
GN⁺ 2024-01-23
Komentar Hacker News

  • API-nya sendiri benar-benar keren, tetapi terakhir kali saya berbicara dengan tim yang memeliharanya mungkin sekitar 2020, mereka sudah kekurangan staf dan hanya dalam kondisi mampu melakukan perbaikan bug
    Roadmap-nya juga belum diperbarui sejak 2017, jadi kegunaan nyatanya bisa berbeda tergantung situasi

    • Menurut disclaimer di bagian bawah halaman, informasi dalam roadmap NPS API hanya untuk referensi dan tidak boleh diandalkan sebagai komitmen yang mengikat
      Tidak apa-apa kalau sejak 2017 berada dalam mode pemeliharaan. Antarmukanya rencananya dibuat dengan Jquery UI
    • Fitur notifikasi cukup bagus, tetapi sebagian besar sisanya adalah data statis seperti pusat pengunjung atau rencana pelajaran, jadi rasanya tidak perlu berupa API; file JSON statis saja sudah cukup
      Perkemahan juga hanya menyediakan data statis. Agar berguna sebagai API, seharusnya menampilkan ketersediaan tempat berkemah dan bahkan menyediakan endpoint reservasi
      Saya mengharapkan akses API seperti pelacakan kalung beruang hidup. Saya ingin membuat sistem yang otomatis memberi tahu jika rute pergerakan beruang berpotongan dengan rute hiking saya
    • Bisa tahu kontak tim itu? Aplikasi NPS adalah salah satu aplikasi terbaik yang pernah saya pakai, jadi saya ingin tahu siapa yang membuatnya
    • Bukankah ini berasal dari 18F? Bukankah itu tim teknologi yang benar-benar keren di pihak Gedung Putih? Saya penasaran ke mana perginya semua anggaran pemerintah digital yang besar itu
    • Secara umum sepertinya begitu. Sayang sekali dukungan anggaran untuk pekerjaan semacam ini kurang baik

  • Saya sudah menyalin data ini ke BigQuery. Dengan begini jauh lebih mudah diakses dari Jupyter notebook atau kueri SQL
    nps-public-data.nps_public_data

  • Senang ada yang seperti ini. Saya juga menemukan GitHub yang berisi arsip data publik. Apakah ada proyek yang sudah ada yang menggunakan API ini dengan cara menarik?
    [1] https://github.com/nationalparkservice

    • Sebagian besar GitHub-nya adalah repositori lama, tetapi Symbol Library masih aktif. API developernya sendiri sangat bagus

  • Kalau hanya melihat daftar taman nasional, tampaknya hanya ada 61, padahal sebenarnya ada 63
    Setelah dibandingkan dengan Wikipedia, alasannya adalah National Park of American Samoa tidak memiliki penetapan apa pun, dan Sequoia dan Kings Canyon digabung sebagai satu taman
    Entri tersebut terdaftar dengan parkCode: seki

  • Sebagai catatan, jika membutuhkan lebih banyak data, ada API publik yang tidak terdokumentasi. Anda bisa mengetahuinya dengan mengunjungi situs web NPS tertentu

    • Ini bisa menjadi contoh bagus untuk menggunakan ekstensi semacam ini yang otomatis membuat spesifikasi API saat Anda menjelajahi situs web: https://github.com/AndrewWalsh/openapi-devtools
    • Ini juga terdengar seperti lelucon bahwa HTTP secara teknis juga API. Namun, juga karena pengaruh LLM, makin banyak situs web melawan scraping, jadi menurut saya API eksplisit akan makin penting dan berguna ke depannya
    • Bisa dibagikan?

  • Di sini juga ada banyak data bagus: https://irma.nps.gov/Stats/
    Saya menggunakan ini untuk membuat visualisasi kunjungan taman nasional saya: https://jordan-vincent.com/night-under-the-stars

  • Bagus. Pada hari Sabtu saya sedang mem-parsing tabel tentang milepost mana yang ditutup di Blue Ridge Parkway, dan benar-benar sedang berpikir alangkah baiknya kalau ada sesuatu seperti ini

  • NPS API masih belum memiliki API reservasi. Padahal itulah daya tarik utama untuk mengundang developer membuat pengalaman baru yang berguna

    • Semua reservasi diproses melalui rec.gov
    • Saya rasa ini disengaja. Ada beberapa alasan yang terpikir

  • Sepertinya statistik pengunjung tidak terlihat. Apa boleh buat. Data historis pengunjung ada di sini: https://irma.nps.gov/Stats/SSRSReports/Park%20Specific%20Rep...