地图流API

注解

阅读文档并查看此“Postman API 集合 <https://documenter.getpostman.com/view/5400715/TzmCiu5h>”中的示例。

参见

Python 命令行界面

下载并安装 Mapflow python CLI 以查询 API 并运行脚本`Mapflow CLI Tool <https://github.com/Geoalert/mapflow-api-scripts>`_。

Mapflow API 授权

要从外部应用程序访问，例如:doc:QGIS 插件 <../api/qgis_mapflow>，您需要获取 API 令牌。用户可以在`https://app.mapflow.ai/account/api <https://app.mapflow.ai/account/api>`_注册并获取令牌。令牌必须在 Basic Auth 参数中传递，如示例所示：

curl --location --request GET 'https://api.mapflow.ai/rest/projects/default' \
--header 'Authorization: Basic <YOUR TOKEN>'

注解

您的令牌是根据请求生成的，由“<Email: API Token>”组成

您可以使用 base64 解码器 <https://www.base64decoder.io/>`_ 对其进行解码，以在基本身份验证表单中使用

请务必保存令牌，否则您将需要重新颁发它。

获取API令牌

  1. 打开 Web 应用程序“Mapflow <https://app.mapflow.ai>”_。注册新帐户或使用您的 Google 帐户登录。

  2. 转到“用户配置文件设置 <https://app.mapflow.ai/account>”_ 以生成新的 API 令牌。

预览地图

地图流处理 API

Mapflow处理API使您能够对卫星和航空图像运行人工智能驱动的地理空间分析。用它来大规模检测建筑物、道路、森林等。

注意

通过 API 创建的项目和处理与“Mapflow.ai <https://app.mapflow.ai/>”同步。 API 调用会消耗您的 Mapflow 积分。

基本网址

https://api.mapflow.ai/rest

验证

所有 API 请求都需要 API 令牌。在“配置文件设置 <https://app.mapflow.ai/account>”中生成您的配置文件设置。

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.mapflow.ai/rest/user/status

有关详细信息，请参阅:doc:授权指南 <../userguides/mapflow_auth>。

快速入门

分 3 步运行您的第一个处理：

  1. 创建一个项目

    curl -X POST https://api.mapflow.ai/rest/projects \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Project",
    "description": "Buildings detection"
  }'

    响应：{“id”：“project-uuid”，...}

  2. 创建并运行处理

    curl -X POST https://api.mapflow.ai/rest/processings/v2 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Downtown Buildings",
    "projectId": "project-uuid",
    "wdName": "🏠 Buildings",
    "geometry": {
      "type": "Polygon",
      "coordinates": [[
        [37.6156, 55.7558],
        [37.6256, 55.7558],
        [37.6256, 55.7608],
        [37.6156, 55.7608],
        [37.6156, 55.7558]
      ]]
    },
    "params": {
      "sourceParams": {
        "dataProvider": {
          "providerName": "Mapbox",
          "zoom": 18
        }
      }
    }
  }'

    响应：{“id”：“processing-uuid”，“status”：“IN_PROGRESS”，...}

  3. 检查状态和下载结果

    # Check status
curl https://api.mapflow.ai/rest/processings/{processing-uuid}/v2 \
  -H "Authorization: Bearer YOUR_TOKEN"

# Download results (when status = "OK")
curl https://api.mapflow.ai/rest/processings/{processing-uuid}/result \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -o results.geojson

后续步骤： 探索可用模型 <模型要求>`，上传自定义图像 <upload-images>`，或查看:ref:完整 API 参考 <api-reference>。

地图流数据 API

Mapflow Data API 使您能够管理自定义图像、将其组织成马赛克以及从外部提供商搜索卫星图像。通过处理 API <processing_api>` 使用您的图像进行 AI 支持的分析。

注解

邮递员收藏

尝试我们的“Postman Collection <https://documenter.getpostman.com/view/5400715/2s935hS7ky>”_进行交互式 API 测试。

基本网址

https://api.mapflow.ai/rest

验证

所有 API 请求都需要 API 令牌。在“配置文件设置 <https://app.mapflow.ai/account>”中生成您的配置文件设置。

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.mapflow.ai/rest/rasters/memory

有关详细信息，请参阅:doc:授权指南 <../userguides/mapflow_auth>。

快速入门

只需 3 个步骤即可上传和处理您的图像：

  1. 创建马赛克

    curl -X POST https://api.mapflow.ai/rest/rasters/mosaic \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Aerial Survey", "tags": ["survey-2024"]}'

    响应：{“id”：“mosaic-uuid”，...}

  2. 上传图片到马赛克

    curl -X POST https://api.mapflow.ai/rest/rasters/mosaic/{mosaic-uuid}/image \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/orthophoto.tif"

    响应：{“id”：“image-uuid”，...}

  3. 使用上传的图像运行处理

    curl -X POST https://api.mapflow.ai/rest/processings/v2 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Building Detection",
    "projectId": "project-uuid",
    "wdName": "🏠 Buildings",
    "geometry": {...},
    "params": {
      "sourceParams": {
        "myImagery": {"mosaicId": "mosaic-uuid"}
      }
    }
  }'

后续步骤： 探索:ref:卫星图像搜索 <imagery-search>、管理:ref:存储限制 <storage-management>，或查看:ref:完整的 API 参考 <api-reference>。

有关完整的 API 参考文档（包括所有端点、参数和示例），请参阅 api-reference。

API参考

项目

创建项目

POST /项目

创建一个新的项目容器用于组织处理。

范围

类型

必需的

描述

名字

细绳

是的

项目名称

描述

细绳

不

项目描述

请求示例

{
  "name": "Urban Analysis 2026",
  "description": "Building footprints for city planning"
}

响应示例

{
  "id": "546d148f-19a1-40d8-8f16-d1e6dabfd204",
  "name": "Urban Analysis 2026",
  "description": "Building footprints for city planning"
}

更新项目

PUT /projects/{projectId}

更新项目名称和/或描述。

范围

类型

必需的

描述

项目ID

细绳

是的

项目UUID（路径参数）

名字

细绳

不

新项目名称

描述

细绳

不

新项目描述

请求示例

{
  "name": "Urban Analysis 2026 - Updated",
  "description": "Building and road detection"
}

加工

注解

**推荐使用v2 API。**它使用结构化的``sourceParams``和``inferenceParams``。 v1 使用平面“params”映射并进行维护以实现向后兼容性。

创建处理 (v2)

POST /processings/v2

创建并运行图像分析处理。

范围

类型

必需的

描述

名字

细绳

是的

加工名称

项目ID

细绳

是的

项目UUID

wdId 或 wdName

细绳

是的

工作流定义 ID 或名称（例如“🏠 建筑物”）

几何

地理JSON

是的

感兴趣的区域（多边形或多多边形）

params.sourceParams

目的

是的

图像源配置（请参阅：ref:source-params）

params.inferenceParams

目的

不

特定型号参数

块

大批

不

启用/禁用工作流程步骤（请参阅：ref:workflow-blocks）

描述

细绳

不

加工说明

元

目的

不

自定义元数据

示例请求：使用 Mapbox

{
  "name": "Downtown Buildings",
  "projectId": "546d148f-19a1-40d8-8f16-d1e6dabfd204",
  "wdName": "🏠 Buildings",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[37.615, 55.755], [37.625, 55.755],
                     [37.625, 55.760], [37.615, 55.760],
                     [37.615, 55.755]]]
  },
  "params": {
    "sourceParams": {
      "dataProvider": {
        "providerName": "Mapbox",
        "zoom": 18
      }
    }
  }
}

请求示例：使用自定义图像

{
  "name": "Aerial Survey 2026",
  "projectId": "546d148f-19a1-40d8-8f16-d1e6dabfd204",
  "wdName": "🏠 Buildings",
  "geometry": {"type": "Polygon", "coordinates": [...]},
  "params": {
    "sourceParams": {
      "myImagery": {
        "imageIds": ["0c26a0d3-96d8-4ed5-aa62-3843d1d7905c"]
      }
    }
  }
}

响应示例

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Downtown Buildings",
  "status": "IN_PROGRESS",
  "percentCompleted": 0,
  "cost": 150,
  "created": "2026-02-10T10:30:00Z"
}

获取处理 (v2)

GET /processings/{processingId}/v2

检索处理状态和详细信息。

范围

类型

必需的

描述

处理ID

细绳

是的

处理UUID（路径参数）

响应示例

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Downtown Buildings",
  "status": "OK",
  "percentCompleted": 100,
  "area": 1200000,
  "cost": 150,
  "vectorLayer": {
    "id": "layer-uuid",
    "tileUrl": "https://app.mapflow.ai/api/layers/{z}/{x}/{y}.pbf"
  },
  "created": "2026-02-10T10:30:00Z",
  "updated": "2026-02-10T10:45:00Z"
}

**状态值：**未处理、IN_PROGRESS、正在等待、确定、失败、已取消

列表处理 (v2)

GET /processings/v2

列出所有用户处理。

响应示例

[
  {
    "id": "uuid-1",
    "name": "Processing 1",
    "projectId": "project-uuid",
    "status": "OK",
    "percentCompleted": 100
  },
  {
    "id": "uuid-2",
    "name": "Processing 2",
    "status": "IN_PROGRESS",
    "percentCompleted": 45
  }
]

按项目列出处理情况 (v2)

GET /projects/{projectId}/processings/v2

列出特定项目的处理。

计算成本 (v2)

**POST**``/处理/成本/v2``

运行前估计处理成本。

范围

类型

必需的

描述

wdId

细绳

是的

工作流程定义ID

几何

地理JSON

不*

感兴趣的领域

面积SqKm

数字

不*

面积以 km² 为单位（替代几何形状）

参数

目的

不

源和推理参数

块

大批

不

启用的工作流程块

注解

*提供“几何图形”或“面积SqKm”（或两者）。

请求示例

{
  "wdId": "8cb13006-a299-4df6-b47d-91bd63de947f",
  "areaSqKm": 1.5,
  "params": {
    "sourceParams": {
      "dataProvider": {"providerName": "Mapbox"}
    }
  }
}

响应示例

150

下载结果

GET /processings/{processingId}/result

下载 GeoJSON 格式的处理结果。

查询参数：

  • ``aoiId``（可选）- 将结果过滤到特定的 AOI

例子

curl https://api.mapflow.ai/rest/processings/{id}/result \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -o results.geojson

按 AOI 下载结果

GET /processings/{processingId}/结果?aoiId={aoiId}

按特定 AOI 将处理结果下载为 GeoJSON。

查询参数：

  • ``aoiId``（必需）- 用于过滤结果的 AOI ID

例子

curl "https://api.mapflow.ai/rest/processings/{id}/result?aoiId={aoiId}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -o results_aoi.geojson

加工管理

重新启动处理

POST /processings/{processingId}/restart

仅重新启动失败的分区。

更新处理

PUT /processings/{processingId}

{
  "name": "New name",
  "description": "Updated description",
  "projectId": "new-project-uuid"
}

删除处理

删除/处理/{processingId}

删除处理和所有子实体。

用户及账户

获取用户状态

GET /用户/状态

返回帐户详细信息、可用模型和工作流程定义。

响应示例

{
  "user": {
    "id": "user-uuid",
    "email": "user@example.com",
    "credits": 5000
  },
  "models": [
    {
      "id": "model-uuid",
      "name": "🏠 Buildings",
      "pricePerSqKm": 15.0,
      "blocks": [...]
    }
  ]
}

处理历史

POST /处理/统计

返回带有分页和过滤的处理历史记录。

查询参数：

  • type （可选）- 响应格式：JSON 或 CSV

请求正文：

范围

类型

描述

页面

整数

页码

每页

整数

每页项目数

排序

细绳

排序表达式（例如，"created:desc"）

过滤器

细绳

过滤表达式（例如，“status=OK”）

请求示例

{
  "page": 1,
  "perPage": 50,
  "sort": "created:desc",
  "filter": "status=OK"
}

数据来源

“sourceParams”对象指定从哪里获取图像。选择一个选项：

默认数据提供者

使用 Mapbox、ArcGIS 等内置提供程序。

{
  "sourceParams": {
    "dataProvider": {
      "providerName": "Mapbox",
      "zoom": 18
    }
  }
}

场地

描述

提供者名称

提供程序名称：Mapbox、arcgis_world_imagery 等。

缩放

缩放级别（0.5m 分辨率通常为 17-19）

我的意象

使用通过 Data API 上传的图像。

单张图像：

{
  "sourceParams": {
    "myImagery": {
      "imageIds": ["image-uuid"]
    }
  }
}

马赛克（多个图像）：

{
  "sourceParams": {
    "myImagery": {
      "imageIds": ["img1-uuid", "img2-uuid"],
      "mosaicId": "mosaic-uuid"
    }
  }
}

自定义网址

使用您自己的 XYZ/TMS/WMS 切片服务。

{
  "sourceParams": {
    "userDefined": {
      "sourceType": "XYZ",
      "url": "https://tiles.example.com/{z}/{x}/{y}.png",
      "zoom": 18,
      "crs": "EPSG:3857",
      "rasterLogin": "username",
      "rasterPassword": "password"
    }
  }
}

场地

类型

描述

源类型

细绳

“XYZ”、“TMS”、“QUADKEY”、“SENTINEL_L2A”、“LOCAL”

网址

细绳

平铺 URL 模板

缩放

整数

缩放级别

crs

细绳

坐标参考系统（例如，EPSG:3857）

光栅登录

细绳

可选的身份验证用户名

光栅密码

细绳

可选验证密码

上传自定义图像

  1. 使用 Data API 创建马赛克并上传图像

  2. 在``sourceParams.myImagery.imageIds``中引用上传的图像

{
  "params": {
    "sourceParams": {
      "myImagery": {
        "imageIds": ["uploaded-image-uuid"]
      }
    }
  }
}

数据接口

马赛克

**马赛克**是为处理和预览而组织的地理参考图像的集合。当处理覆盖一个区域的多个航拍图像或批处理大型正射图以优化云存储时，马赛克会很有帮助。

创建马赛克

POST /光栅/马赛克

创建一个空的马赛克集合。

请求正文

范围

类型

必需的

描述

名字

细绳

是的

马赛克名称

标签

大批

不

用于组织马赛克的标签

请求示例

curl -X POST https://api.mapflow.ai/rest/rasters/mosaic \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Aerial Survey 2024",
    "tags": ["agriculture", "spring"]
  }'

回复

{
  "id": "6ee95ae6-f26e-41bd-8cb1-39bea545119f",
  "name": "Aerial Survey 2024",
  "tags": ["agriculture", "spring"],
  "created_at": "2024-03-15T10:30:00Z"
}

获取马赛克

GET /rasters/mosaic/{mosaic_id}

按 ID 检索马赛克元数据。

回复

{
  "id": "6ee95ae6-f26e-41bd-8cb1-39bea545119f",
  "name": "Aerial Survey 2024",
  "tags": ["agriculture", "spring"],
  "created_at": "2024-03-15T10:30:00Z",
  "image_count": 15
}

更新马赛克

PUT /rasters/mosaic/{mosaic_id}

更新马赛克名称和标签。

请求正文

范围

类型

必需的

描述

名字

细绳

不

新马赛克名称

标签

大批

不

新标签列表（替换现有标签）

请求示例

curl -X PUT https://api.mapflow.ai/rest/rasters/mosaic/{mosaic_id} \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Survey Name",
    "tags": ["agriculture", "summer"]
  }'

将图像上传到马赛克

POST /rasters/mosaic/{mosaic_id}/image

将地理参考图像文件上传到现有马赛克。

注意

马赛克中的所有图像必须具有：

  • 相同坐标参考系（CRS）

  • 相同数量的带

  • 相同的空间分辨率

要求

  • 内容类型：multipart/form-data

  • 正文：带有图像文件的“file”字段

请求示例

curl -X POST https://api.mapflow.ai/rest/rasters/mosaic/{mosaic_id}/image \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/orthophoto.tif"

回复

{
  "id": "6ae7f9e9-da2d-41e0-b16f-83396003af57",
  "mosaic_id": "6ee95ae6-f26e-41bd-8cb1-39bea545119f",
  "filename": "orthophoto.tif",
  "file_size": 68417439,
  "uploaded_at": "2024-03-15T10:35:00Z"
}

创建马赛克并上传图像

POST /光栅/马赛克/图像？名称= {名称}＆标签= {标签1}＆标签= {标签2}

在单个请求中创建马赛克并上传图像。

请求示例

curl -X POST 'https://api.mapflow.ai/rest/rasters/mosaic/image?name=QuickSurvey&tags=test' \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/image.tif"

获取马赛克图像

GET /rasters/mosaic/{mosaic_id}/image

列出马赛克中的所有图像以及元数据。

回复

[
  {
    "id": "6ae7f9e9-da2d-41e0-b16f-83396003af57",
    "filename": "area-1101712.tif",
    "file_size": 68417439,
    "uploaded_at": "2024-03-15T10:35:00Z",
    "footprint": "POLYGON((1.9915 48.7643, ...))",
    "preview_url_s": "https://api.mapflow.ai/rest/rasters/image/{id}/preview/s",
    "preview_url_l": "https://api.mapflow.ai/rest/rasters/image/{id}/preview/l",
    "meta_data": {
      "crs": "EPSG:32631",
      "width": 5589,
      "height": 4079,
      "count": 3,
      "pixel_size": [0.3, 0.3]
    }
  }
]

删除马赛克

删除/光栅/马赛克/{mosaic_id}

删除马赛克及其所有链接的图像。

警告

此操作**不可逆转**。所有链接到马赛克的图像都将被永久删除。

请求示例

curl -X DELETE https://api.mapflow.ai/rest/rasters/mosaic/{mosaic_id} \
  -H "Authorization: Bearer YOUR_TOKEN"

图片

管理单个图像文件和元数据。

获取图像元数据

GET /rasters/image/{image_id}

检索特定图像的详细元数据。

回复

{
  "id": "6ae7f9e9-da2d-41e0-b16f-83396003af57",
  "filename": "orthophoto.tif",
  "file_size": 68417439,
  "uploaded_at": "2024-03-15T10:35:00Z",
  "footprint": "POLYGON((...))",
  "meta_data": {
    "crs": "EPSG:32631",
    "width": 5589,
    "height": 4079,
    "count": 3,
    "dtypes": ["uint8", "uint8", "uint8"],
    "pixel_size": [0.3, 0.3]
  },
  "cog_link": "s3://bucket/path/cog/image.tif"
}

更新图像名称

PUT /rasters/image/{image_id}?name={new_name}

更新图像的显示名称。

请求示例

curl -X PUT 'https://api.mapflow.ai/rest/rasters/image/{image_id}?name=Updated%20Name' \
  -H "Authorization: Bearer YOUR_TOKEN"

删除图像

删除/光栅/图像/{image_id}

从存储中删除图像。

请求示例

curl -X DELETE https://api.mapflow.ai/rest/rasters/image/{image_id} \
  -H "Authorization: Bearer YOUR_TOKEN"

获取图像预览

GET /rasters/image/{image_id}/preview/{size}

检索图像的预览缩略图。

路径参数

尺寸

描述

s

小预览（256×256 像素）

我

大预览（1024×1024像素）

请求示例

curl https://api.mapflow.ai/rest/rasters/image/{image_id}/preview/s \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -o preview.jpg

回复

返回 JPEG 图像数据。

图像预览示例

贮存

获取存储使用情况

GET /光栅/内存

返回您帐户的当前存储使用情况和限制。

请求示例

curl https://api.mapflow.ai/rest/rasters/memory \
  -H "Authorization: Bearer YOUR_TOKEN"

回复

{
  "used_bytes": 5368709120,
  "limit_bytes": 10737418240,
  "used_gb": 5.0,
  "limit_gb": 10.0,
  "usage_percent": 50.0
}

影像目录

注解

图像搜索 API 将您连接到外部卫星图像提供商。搜索结果取决于链接到您帐户的提供商。联系支持人员以添加提供商访问权限。

搜索可用图像

POST /目录/元

按区域和元数据过滤器搜索来自外部提供商的卫星图像。

请求正文

范围

类型

必需的

描述

葵

目的

是的

GeoJSON 多边形或多多边形

获取日期自

细绳

不

UTC 日期时间 (ISO 8601)

获取日期到

细绳

不

UTC 日期时间 (ISO 8601)

最小分辨率

漂浮

不

最小分辨率（米/像素）

最大分辨率

漂浮

不

最大分辨率（米/像素）

最大云覆盖率

漂浮

不

最大云量 (0.0-100)

minOffNadirAngle

漂浮

不

最小偏离最低点角度（度）

maxOffNadirAngle

漂浮

不

最大偏离最低点角度（度）

minAoiIntersectionPercent

漂浮

不

最小 AOI 重叠 (0.0-100)

限制

整数

不

最大结果数（默认值：100）

偏移

整数

不

分页偏移量

排序依据

细绳

不

排序字段（例如“ACQUISITION_DATE”）

排序顺序

细绳

不

ASC 或 DESC

隐藏不可用

布尔值

不

排除不可用的产品

数据提供者

大批

不

按提供商“名称”过滤

产品类型

大批

不

按产品类型过滤``[“图像”和/或“马赛克”]``

警告

搜索区域大小受您帐户的 AOI 限制的限制。

请求示例

curl -X POST https://api.mapflow.ai/rest/catalog/meta \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "aoi": {
      "type": "Polygon",
      "coordinates": [[[76.6755,43.2234],[76.6755,43.4712],
                       [77.0163,43.4712],[77.0163,43.2234],
                       [76.6755,43.2234]]]
    },
    "acquisitionDateFrom": "2024-01-01T00:00:00Z",
    "acquisitionDateTo": "2024-03-01T00:00:00Z",
    "maxCloudCover": 10.0,
    "maxResolution": 0.5,
    "limit": 10,
    "sortBy": "ACQUISITION_DATE",
    "sortOrder": "DESC"
  }'

响应 – 场景产品

[
  {
    "id": "JL1GF03A_PMS_20220607132729_200087596_103_0002_001_L1",
    "productType": "Scene",
    "acquisitionDate": "2022-06-07T13:27:33Z",
    "sensor": "JL1GF03A",
    "pixelResolution": 1.06,
    "cloudCover": 0.09,
    "offNadirAngle": -3.91,
    "colorBandOrder": "B,G,R,NIR,PAN",
    "providerName": "CG",
    "previewType": "png",
    "previewUrl": "https://example.com/preview.jpg",
    "footprint": {
      "type": "Polygon",
     "coordinates": [[[76.5009, 43.3412]]]
    }
  }
]
卫星场景预览

回应 – 马赛克产品

[
  {
    "id": "JL1KF01A_PMS04_20220717131252_200093089_101_0005_001_L1",
    "productType": "Mosaic",
    "acquisitionDate": "2022-07-17T00:00:00Z",
    "sensor": "JL1KF01A",
    "pixelResolution": 0.0,
    "cloudCover": 0.0,
    "offNadirAngle": 3.0,
    "colorBandOrder": "RGB",
    "providerName": "CG_mosaic_2022",
    "previewType": "xyz",
    "previewUrl": "https://app.mapflow.ai/tiles/provider/{z}/{x}/{-y}.png",
    "footprint": {
      "type": "MultiPolygon",
     "coordinates": [[[[76.9037, 43.2529]]]]
    }
  }
]

在处理中使用搜索结果

要对搜索结果中的图像进行处理，请使用“imagerySearch”源参数：

{
  "params": {
    "sourceParams": {
      "imagerySearch": {
        "dataProvider": "CG_mosaic_2022",
        "imageIds": ["JL1KF01A_PMS04_20220717131252_200093089_101_0005_001_L1"]
      }
    }
  }
}

请参阅:doc:处理 API <processing_api> 了解完整的处理工作流程。

产品类型

类型

描述

场景

单卫星捕获。可按要求订购。请联系支持人员订购特定场景。

马赛克

预处理的图像马赛克。如果提供商链接到您的帐户，则可进行即时处理。

预览尺寸

尺寸代码

方面

s

256×256像素

我

1024×1024像素

工作流程块

通过启用/禁用可选工作流程步骤来自定义处理。

{
  "blocks": [
    {"name": "Simplification", "enabled": false},
    {"name": "Classification", "enabled": true}
  ]
}

可用模块因型号而异。通过“GET /user/status”检索选项。

人工智能模型

模型

描述

解决

飞涨

可选块

🏠 建筑物

具有分类的建筑足迹

0.5 m/像素

17-18日

简化、分类、OSM

🏠 建筑物（空中）

高分辨率航空图像（10 厘米/像素）

0.1 m/像素

19-20日

简化

🌲 森林

树木覆盖率检测

0.5 m/像素

17-18日

高地

🚗 道路

路网提取

0.5 m/像素

17-18日

—

🏗️建筑

施工现场检测

0.5 m/像素

17-18日

—

有关详细要求，请参阅:doc:模型描述 <../userguides/pipelines>。

状态代码

地位

描述

未处理

处理已创建但未开始

进行中

处理正在运行

等待

等待提供者提供的图像

好的

处理成功完成

失败

处理失败（检查``messages``字段）

取消

处理已被用户取消

已退款

管理员退还积分

审核状态

审核状态

描述

已接受

结果已接受

不接受

结果被拒绝

已退款

积分已退还

IN_REVIEW

正在团队审核中

错误信息

有关详细的错误代码和故障排除，请参阅:doc:错误消息 <error_messages>。

常见错误：

  • source-validator.PixelSizeTooHigh - 图像分辨率太低（最大 1.2 m/px）

  • source-validator.NoDataInAOI — 没有可用于 AOI 的图像

  • geometry.Invalid - 无效的 GeoJSON 几何图形

最佳实践

  1. 运行前检查成本 — 使用``/processing/cost/v2`` 来估计信用

  2. 高效轮询状态 — 每 30-60 秒检查一次“IN_PROGRESS”处理的状态

  3. 优雅地处理错误 - 检查失败处理中的“messages”字段

  4. 使用适当的缩放级别 - 将缩放与模型要求相匹配（通常为 17-18）

  5. 验证几何图形 — 确保 GeoJSON 有效且不会太大 (< 100 km²)

  6. 与项目一起组织 — 项目中的分组相关处理

  7. 存储处理 ID — 保存 ID 以供以后检索结果

支持

速率限制

  • 目前没有严格的速率限制

  • 并发处理受帐户层限制

  • 联系大批量用例的支持人员

获取帮助