Referencia de API

Proyectos

Crear proyecto

POST /proyectos

Crea un nuevo contenedor de proyectos para organizar procesamientos.

Parámetro	Tipo	Requerido	Descripción
`nombre`	cadena	Sí	Nombre del proyecto
`descripción`	cadena	No	Descripción del proyecto

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Actualizar proyecto

PUT /proyectos/{proyectoId}

Actualiza el nombre y/o descripción del proyecto.

Parámetro	Tipo	Requerido	Descripción
`Id del proyecto`	cadena	Sí	UUID del proyecto (parámetro de ruta)
`nombre`	cadena	No	Nuevo nombre del proyecto
`descripción`	cadena	No	Nueva descripción del proyecto

Solicitud de ejemplo

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

Procesamientos

Nota

Se recomienda la API v2. Utiliza sourceParams e inferenceParams estructurados. v1 utiliza un mapa params plano y se mantiene para compatibilidad con versiones anteriores.

Crear procesamiento (v2)

POST /procesamientos/v2

Crea y ejecuta un procesamiento de análisis de imágenes.

Parámetro	Tipo	Requerido	Descripción
`nombre`	cadena	Sí	Nombre del procesamiento
`Id del proyecto`	cadena	Sí	UUID del proyecto
`wdId` o `wdName`	cadena	Sí	ID o nombre de la definición del flujo de trabajo (por ejemplo, «🏠 Edificios»)
`geometría`	GeoJSON	Sí	Área de interés (polígono o multipolígono)
`params.sourceParams`	objeto	Sí	Configuración de fuente de imágenes (ver Fuentes de datos)
`params.inferenciaParams`	objeto	No	Parámetros específicos del modelo
`bloques`	formación	No	Activar/desactivar pasos del flujo de trabajo (ver Bloques de flujo de trabajo)
`descripción`	cadena	No	Descripción del procesamiento
`meta`	objeto	No	Metadatos personalizados

Solicitud de ejemplo: uso de 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
      }
    }
  }
}

Solicitud de ejemplo: uso de imágenes personalizadas

{
  "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"]
      }
    }
  }
}

Respuesta de ejemplo

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

Obtener procesamiento (v2)

OBTENER /procesamientos/{processingId}/v2

Recupera el estado y los detalles del procesamiento.

Parámetro	Tipo	Requerido	Descripción
`ID de procesamiento`	cadena	Sí	Procesamiento de UUID (parámetro de ruta)

Respuesta de ejemplo

{
  "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"
}

Valores de estado: NO PROCESADO, EN_PROGRESS, EN ESPERA, OK, FAILED, CANCELADO

Procesamientos de listas (v2)

OBTENER /procesamientos/v2

Enumera todos los procesamientos del usuario.

Respuesta de ejemplo

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

Listar procesamientos por proyecto (v2)

OBTENER /projects/{projectId}/processings/v2

Enumera los procesamientos para un proyecto específico.

Calcular costo (v2)

POST /procesamiento/costo/v2

Estima el costo de procesamiento antes de ejecutarlo.

Parámetro	Tipo	Requerido	Descripción
`wdId`	cadena	Sí	ID de definición de flujo de trabajo
`geometría`	GeoJSON	No*	Área de interés
`áreaSqKm`	número	No*	Área en km² (alternativa a la geometría)
`parámetros`	objeto	No	Parámetros de fuente e inferencia.
`bloques`	formación	No	Bloques de flujo de trabajo habilitados

Nota

*Proporcione geometría o areaSqKm (o ambos).

Solicitud de ejemplo

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

Respuesta de ejemplo

Descargar resultados

OBTENER /procesamientos/{processingId}/resultado

Descarga los resultados del procesamiento como GeoJSON.

Parámetros de consulta:

aoiId (opcional): filtra los resultados según un AOI específico

Ejemplo

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

Descargar resultados por AOI

OBTENER /procesamientos/{processingId}/result?aoiId={aoiId}

Descarga los resultados del procesamiento como GeoJSON por AOI específica.

Parámetros de consulta:

aoiId (obligatorio): ID de AOI utilizado para filtrar resultados

Ejemplo

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

Gestión de procesamiento

Reiniciar procesamiento

POST /procesamientos/{processingId}/restart

Reinicia únicamente las particiones fallidas.

Procesamiento de actualización

PUT /procesamientos/{processingId}

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

Eliminar procesamiento

BORRAR /procesamientos/{processingId}

Elimina el procesamiento y todas las entidades secundarias.

Usuario y cuenta

Obtener estado de usuario

OBTENER /usuario/estado

Devuelve detalles de la cuenta, modelos disponibles y definiciones de flujo de trabajo.

Respuesta de ejemplo

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

Historial de procesamiento

POST /procesamientos/estadísticas

Devuelve el historial de procesamiento con paginación y filtrado.

Parámetros de consulta:

tipo (opcional) — Formato de respuesta: JSON o CSV

Cuerpo de la solicitud:

Parámetro	Tipo	Descripción
`página`	entero	Número de página
`por página`	entero	Artículos por página
`ordenar`	cadena	Ordenar expresión (por ejemplo, `"created:desc"`)
`filtro`	cadena	Expresión de filtro (por ejemplo, `"status=OK"`)

Solicitud de ejemplo

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

Fuentes de datos

El objeto sourceParams especifica dónde obtener las imágenes. Elija una opción:

Proveedor de datos predeterminado

Utilice proveedores integrados como Mapbox, ArcGIS.

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

Campo	Descripción
`nombredelproveedor`	Nombre del proveedor: `Mapbox`, `arcgis_world_imagery`, etc.
`aumentar`	Nivel de zoom (normalmente 17-19 para una resolución de 0,5 m)

Mis imágenes

Utilice imágenes cargadas a través de API de datos de flujo de mapas.

Imagen única:

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

Mosaico (varias imágenes):

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

Búsqueda de imágenes

Busque y utilice imágenes de proveedores comerciales.

{
  "sourceParams": {
    "imagerySearch": {
      "dataProvider": "maxar",
      "imageIds": ["image-uuid"],
      "zoom": 18
    }
  }
}

URL personalizada

Utilice su propio servicio de mosaicos 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"
    }
  }
}

Campo	Tipo	Descripción
`tipo de fuente`	cadena	`XYZ`, `TMS`, `QUADKEY`, `SENTINEL_L2A`, `LOCAL`
`URL`	cadena	Plantilla de URL de mosaico
`aumentar`	entero	Nivel de zoom
`crs`	cadena	Sistema de referencia de coordenadas (por ejemplo, `EPSG:3857`)
`rasterLogin`	cadena	Nombre de usuario de autenticación opcional
`contraseña rasterizada`	cadena	Contraseña de autenticación opcional

Carga de imágenes personalizadas

Utilice API de datos de flujo de mapas para crear un mosaico y cargar imágenes
Haga referencia a las imágenes cargadas en sourceParams.myImagery.imageIds

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

API de datos

mosaicos

Un mosaico es una colección de imágenes georreferenciadas organizadas para su procesamiento y vista previa. Los mosaicos ayudan cuando se trabaja con múltiples imágenes aéreas que cubren un área o se agrupan ortomapas grandes para un almacenamiento optimizado en la nube.

Crear mosaico

POST /rásteres/mosaico

Crea una colección de mosaicos vacía.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
`nombre`	cadena	Sí	Nombre del mosaico
`etiquetas`	formación	No	Etiquetas para organizar mosaicos

Solicitud de ejemplo

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"]
  }'

Respuesta

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

Obtener mosaico

GET /rasters/mosaic/{mosaic_id}

Recupera metadatos de mosaico por ID.

Respuesta

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

Actualizar mosaico

PUT /rasters/mosaic/{mosaic_id}

Actualiza el nombre y las etiquetas del mosaico.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
`nombre`	cadena	No	Nuevo nombre del mosaico
`etiquetas`	formación	No	Nueva lista de etiquetas (reemplaza la existente)

Solicitud de ejemplo

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"]
  }'

Subir imágenes al mosaico

POST /rásteres/mosaico/{mosaic_id}/image

Carga archivos de imágenes georreferenciadas a un mosaico existente.

Atención

Todas las imágenes de un mosaico deben tener:

Mismo sistema de referencia de coordenadas (CRS)
Mismo número de bandas
Misma resolución espacial

Pedido

Tipo de contenido: multipart/form-data
Cuerpo: campo archivo con archivo de imagen

Solicitud de ejemplo

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"

Respuesta

{
  "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"
}

Crear mosaico y cargar imagen

POST /rásteres/mosaico/imagen?nombre={nombre}&tags={tag1}&tags={tag2}

Crea un mosaico y sube una imagen en una sola solicitud.

Solicitud de ejemplo

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"

Vincular imagen externa al mosaico

POST /rasters/mosaic/{mosaic_id}/imagen-enlace

Vincula una URL de imagen S3 existente a un mosaico sin cargarla.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
`URL`	cadena	Sí	URL S3 del archivo de imagen

Solicitud de ejemplo

curl -X POST https://api.mapflow.ai/rest/rasters/mosaic/{mosaic_id}/link-image \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "s3://bucket/path/image.tif"
  }'

Respuesta

{
  "message": "File successfully linked to a mosaic",
  "mosaic_id": "6ee95ae6-f26e-41bd-8cb1-39bea545119f"
}

Obtener imágenes en mosaico

GET /rasters/mosaic/{mosaic_id}/image

Enumera todas las imágenes en un mosaico con metadatos.

Respuesta

[
  {
    "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]
    }
  }
]

Eliminar mosaico

BORRAR /rasters/mosaic/{mosaic_id}

Elimina un mosaico y todas sus imágenes vinculadas.

Advertencia

Esta acción es irreversible. Todas las imágenes vinculadas al mosaico se eliminarán permanentemente.

Solicitud de ejemplo

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

Imágenes

Administre archivos de imágenes individuales y metadatos.

Obtener metadatos de imagen

GET /rasters/image/{image_id}

Recupera metadatos detallados para una imagen específica.

Respuesta

{
  "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"
}

Actualizar nombre de imagen

PUT /rásteres/imagen/{image_id}?nombre={nuevo_nombre}

Actualiza el nombre para mostrar de una imagen.

Solicitud de ejemplo

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

Eliminar imagen

BORRAR /rásteres/imagen/{image_id}

Elimina una imagen del almacenamiento.

Solicitud de ejemplo

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

Obtener vista previa de la imagen

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

Recupera una miniatura de vista previa de la imagen.

Parámetros de ruta

Tamaño	Descripción
`s`	Vista previa pequeña (256×256 píxeles)
`l`	Vista previa grande (1024×1024 píxeles)

Solicitud de ejemplo

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

Respuesta

Devuelve datos de imagen JPEG.

Almacenamiento

Obtener uso de almacenamiento

GET /rásteres/memoria

Devuelve el uso de almacenamiento actual y los límites de su cuenta.

Solicitud de ejemplo

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

Respuesta

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

Catálogo de imágenes

Nota

La API de búsqueda de imágenes lo conecta con proveedores externos de imágenes satelitales. Los resultados de la búsqueda dependen de los proveedores vinculados a su cuenta. Póngase en contacto con el soporte para agregar acceso de proveedor.

Buscar imágenes disponibles

POST /catalogo/meta

Busca imágenes satelitales de proveedores externos por área y filtros de metadatos.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
`aoi`	objeto	Sí	Polígono GeoJSON o multipolígono
`fechadeadquisición`	cadena	No	Fecha y hora UTC (ISO 8601)
`fechadeadquisicióna`	cadena	No	Fecha y hora UTC (ISO 8601)
`resolución mínima`	flotar	No	Resolución mínima (metros/píxel)
`resolución máxima`	flotar	No	Resolución máxima (metros/píxel)
`maxCloudCover`	flotar	No	Nubosidad máxima (0,0-100)
`minOffNadirAngle`	flotar	No	Ángulo mínimo con respecto al nadir (grados)
`maxOffNadirAngle`	flotar	No	Ángulo máximo con respecto al nadir (grados)
`minAoiIntersectionPorcentaje`	flotar	No	Superposición mínima de AOI (0,0-100)
`límite`	entero	No	Resultados máximos (predeterminado: 100)
`compensación`	entero	No	Desplazamiento de paginación
`ordenarPor`	cadena	No	Ordenar campo (por ejemplo, `ACQUISITION_DATE`)
`ordenar`	cadena	No	`ASC` o `DESC`
`ocultarNo disponible`	booleano	No	Excluir productos no disponibles
`proveedores de datos`	formación	No	Filtrar por proveedor «nombre»
`tiposdeproducto`	formación	No	Filtrar por tipos de producto `["IMAGEN" y/o "MOSAICO"]`

Advertencia

El tamaño del área de búsqueda está limitado por el límite AOI de su cuenta.

Solicitud de ejemplo

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"
  }'

Respuesta – Producto de escena

[
  {
    "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]]]
    }
  }
]

Respuesta – Producto mosaico

[
  {
    "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]]]]
    }
  }
]

Utilice los resultados de la búsqueda en el procesamiento

Para ejecutar el procesamiento con imágenes de los resultados de búsqueda, utilice el parámetro fuente imagerySearch:

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

Consulte API de procesamiento para conocer el flujo de trabajo de procesamiento completo.

Tipos de productos

Tipo	Descripción
Escena	Captura de un solo satélite. Disponible para realizar pedidos bajo petición. Póngase en contacto con el soporte para solicitar escenas específicas.
Mosaico	Mosaico de imágenes preprocesadas. Disponible para procesamiento instantáneo si el proveedor está vinculado a su cuenta.

Tamaños de vista previa

Código de tamaño	Dimensiones
`s`	256×256 píxeles
`l`	1024×1024 píxeles

Bloques de flujo de trabajo

Personalice el procesamiento habilitando/deshabilitando pasos de flujo de trabajo opcionales.

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

Los bloques disponibles varían según el modelo. Recupera opciones a través de GET /user/status.

Modelos de IA

Modelo	Descripción	Resolución	Zoom	Bloques opcionales
🏠 Edificios	Huellas de construcción con clasificación.	0,5 m/px	17-18	Simplificación, Clasificación, OSM
🏠 Edificios (Aéreo)	Imágenes aéreas de alta resolución (10 cm/px)	0,1 m/px	19-20	Simplificación
🌲 Bosque	Detección de cobertura arbórea	0,5 m/px	17-18	alturas
🚗 Carreteras	Extracción de red vial	0,5 m/px	17-18	—
🏗️ Construcción	Detección de sitios de construcción	0,5 m/px	17-18	—

Consulte descripciones de modelos para conocer los requisitos detallados.

Códigos de estado

Estado	Descripción
`SIN PROCESAR`	Procesamiento creado pero no iniciado
`EN_PROGRESO`	El procesamiento está en ejecución
`ESPERANDO`	En espera de imágenes del proveedor
`Está bien`	Procesamiento completado exitosamente
`FALLADO`	El procesamiento falló (verifique el campo `mensajes`)
`CANCELADO`	El procesamiento fue cancelado por el usuario
`REEMBOLSADO`	Créditos reembolsados por el administrador

Estado de revisión

Estado de revisión	Descripción
`ACEPTADO`	Resultados aceptados
`NO_ACEPTADO`	Resultados rechazados
`REEMBOLSADO`	Créditos reembolsados
`EN_REVISIÓN`	Bajo revisión por equipo

Mensajes de error

Para obtener códigos de error detallados y solución de problemas, consulte Mensajes de error.

Errores comunes:

source-validator.PixelSizeTooHigh — Resolución de imágenes demasiado baja (máx. 1,2 m/px)
source-validator.NoDataInAOI — No hay imágenes disponibles para AOI
geometry.Invalid — Geometría GeoJSON no válida

Mejores prácticas

Verifique el costo antes de ejecutar: use /processing/cost/v2 para estimar los créditos.
Estado de encuesta de manera eficiente: verifique el estado cada 30 a 60 segundos para los procesamientos IN_PROGRESS
Maneje los errores con elegancia: marque el campo mensajes en procesamientos fallidos
Utilice niveles de zoom adecuados: haga coincidir el zoom con los requisitos del modelo (normalmente 17-18)
Validar geometría: asegúrese de que GeoJSON sea válido y no demasiado grande (< 100 km²)
Organizar con proyectos — Procesamientos relacionados con grupos en proyectos
Almacenar ID de procesamiento: guarde los ID para recuperar los resultados más adelante

Referencia de API

Proyectos

Crear proyecto

Actualizar proyecto

Procesamientos

Crear procesamiento (v2)

Obtener procesamiento (v2)

Procesamientos de listas (v2)

Listar procesamientos por proyecto (v2)

Calcular costo (v2)

Descargar resultados

Descargar resultados por AOI

Gestión de procesamiento

Usuario y cuenta

Obtener estado de usuario

Historial de procesamiento

Fuentes de datos

Proveedor de datos predeterminado

Mis imágenes

Búsqueda de imágenes

URL personalizada

Carga de imágenes personalizadas

API de datos

mosaicos

Crear mosaico

Obtener mosaico

Actualizar mosaico

Subir imágenes al mosaico

Crear mosaico y cargar imagen

Vincular imagen externa al mosaico

Obtener imágenes en mosaico

Eliminar mosaico

Imágenes

Obtener metadatos de imagen

Actualizar nombre de imagen

Eliminar imagen

Obtener vista previa de la imagen

Almacenamiento

Obtener uso de almacenamiento

Catálogo de imágenes

Buscar imágenes disponibles

Utilice los resultados de la búsqueda en el procesamiento

Tipos de productos

Tamaños de vista previa

Bloques de flujo de trabajo

Modelos de IA

Códigos de estado

Estado de revisión

Mensajes de error

Mejores prácticas

Apoyo

Límites de tarifas

Obtener ayuda