ABD Ulusal Park Hizmeti API’si

 (nps.gov)
1 puan yazan GN⁺ 2024-01-23 | 1 yorum | WhatsApp'ta paylaş
  • Ulusal park verilerini uygulama, harita ve web sitelerinde kullanmak isteyen geliştiriciler, resmi verileri doğrudan NPS Data API ile alabilir
  • Aynı veri ve içerik, yalnızca NPS.gov’da değil, iç ve dış geliştirici ürünlerinde de yeniden kullanılarak tutarlı bilgi sunumu sağlanabilir
  • Kapsam; park uyarıları, kamp alanları, etkinlikler, ders planları, basın bültenleri, ziyaretçi merkezleri gibi ziyaret, eğitim ve operasyon bilgilerini geniş biçimde içerir
  • Geliştiriciler, API anahtarı kaydettikten sonra istek biçimini ve kaynakları inceleyerek entegrasyona başlayabilir
  • İleride eklenecek başlıklar NPS API roadmap üzerinden görülebilir; böylece ilgili hizmetleri geliştiren ekipler veri genişleme planlarını önceden inceleyebilir

NPS Data API’nin rolü

  • NPS Data API, NPS verilerini projelerinde kullanmak isteyen tüm geliştiricilere açıktır
  • API, bir uygulamanın başka bir uygulamayla iletişim kurması için gereken gereksinimler kümesidir
  • NPS Data API, verinin bir kez üretilip birden fazla üründe tekrar tekrar kullanılmasını sağlar
    • Kullanım alanları NPS.gov, iç geliştiriciler ve dış geliştiricilerin uygulama, harita ve web siteleridir
    • Ürünü kimin geliştirdiğinden bağımsız olarak aynı veri ve içerik yeniden kullanılabilir

Sunulan veriler

  • NPS API documentation üzerinden sunulan veri türleri görülebilir
    • Alerts: Ulusal park ziyaretini etkileyebilecek tehlikeler, olası riskler ve değişen koşullara dair duyurular
    • Articles, People, and Places: Paylaşılan içerik makalelerinin başlığı, görselleri ve kısa açıklamaları
    • Campgrounds: Ulusal park kamp alanlarının konumu, iletişim bilgileri, çalışma saatleri, tesis olanakları, ücretleri ve erişilebilirlik bilgileri
    • Events: Ulusal park etkinliklerinin tarihi, saati, ücreti ve açıklaması
    • Lesson Plans: Öğretmenlerin derste kullanabileceği ulusal parkla ilgili ders planlarının hedefleri, sınıf düzeyi, ders konusu, süre ve standart bilgileri
    • News Releases: Ulusal park basın bültenlerinin başlığı, özeti, bağlantısı ve isteğe bağlı görselleri
    • Parks: Her ulusal parkın konumu, iletişim bilgileri, çalışma saatleri, giriş ücreti ve geçiş kartı bilgileri ile park başına en az 5 fotoğraf
    • Visitor Centers: Ulusal park ziyaretçi merkezleri ve diğer ziyaretçi temas noktalarının konumu, iletişim bilgileri ve çalışma saatleri

Geliştirici başlangıç noktası ve yol haritası

  • Geliştiriciler NPS Data API website üzerinden API anahtarı kaydedebilir ve istek biçimleri ile API kaynaklarını inceleyebilir
  • Sonraki aşamada geliştirilen veya ek değerlendirme altında olan özellikler NPS API roadmap sayfasında görülebilir

İlgili okumalar

1 yorum

 
GN⁺ 2024-01-23
Hacker News yorumları

  • API’nin kendisi gerçekten harika, ancak bunu son kez sürdüren ekiple konuştuğumda muhtemelen 2020 civarıydı; o zaman bile ekip yetersizdi ve ancak hata düzeltmeleri yapabilecek durumdaydı.
    Yol haritası da 2017’den beri güncellenmemiş, bu yüzden pratikte ne kadar işe yarayacağı duruma göre değişebilir.

    • Sayfanın altındaki sorumluluk reddi metnine göre NPS API yol haritasındaki bilgiler yalnızca referans amaçlı ve bağlayıcı bir taahhüt olarak buna güvenilmemesi gerektiği yazıyor.
      2017’den beri bakım modunda olması sorun değil. Arayüzü Jquery UI ile yapmayı planlıyoruz.
    • Bildirim özelliği fena değil, ama geri kalanların çoğu ziyaretçi merkezleri veya ders planları gibi statik veriler; API olmasına gerek yok, statik JSON dosyaları yeterli görünüyor.
      Kamp alanları da yalnızca statik veri sunuyor. API olarak faydalı olması için kamp yeri müsaitliğini göstermesi ve rezervasyon endpoint’i de sunması gerekir.
      Canlı ayı tasması takibi gibi API erişimleri bekliyordum. Bir ayının hareket rotası benim yürüyüş rotamla kesişirse otomatik haber veren bir sistem yapmak isterim.
    • O ekibin iletişim bilgilerini bulabilir miyiz? NPS uygulaması şimdiye kadar kullandığım en iyi uygulamalardan biri; kimin yaptığını bilmek isterim.
    • Bu 18F’den çıkmış olabilir mi? Beyaz Saray tarafındaki gerçekten harika teknoloji ekibi değil miydi? O kadar çok dijital devlet bütçesi nereye gitti merak ediyorum.
    • Genel olarak öyle gibi. Bu tür işler için bütçe desteğinin iyi olmaması üzücü.

  • Bu verileri BigQuery’ye kopyaladım. Böylece Jupyter notebook’larından veya SQL sorgularından erişmek çok daha kolay oluyor.
    nps-public-data.nps_public_data

  • Böyle bir şeyin var olması güzel. Açık veri arşivi olan GitHub’ı da buldum. Bu API’yi ilginç şekilde kullanan mevcut projeler var mı?
    [1] https://github.com/nationalparkservice

    • GitHub’dakiler çoğunlukla eski depolar, ama Symbol Library hâlâ aktif. Geliştirici API’sinin kendisi mükemmel.

  • Yalnızca ulusal parklar listesine bakınca 61 tane varmış gibi görünüyor, ama gerçekte 63 tane.
    Wikipedia ile karşılaştırınca farkın nedeni, National Park of American Samoa için hiçbir sınıflandırmanın eksik olması ve Sequoia ve Kings Canyon’ın aynı park olarak gruplanmış olması.
    İlgili kayıt parkCode: seki olarak yüklenmiş.

  • Not olarak, daha fazla veriye ihtiyacınız varsa belgelenmemiş ama herkese açık API’ler var. Belirli NPS web sitelerini ziyaret edince görebilirsiniz.

    • Web sitesinde gezinirken API spesifikasyonunu otomatik oluşturan şu tür bir eklentiyi kullanmak için iyi bir örnek olabilir: https://github.com/AndrewWalsh/openapi-devtools
    • HTTP’nin de teknik olarak bir API olduğu şakası gibi duyuluyor. Yine de LLM etkisi de olduğundan giderek daha fazla web sitesi scraping’e karşı önlem alıyor; bu yüzden açıkça tanımlanmış API’ler gelecekte daha önemli ve kullanışlı olacak gibi.
    • Paylaşabilir misin?

  • Burada da çok iyi veri var: https://irma.nps.gov/Stats/
    Bunu kullanarak kendi ulusal park ziyaret görselleştirmemi yaptım: https://jordan-vincent.com/night-under-the-stars

  • Güzel. Cumartesi günü Blue Ridge Parkway’de hangi mil işaretlerinin kapalı olduğunu gösteren tabloyu parse ederken, kelimenin tam anlamıyla böyle bir şey olsa iyi olur diye düşünüyordum.

  • NPS API’de hâlâ rezervasyon API’si eksik. Geliştiricileri yeni ve faydalı deneyimler oluşturmaya çeken temel teşvik tam da buydu.

    • Rezervasyonların tamamı rec.gov üzerinden işleniyor.
    • Bunun kasıtlı olduğunu düşünüyorum. Aklıma birkaç neden geliyor.

  • Ziyaretçi istatistikleri görünmüyor gibi. Yapacak bir şey yok. Geçmiş ziyaretçi verileri burada: https://irma.nps.gov/Stats/SSRSReports/Park%20Specific%20Rep...