Nhà phát triển
API dữ liệu mở
JSON chỉ đọc cho toàn bộ nội dung trong atlas. Không cần khóa API, không cần tài khoản, không theo dõi. Hãy hợp lý về lượng yêu cầu gửi đi — đây là máy chủ nhỏ.
| Điểm cuối | Lợi nhuận |
|---|---|
/api/v1/materials | Mọi vật liệu kèm danh mục, cờ tới hạn, sản lượng thế giới và trữ lượng. |
/api/v1/material/{slug} | Một vật liệu toàn diện: dữ kiện, khoáng vật, sản lượng và trữ lượng theo quốc gia, mỏ, nhà máy, công ty, thị trường cuối và cường độ sử dụng. |
/api/v1/production?material={slug}&series= | Sản lượng thế giới theo quốc gia cho MỘT chuỗi đã công bố. Khi một vật liệu có nhiều hơn một chuỗi — đồng có sản lượng khai thác và sản lượng luyện kim — meta.all_series liệt kê chúng và tuyệt đối không được cộng lại. |
/api/v1/reserves?material={slug}&series= | Trữ lượng thế giới theo quốc gia cho một chuỗi. Crom, chẳng hạn, được công bố cả dưới dạng hàm lượng Cr2O3 lẫn dưới dạng quặng. |
/api/v1/mines | Các mỏ và mỏ quặng được đặt tên cùng với người vận hành, loại, trạng thái, vị trí và vật liệu. |
/api/v1/facilities | Các nhà máy chế biến, tinh luyện và sản xuất với công đoạn, loại hình và vật liệu. |
/api/v1/companies | Các công ty kèm theo vai trò, quốc gia, vật liệu và — khi có — giá trễ. |
/api/v1/countries | Các quốc gia kèm theo số lượng vật liệu và số lượng tài sản. |
/api/v1/chains | Các chuỗi cung ứng với từng giai đoạn và nút mà mỗi giai đoạn chỉ đến. |
/api/v1/journeys?material={slug}&origin={ISO2} | Hành trình lưu ký: mỗi hàng là một tuyến đường cụ thể, với đầy đủ từng công đoạn, người giám hộ, cửa khẩu biên giới và cân bằng khối lượng tại mỗi giai đoạn. |
/api/v1/journey/{slug} | Một hành trình đầy đủ, bao gồm cả các lộ trình thay thế có thể đã được thực hiện. |
/api/v1/technologies | Các công nghệ với cường độ vật liệu chỉ thị và cơ sở tương ứng. |
/api/v1/glossary | Mọi thuật ngữ trong bảng chú giải, định nghĩa thông thường và kỹ thuật. |
/api/v1/search?term= | Tìm kiếm theo vật liệu, mỏ, nhà máy, công ty, quốc gia và thuật ngữ. |
Quy ước
- Mỗi phản hồi đều có khối "nguồn" nêu tên bộ dữ liệu và phiên bản.
- Các trường số là null khi nguồn không công bố con số; khi đó trường "code" mang giá trị W, XX, NA hoặc dấu gạch ngang, và trường "note" giải thích lý do. Null không bao giờ có nghĩa là không.
- Mỗi hàng mang chuỗi mà nó thuộc về. Hai chuỗi của cùng một vật liệu đo các đại lượng khác nhau và tuyệt đối không được cộng lại với nhau.
- Đơn vị tính theo từng hàng, không theo từng điểm cuối — hàng hóa được báo cáo trên các cơ sở khác nhau.
- Các năm là năm tham chiếu của nguồn, không phải ngày chúng tôi tải dữ liệu.
Dữ liệu USGS gốc là tài sản công cộng; hãy sử dụng từ nguồn và trích dẫn nguồn đó. Bản tổng hợp của chúng tôi là của chúng tôi — chúng tôi đánh giá cao việc dẫn liên kết ngược. Không có nội dung nào trên đây là tư vấn đầu tư.