Promotores
API de dados abertos
JSON somente leitura sobre tudo no atlas. Sem chave, sem conta, sem rastreamento. Seja razoável com o volume de requisições — é um servidor pequeno.
| Ponto final | Retornos |
|---|---|
/api/v1/materials | Todos os materiais com a respetiva secção, indicador de criticalidade, produção mundial e reservas. |
/api/v1/material/{slug} | Um material completo: factos, minerais, produção e reservas por país, minas, instalações, empresas, mercados finais e intensidades. |
/api/v1/production?material={slug}&series= | Produção mundial por país para UMA série publicada. Quando um material tem mais de uma — o cobre tem produção mineira e produção de refinaria — meta.all_series lista-as e nunca devem ser adicionadas. |
/api/v1/reserves?material={slug}&series= | Reservas mundiais por país para uma série. O crómio, por exemplo, é publicado tanto como teor de Cr2O3 como em termos de minério. |
/api/v1/mines | Minas e depósitos identificados, com operador, tipo, situação, localização e materiais. |
/api/v1/facilities | Plantas de processamento, refinação e fabrico, com fase, tipo e materiais. |
/api/v1/companies | Empresas com papel, país, materiais e — onde disponível — cotação com atraso. |
/api/v1/countries | Países com as respetivas contagens de materiais e ativos. |
/api/v1/chains | Cadeias de abastecimento com todas as etapas e o nó para o qual cada etapa aponta. |
/api/v1/journeys?material={slug}&origin={ISO2} | Trajetos de custódia: uma rota específica por linha, com cada etapa, custodiante, cruzamento de fronteira e o balanço de massa em cada estágio. |
/api/v1/journey/{slug} | Uma jornada completa, incluindo as alternativas que poderia ter seguido. |
/api/v1/technologies | Tecnologias com as respetivas intensidades de materiais indicativas e bases. |
/api/v1/glossary | Todos os termos do glossário, definições simples e técnicas. |
/api/v1/search?term= | Pesquise materiais, minas, instalações, empresas, países e termos. |
Convenções
- Cada resposta inclui um bloco "fonte" que identifica o conjunto de dados e a edição.
- Os campos numéricos são nulos quando a fonte não publicou nenhum valor; um campo "code" apresenta então W, XX, NA ou um travessão, e um campo "note" explica qual. Nulo nunca significa zero.
- Cada linha pertence à série correspondente. Duas séries do mesmo material medem coisas diferentes e não devem ser somadas.
- As unidades são por linha, não por extremidade — as matérias-primas são comunicadas em bases diferentes.
- Os anos são os anos de referência da fonte, não a data em que os dados foram obtidos.
Os dados subjacentes do USGS são de domínio público; utilize-os a partir da fonte e cite-a. Nossa compilação é nossa — um link de referência é bem-vindo. Nada disponibilizado aqui constitui conselho de investimento.