🥮 mooncakes.io

    moonstac

    MoonBit STAC Item Search core with a Node.js CLI

    stac
    geospatial
    catalog
    search
    Download zip
    Version
    0.1.0
    License
    Apache-2.0
    Repository
    Last updated
    4 hours ago
    Downloads
    3

    No dependencies

    #MoonSTAC

    MoonBit 编写的 STAC Item Search 核心与 Node.js 命令行工具。输入空间范围、时间和集合，向 STAC API /search 发送 GET 或 POST 请求，逐页读取 ItemCollection，提取 Item ID、集合、时间和资产链接。JSON 解析、结构检查、查询体构造及 next 链接解释由 MoonBit 完成；Node.js 负责 HTTP 和文件 I/O。

    状态：公开开发预览。 源码已发布在 GitHub。当前实现支持 STAC Item 1.0.0/1.1.0 的一部分核心结构检查，不是完整 JSON Schema 验证器，也未获得 OGC 认证。已在 Earth Search 公网 API 验证入口发现、集合浏览、GET、POST 和两页查询，详见验证记录。

    #快速开始

    需要 MoonBit 工具链与 Node.js 20 或更新版本。

    moon test
npm test
node cli.mjs validate test-fixtures/one-page.json
node cli.mjs discover --url https://earth-search.aws.element84.com/v1/
node cli.mjs collections --url https://earth-search.aws.element84.com/v1/collections
node cli.mjs search --url https://earth-search.aws.element84.com/v1/search --bbox 120,30,121,31 --collection sentinel-2-l2a --limit 2 --max-pages 2
node cli.mjs search --url https://earth-search.aws.element84.com/v1/search --bbox 120,30,121,31 --collection sentinel-2-l2a --method POST --filter-file test-fixtures/cloud-cover-filter.json --limit 1

    npm test 会先编译 MoonBit JS 桥接模块。首次单独运行 CLI 之前先执行 npm run build。上面的在线查询已实际执行过。search 输出 JSON，其中 items 为扁平列表，pages 为实际读取页数，hasMore 表示达到页数上限时仍有下一页。

    search 可用参数：--url、--bbox west,south,east,north、--datetime、可重复的 --collection、可重复的 --id、--filter-file、--limit、--method GET|POST、--max-pages。--bbox 可省略，例如仅按 Item ID 查询。--filter-file 读取 CQL2 JSON 表达式，需搭配 --method POST。默认 GET、每页 10 条、最多 5 页。--url 指向具体的 /search 端点。collections 使用 --url 和可选 --max-pages。分页默认只允许同源 URL；如确需访问跨源 next 链接，可显式指定 --allow-cross-origin true。命令不会下载资产文件。

    #支持范围

    • 解析 ItemCollection / STAC Item，检查 stac_version、type、id、GeoJSON 几何坐标层级与多边形闭合、bbox、RFC 3339 时间或时间区间、links、assets[*].href 等关键结构；输出保留几何和完整 properties。
    • 解析 STAC API 根目录与 Collections 页，发现搜索/集合入口并列出集合 ID、标题、说明、许可。
    • 生成包含可选 bbox、datetime、collections、ids、limit 的 Item Search 请求；验证经纬度范围和边界框顺序。
    • 支持一组明确的 CQL2 JSON 操作符（比较、between、and、or、not），可按 eo:cloud_cover 等 Item 属性过滤；不支持的操作符会明确报错。
    • 处理 GET/POST next 链接、相对地址、body、headers 和 merge；限制页数并检测重复请求。
    • MoonBit 公共 API：parse_item、parse_page、parse_landing、parse_collections、search_body；JS 桥接 API：search_request、page_summary、landing_summary、collections_summary。

    当前不检查 GeoJSON 自交与环方向、扩展 Schema、所有 STAC Item 字段语义，也不支持完整 CQL2、intersects、排序或字段选择。资产链接保持 API 原始值，可能是相对路径。API 认证及速率限制由调用环境处理。不要把 validate 的通过结果视为完整 STAC 合规证明。

    #选题与依据

    STAC 是地理空间影像和其他时空资产的目录规范；Item Search API 定义跨集合搜索和分页。项目价值在于给 MoonBit 应用提供可复用的数据目录入口，并让查询与解析核心跨目标复用。2026-11-10 对 MoonBit 生态索引和公开搜索的初步检索未找到同名或直接等价的 MoonBit STAC API 客户端；公开检索不涵盖未公开申报或未被索引的项目，不能保证赛事查重通过。详见选题与风险记录。

    规范来源：OGC STAC API 1.0、STAC Filter 扩展、STAC Item 1.0.0 Schema、STAC Item 1.1.0 Schema。许可：Apache-2.0。

    StacError

    source
    pub(all) suberror StacError {
      Invalid(String)
    } derive(
    Debug    )

    Asset

    source
    pub(all) struct Asset {
      key : String
      href : String
    } derive(Eq, 
    Debug    )

    Collection

    source
    pub(all) struct Collection {
      id : String
      title : String?
      description : String
      license : String
    } derive(Eq, 
    Debug    )

    CollectionPage

    source
    pub(all) struct CollectionPage {
      collections : Array[Collection]
      next : String?
    } derive(Eq, 
    Debug    )

    Item

    source
    pub(all) struct Item {
      id : String
      collection : String?
      datetime : String?
      geometry : 
    Json
      bbox : 
    Json    ?
      properties : 
    Json
      assets : Array[Asset]
    } derive(Eq, 
    Debug    )

    ItemPage

    source
    pub(all) struct ItemPage {
      items : Array[Item]
      next : NextLink?
    } derive(Eq, 
    Debug    )

    Landing

    source
    pub(all) struct Landing {
      id : String
      description : String
      search : String?
      collections : String?
      conforms_to : Array[String]
    } derive(Eq, 
    Debug    )

    pub(all) struct NextLink {
      href : String
      http_method : String
      body : 
    Json    ?
      headers : 
    Json    ?
      merge : Bool
    } derive(Eq, 
    Debug    )

    collections_summary

    source
    fn collections_summary(input : String) -> String

    landing_summary

    source
    fn landing_summary(input : String) -> String

    page_summary

    source
    fn page_summary(input : String) -> String

    parse_collections

    source
    fn parse_collections(text : String) -> CollectionPage raise StacError

    parse_item

    source
    fn parse_item(text : String) -> Item raise StacError

    parse_item_json

    source
    fn parse_item_json(v : 
    Json    ) -> Item raise StacError

    parse_landing

    source
    fn parse_landing(text : String) -> Landing raise StacError

    parse_page

    source
    fn parse_page(text : String) -> ItemPage raise StacError

    search_body

    source
    fn search_body(bbox : Array[Double], datetime : String?, collections : Array[String], limit : Int) -> String raise StacError

    search_request

    source
    fn search_request(input : String) -> String

    Source Files