Разработчики
API открытых данных
JSON только для чтения по всему содержимому атласа. Без ключа, без учётной записи, без отслеживания. Соблюдайте разумный объём запросов — это небольшой сервер.
| Конечная точка | Возвраты |
|---|---|
/api/v1/materials | Все материалы с их разделом, флагом критичности, мировым производством и запасами. |
/api/v1/material/{slug} | Один материал в полном объёме: факты, минералы, производство и запасы по странам, месторождения, предприятия, компании, конечные рынки и интенсивность использования. |
/api/v1/production?material={slug}&series= | Мировое производство по странам для ОДНОЙ опубликованной серии. Если по материалу имеется более одной серии — например, для меди это производство на горнодобывающих предприятиях и производство на аффинажных заводах — они перечислены в meta.all_series и их нельзя складывать. |
/api/v1/reserves?material={slug}&series= | Мировые запасы по странам для одной серии. Например, данные по хрому публикуются как в пересчёте на Cr2O3, так и в пересчёте на руду. |
/api/v1/mines | Именованные рудники и месторождения с указанием оператора, типа, статуса, местоположения и материалов. |
/api/v1/facilities | Заводы по переработке, рафинированию и производству с указанием стадии, типа и материалов. |
/api/v1/companies | Компании с указанием роли, страны, материалов и — при наличии — отложенной котировки. |
/api/v1/countries | Страны с количеством материалов и активов. |
/api/v1/chains | Цепочки поставок со всеми стадиями и узлом, на который указывает каждая стадия. |
/api/v1/journeys?material={slug}&origin={ISO2} | Маршруты хранения: один конкретный маршрут на строку, с каждым этапом, хранителем, пограничным переходом и балансом масс на каждой стадии. |
/api/v1/journey/{slug} | Один полный маршрут, включая возможные альтернативные пути. |
/api/v1/technologies | Технологии с их ориентировочными материалоёмкостями и основаниями. |
/api/v1/glossary | Все термины глоссария — простые и технические определения. |
/api/v1/search?term= | Поиск по материалам, месторождениям, заводам, компаниям, странам и терминам. |
Условные обозначения
- Каждый ответ содержит блок «источник» с указанием набора данных и его издания.
- Числовые поля имеют значение null, если источник не опубликовал числа; в этом случае поле «code» содержит W, XX, NA или прочерк, а поле «note» поясняет причину. Null никогда не означает ноль.
- Каждая строка содержит серию, к которой она относится. Две серии по одному и тому же материалу измеряют разные показатели и не должны суммироваться.
- Единицы указаны для каждой строки, а не для конечных точек — сырьё представлено в разных единицах отчётности.
- Годы — это референсные годы источника, а не дата получения данных нами.
Исходные данные USGS находятся в общественном достоянии; используйте их из первоисточника и указывайте ссылку на него. Наша компиляция принадлежит нам — обратная ссылка приветствуется. Ничто из представленного здесь не является инвестиционной рекомендацией.