API de flujo de mapas

Nota

Lea la documentación y vea ejemplos también en esta Colección Postman para API.

Ver también

Descargue e instale Mapflow python CLI para consultar la API y ejecutar scripts Mapflow CLI Tool.

Autorización a la API de Mapflow

Para acceder desde aplicaciones externas como plugin para QGIS necesita obtener token API. Los usuarios pueden registrarse y obtener token en https://app.mapflow.ai/account/api. El token se debe pasar en los parámetros de Autenticación básica como en el ejemplo:

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

Nota

Su token se genera mediante solicitud y se compone de <Email: API Token>

Puede decodificarlo con el decodificador base64 para usarlo en el formulario de autenticación básica

Asegúrese de guardar el token; de lo contrario, deberá volver a emitirlo.

Obtener un token API

Abra la aplicación web Mapflow. Registre una nueva cuenta o inicie sesión con su cuenta de Google.
Vaya a configuración de perfil de usuario para generar un nuevo token API.

API de procesamiento de flujo de mapas

La API de procesamiento de Mapflow le permite ejecutar análisis geoespaciales impulsados por IA en imágenes aéreas y satelitales. Úselo para detectar edificios, carreteras, bosques y más a escala.

Atención

Los proyectos y procesamientos creados a través de la API se sincronizan con Mapflow.ai. Las llamadas API consumen tus créditos de Mapflow.

URL base

https://api.mapflow.ai/rest

Autenticación

Todas las solicitudes de API requieren un token de API. Genera el tuyo en configuración de perfil.

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

Consulte guía de autorización para obtener más detalles.

Inicio rápido

Ejecute su primer procesamiento en 3 pasos:

Crear un proyecto

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

Respuesta: {"id": "proyecto-uuid", ...}

Crear y ejecutar procesamiento

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

Respuesta: {"id": "processing-uuid", "status": "IN_PROGRESS", ...}

Comprueba el estado y descarga los resultados

# 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

Próximos pasos: Explore modelos disponibles, cargue imágenes personalizadas o revise la referencia completa de API.

API de datos de flujo de mapas

La API de datos de Mapflow le permite administrar imágenes personalizadas, organizarlas en mosaicos y buscar imágenes satelitales de proveedores externos. Utilice sus imágenes para análisis impulsados por IA con API de procesamiento.

Nota

Pruebe nuestra Colección Postman para realizar pruebas API interactivas.

URL base

https://api.mapflow.ai/rest

Autenticación

Todas las solicitudes de API requieren un token de API. Genera el tuyo en configuración de perfil.

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

Consulte guía de autorización para obtener más detalles.

Inicio rápido

Sube y procesa tus imágenes en 3 pasos:

Crea un mosaico

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

Respuesta: {"id": "mosaico-uuid", ...}

Subir imágenes al mosaico

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"

Respuesta: {"id": "image-uuid", ...}

Ejecutar procesamiento con imágenes cargadas

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

Próximos pasos: Explore búsqueda de imágenes satelitales, administre límites de almacenamiento o revise la referencia API completa.

Para obtener documentación de referencia de API completa, incluidos todos los puntos finales, parámetros y ejemplos, consulte Referencia de API.

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

API de flujo de mapas

Autorización a la API de Mapflow

Obtener un token API

API de procesamiento de flujo de mapas

URL base

Autenticación

Inicio rápido

API de datos de flujo de mapas

URL base

Autenticación

Inicio rápido

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