Grib Converter

File conversion API that extracts data from GRIB, JSON, CSV, NetCDF, or Excel files and converts it into JSON, CSV, NetCDF, or Excel formats. Supports parameter filtering and Excel sheet splitting.

原始信息汇总

GRIB Converter API 数据集概述

基本描述

GRIB Conversion API 旨在简化对 GRIB（GRIdded Binary）气象和气候数据文件的处理。该格式广泛应用于天气预报、气候建模和大气研究，但缺乏专业工具则难以处理。此 API 提供了易于使用的端点，用于文件转换和检查。

核心功能

• 文件格式转换：将 GRIB 文件转换为 JSON、CSV、NetCDF 或 XLSX 格式。
• 数据变量过滤：在转换过程中，可以指定要包含的参数列表，或定义要排除的参数列表，从而精细控制输出数据。
• 文件结构检查：在转换前，可检索文件中的所有可用列/参数，以及获取数据集维度（行数和列数）。

适用场景

• 需要为分析预处理 GRIB 数据的研究人员和科学家。
• 希望将天气或气候数据集成到应用程序中的开发人员。
• 偏好使用 Excel、CSV 或 JSON 等工具而非原始 GRIB 文件的数据分析师。
• 需要将 GRIB 数据转换为结构化格式的自动化脚本和机器学习管道。

技术规格与限制

• 最大推荐文件大小：50 MB。更大的文件可能导致超时或内存问题。
• 支持的文件扩展名：仅支持 .grib 扩展名。

端点详情

1. POST /GribConvert/Convert

功能：上传 GRIB 文件并将其转换为支持的格式之一。 请求参数：

参数名	类型	必需	描述
file	File	是	要转换的 .grib 文件。
output_format	String	是	输出格式。可选值："json"、"csv"、"netcdf"、"xlsx"。
params	String	否	要包含在输出中的参数名称的逗号分隔列表。示例："t2m,sp"。
exclude_params	String	否	要从输出中排除的参数名称的逗号分隔列表。示例："q,latitude"。
max_rows_per_sheet	Number	否	仅适用于 XLSX 格式。每个 Excel 工作表的最大行数。如果设置，输出将跨多个工作表拆分。

注意事项：

• params 或 exclude_params 可以选用其一，但不能同时使用。
• 如果两者均未提供，则包含所有列。
• 如果未提供 max_rows_per_sheet（仅限 XLSX），所有数据将写入单个工作表。

响应格式：

output_format	响应类型	Content-Disposition	示例文件名
json	文件下载 (.json)	attachment; filename=converted.json	converted.json
csv	文件下载 (.csv)	attachment; filename=converted.csv	converted.csv
netcdf	文件下载 (.nc)	attachment; filename=converted.nc	converted.nc
xlsx	文件下载 (.xlsx)	attachment; filename=converted.xlsx	converted.xlsx

成功响应：返回 200 OK。 错误响应：

状态码	含义	示例消息
400	错误请求	"Only files with the .grib extension are supported"
400	参数错误	"The requested parameters were not found in the file: t2m, v10"
400	XLSX 行数约束错误	"Parameter max_rows_per_sheet must be a positive integer"
500	处理错误	"Error processing the file: <details>"

2. POST /GribConvert/GetColumns

功能：读取 GRIB 文件并返回数据集中所有可用列（参数）的列表。 请求参数：

参数名	类型	必需	描述
file	UploadFile	是	要上传的 .grib 文件。

响应：

字段	类型	描述
columns	array	所有可用参数名称/字段的 JSON 数组。

示例响应： json { "columns": ["time", "latitude", "longitude", "t2m", "sp"] }

错误响应：

状态码	含义	示例消息
400	错误请求	"Only files with the .grib extension are supported"
500	处理错误	"Error processing the file: <details>"

3. POST /GribConvert/GetShape

功能：读取 GRIB 文件并以 Pandas DataFrame 的形式返回底层数据集的形状（行数和列数）。 请求参数：

参数名	类型	必需	描述
file	UploadFile	是	要上传的 .grib 文件。

响应：

字段	类型	描述
rows	int	数据集中的行数。
columns	int	数据集中的列数。

错误响应：

状态码	含义	示例消息
400	错误请求	"Only files with the .grib extension are supported"
500	处理错误	"Error processing the file: <details>"

订阅计划

• BASIC: $0.00 / 月
• PRO: $5.99 / 月
• ULTRA: $15.99 / 月
• MEGA: $55.99 / 月

提供商信息

• API 创建者: Diana
• 订阅者数量: 3
• 类别: Weather

搜集汇总

背景与挑战

背景概述

Grib Converter是一个文件格式转换API，支持GRIB/JSON/CSV/NetCDF/Excel等格式互转，提供参数过滤及Excel分表功能。