API do Serviço Nacional de Parques dos EUA

 (nps.gov)
1 pontos por GN⁺ 2024-01-23 | 1 comentários | Compartilhar no WhatsApp
  • Desenvolvedores que queiram usar dados de parques nacionais em apps, mapas e sites podem obter dados oficiais diretamente pela NPS Data API
  • Os mesmos dados e conteúdos podem ser reutilizados não apenas no NPS.gov, mas também em produtos de desenvolvedores internos e externos, permitindo fornecer informações consistentes
  • O escopo inclui amplamente informações de visitação, educação e operação, como alertas de parques, campings, eventos, planos de aula, comunicados à imprensa e centros de visitantes
  • Após registrar uma chave de API, os desenvolvedores podem verificar o formato das requisições e os recursos para iniciar a integração
  • Itens que serão adicionados no futuro podem ser consultados no roadmap da API do NPS, permitindo que equipes que criam serviços relacionados antecipem os planos de expansão dos dados

O papel da NPS Data API

  • A NPS Data API está aberta a qualquer desenvolvedor que queira usar dados do NPS em seus projetos
  • Uma API é um conjunto de requisitos para que uma aplicação se comunique com outra
  • A NPS Data API permite criar os dados uma vez e reutilizá-los repetidamente em vários produtos
    • Os usos incluem NPS.gov, desenvolvedores internos e apps, mapas e sites de desenvolvedores externos
    • Independentemente de quem cria o produto, os mesmos dados e conteúdos podem ser reutilizados

Dados disponíveis

  • Na documentação da API do NPS, é possível conferir os tipos de dados oferecidos
    • Alerts: avisos sobre riscos, perigos potenciais e mudanças de condições que podem afetar a visita a parques nacionais
    • Articles, People, and Places: títulos, imagens e descrições curtas de artigos de conteúdo compartilhável
    • Campgrounds: localização, contato, horário de funcionamento, comodidades, tarifas e informações de acessibilidade de campings em parques nacionais
    • Events: data, hora, tarifa e descrição de eventos em parques nacionais
    • Lesson Plans: objetivos, série escolar, disciplina, duração e informações de padrões de planos de aula sobre parques nacionais que professores podem usar em sala
    • News Releases: título, resumo, link e imagem opcional de comunicados à imprensa de parques nacionais
    • Parks: localização, contato, horário de funcionamento, informações sobre ingressos e passes, além de no mínimo 5 fotos de cada parque nacional
    • Visitor Centers: localização, contato e horário de funcionamento de centros de visitantes e outras instalações de atendimento ao visitante em parques nacionais

Ponto de partida para desenvolvedores e roadmap

  • Desenvolvedores podem registrar uma chave de API no site da NPS Data API e verificar o formato das requisições e os recursos da API
  • Os recursos que estão em desenvolvimento ou sob análise para adição podem ser vistos no roadmap da API do NPS

Leituras relacionadas

1 comentários

 
GN⁺ 2024-01-23
Comentários no Hacker News

  • A API em si é muito legal, mas a última vez que conversei com a equipe que a mantinha foi provavelmente por volta de 2020, e eles já estavam com falta de pessoal, em um estado em que só conseguiam fazer correções de bugs
    O roadmap também não é atualizado desde 2017, então a utilidade na prática pode variar conforme a situação

    • Segundo o aviso legal no rodapé da página, as informações do roadmap da API do NPS são apenas para referência e não devem ser tratadas como um compromisso vinculante
      Tudo bem ela estar em modo de manutenção desde 2017. O plano é fazer a interface com Jquery UI
    • O recurso de alertas é bom, mas a maior parte do restante são dados estáticos, como centros de visitantes ou planos de aula, então não parece precisar ser uma API; arquivos JSON estáticos bastariam
      Os campings também oferecem apenas dados estáticos. Para ser útil como API, ela teria que mostrar disponibilidade de locais de acampamento e oferecer até endpoints de reserva
      Eu esperava algum acesso via API a coisas como rastreamento de coleiras de ursos vivos. Quero criar um sistema que me avise automaticamente se a rota de deslocamento de um urso cruzar com minha trilha
    • Dá para conseguir o contato dessa equipe? O app do NPS é um dos melhores apps que já usei, então queria saber quem o criou
    • Isso não veio da 18F? Não era aquela equipe de tecnologia realmente incrível ligada à Casa Branca? Fico me perguntando para onde foi todo aquele orçamento de governo digital
    • No geral, acho que deve ser isso mesmo. É uma pena que o apoio orçamentário para esse tipo de trabalho não seja bom

  • Copiei esses dados para o BigQuery. Assim eles ficam muito mais fáceis de acessar em notebooks Jupyter ou consultas SQL
    nps-public-data.nps_public_data

  • Que bom que isso existe. Também encontrei o GitHub com o arquivo de dados públicos. Será que existem projetos atuais que usem essa API de forma interessante?
    [1] https://github.com/nationalparkservice

    • O GitHub tem principalmente repositórios antigos, mas a Symbol Library ainda está ativa. A API para desenvolvedores em si é excelente

  • Olhando só a lista de parques nacionais, parece haver apenas 61, mas na verdade são 63
    Comparando com a Wikipedia, a diferença acontece porque falta qualquer designação no National Park of American Samoa, e Sequoia e Kings Canyon estão agrupados como um único parque
    Esse item aparece com parkCode: seki

  • Para referência, se você precisar de mais dados, existem APIs públicas, embora não documentadas. Dá para vê-las ao visitar sites específicos do NPS

    • Pode ser um bom caso de uso para esta extensão, que gera automaticamente uma especificação de API enquanto você navega pelo site: https://github.com/AndrewWalsh/openapi-devtools
    • Também soa como a piada de que HTTP, tecnicamente, também é uma API. Ainda assim, com a influência dos LLMs, cada vez mais sites estão combatendo scraping, então acho que APIs explícitas ficarão ainda mais importantes e úteis daqui para frente
    • Você pode compartilhar?

  • Também há muitos dados bons aqui: https://irma.nps.gov/Stats/
    Usei isso para criar minha visualização de visitas a parques nacionais: https://jordan-vincent.com/night-under-the-stars

  • Legal. No sábado eu estava analisando uma tabela para ver quais marcos de milha estavam fechados na Blue Ridge Parkway e literalmente estava pensando que seria bom se existisse algo assim

  • Ainda falta uma API de reservas na API do NPS. Esse era justamente o principal incentivo para atrair desenvolvedores a criar experiências novas e úteis

    • Todas as reservas são processadas pelo rec.gov
    • Acho que isso é intencional. Consigo imaginar vários motivos

  • Não parece haver estatísticas de visitantes. Fazer o quê. Dados históricos de visitação estão aqui: https://irma.nps.gov/Stats/SSRSReports/Park%20Specific%20Rep...