Sviluppatori
API dati aperti
JSON in sola lettura su tutto il contenuto dell'atlante. Nessuna chiave, nessun account, nessun tracciamento. Usare un volume di richieste ragionevole — si tratta di un server di piccole dimensioni.
| Punto finale | Ritorni |
|---|---|
/api/v1/materials | Ogni materiale con la sua sezione, l'indicatore di criticità, la produzione mondiale e le riserve. |
/api/v1/material/{slug} | Un materiale completo: dati, minerali, produzione e riserve per paese, miniere, impianti, aziende, mercati finali e intensità d'uso. |
/api/v1/production?material={slug}&series= | Produzione mondiale per paese per UNA serie pubblicata. Quando un materiale ne ha più di una — il rame ha la produzione mineraria e la produzione da raffineria — meta.all_series le elenca e non devono mai essere sommate. |
/api/v1/reserves?material={slug}&series= | Riserve mondiali per paese per una serie. Il cromo, ad esempio, è pubblicato sia come contenuto in Cr2O3 sia come minerale grezzo. |
/api/v1/mines | Miniere e giacimenti nominati con operatore, tipo, stato, ubicazione e materiali. |
/api/v1/facilities | Impianti di lavorazione, raffinazione e produzione con fase, tipologia e materiali. |
/api/v1/companies | Aziende con ruolo, paese, materiali e — dove disponibile — una quotazione in ritardo. |
/api/v1/countries | Paesi con il relativo numero di materiali e di asset. |
/api/v1/chains | Filiere produttive con ogni fase e il nodo a cui ciascuna fase fa riferimento. |
/api/v1/journeys?material={slug}&origin={ISO2} | Percorsi di custodia: un itinerario specifico per riga, con ogni fase, responsabile della custodia, attraversamento di frontiera e bilancio di massa per ciascuna tappa. |
/api/v1/journey/{slug} | Un percorso per intero, comprese le alternative che avrebbe potuto seguire. |
/api/v1/technologies | Tecnologie con le rispettive intensità di materiale indicative e basi. |
/api/v1/glossary | Ogni termine del glossario, definizioni semplici e tecniche. |
/api/v1/search?term= | Cerca tra materiali, miniere, impianti, aziende, paesi e termini. |
Convenzioni
- Ogni risposta contiene un blocco "source" che indica il dataset e l'edizione.
- I campi numerici sono nulli quando la fonte non ha pubblicato alcun valore; un campo «code» riporta in quel caso W, XX, NA o un trattino, e una «note» spiega quale. Nullo non significa mai zero.
- Ogni riga riporta la serie cui appartiene. Due serie dello stesso materiale misurano grandezze diverse e non devono essere sommate.
- Le unità si riferiscono a ciascuna riga, non agli endpoint — le materie prime sono riportate su basi diverse.
- Gli anni indicati sono gli anni di riferimento della fonte, non la data in cui i dati sono stati acquisiti.
I dati USGS sottostanti sono di pubblico dominio; utilizzarli dalla fonte e citarla. La nostra compilazione è di nostra proprietà — un link di rimando è gradito. Nulla di quanto pubblicato qui costituisce consulenza in materia di investimenti.