TEMPO ArcGIS ImageServer - Acceso Eficiente

ArcGIS ImageServer es la forma recomendada de acceder a datos TEMPO para aplicaciones web, sin necesidad de descargar archivos NetCDF completos.

¿Por Qué Usar ImageServer?

Imagina que quieres saber el nivel de NO₂ en Ciudad de México ahora mismo. Tienes dos opciones:

Entendiendo el Servicio

URLs Base

Cada producto TEMPO tiene su propio servicio ImageServer:

Explorar servicios disponibles: Earthdata GIS Portal - Navega todos los servicios de imágenes TEMPO disponibles

Estructura del Servicio

Cada servicio ImageServer proporciona metadatos y operaciones:

Operación Principal: Identify

Qué hace: Extrae el valor de un píxel específico dado lat/lon.

Parámetros Clave

Ejemplo Conceptual

1// Concepto de alto nivel - NO código completo
2async function obtenerNO2EnPunto(lat, lon) {
3  // 1. Construir URL del servicio
4  const url = SERVICIO_TEMPO_NO2 + '/identify';
5
6  // 2. Preparar parámetros
7  const params = {
8    geometry: { x: lon, y: lat },
9    geometryType: 'point',
10    formato: 'json'
11  };
12
13  // 3. Hacer request
14  const respuesta = await fetch(url + '?' + parametrosAString(params));
15  const datos = await respuesta.json();
16
17  // 4. Extraer valor
18  return {
19    no2: datos.value,
20    unidad: 'molec/cm²',
21    timestamp: Date.now()
22  };
23}
24

Respuesta Típica

1{
2  "value": 5.2e15,
3  "location": {
4    "x": -99.1332,
5    "y": 19.4326
6  },
7  "name": "TEMPO_NO2_TROPOSPHERIC",
8  "properties": {
9    "AcquisitionDate": "2025-10-02T14:00:00Z",
10    "QualityFlag": 0
11  }
12}
13

Operación 2: ExportImage - Renderizar Mapas

Qué hace: Genera una imagen PNG/JPG del producto TEMPO sobre un área geográfica.

Cuándo Usarla

• Mostrar mapa de NO₂ sobre México en tu dashboard
• Overlay de contaminación en mapa interactivo (Leaflet, Mapbox)
• Generar visualizaciones para reportes

Parámetros Principales

Concepto de Uso

1// Idea conceptual
2function generarMapaNO2SobreMexico() {
3  // 1. Definir área de interés
4  const bbox = {
5    west: -118, south: 14,
6    east: -86, north: 33
7  };
8
9  // 2. Construir URL
10  const url = SERVICIO_TEMPO_NO2 + '/exportImage';
11  const params = {
12    bbox: `${bbox.west},${bbox.south},${bbox.east},${bbox.north}`,
13    size: '1024,768',
14    format: 'png'
15  };
16
17  // 3. Usar URL directamente en <img> o mapa
18  return url + '?' + convertirParams(params);
19}
20
21// Uso en HTML/React
22<img src={urlImagenTEMPO} alt="NO₂ sobre México" />
23

Filtrado Temporal con MosaicRule

Problema: ImageServer puede tener datos de múltiples días/horas. ¿Cómo obtienes datos de un momento específico?

Solución: mosaicRule con cláusula where.

Ejemplo de Filtro Temporal

1// Concepto: Obtener datos de una fecha específica
2const mosaicRule = {
3  mosaicMethod: 'esriMosaicCenter',
4  where: "AcquisitionDate >= '2025-10-02 00:00:00' AND AcquisitionDate <= '2025-10-02 23:59:59'"
5};
6

Métodos de mosaico comunes:

• esriMosaicCenter: Usa imagen más cercana al centro del bbox
• esriMosaicNorthwest: Prioriza esquina noroeste
• esriMosaicAttribute: Ordena por atributo (ej. fecha más reciente)

Consideraciones Importantes

1. Sin Autenticación para Consultas

2. Rate Limits

Mitigación: Implementa caching (60 min) - los datos TEMPO se actualizan cada hora.

3. Valores Fuera de Rango

¿Qué hacer si no hay datos?

1// Concepto de manejo de errores
2async function obtenerDatosTEMPOConFallback(lat, lon) {
3  const resultado = await queryImageServer(lat, lon);
4
5  if (!resultado || resultado.value === null) {
6    // Posibles razones:
7    // - Fuera de cobertura TEMPO
8    // - Hora nocturna (TEMPO solo 8-22h)
9    // - Nubes muy densas
10    // - Error de servidor
11
12    return {
13      exito: false,
14      razon: 'Datos no disponibles',
15      sugerencia: 'Intenta con hora diferente o usa datos de OpenAQ'
16    };
17  }
18
19  return { exito: true, datos: resultado };
20}
21

4. Interpretación de Valores

Recursos para Aprender Más

Documentación oficial:

• 📖 ArcGIS ImageServer API Reference - Documentación completa de todas las operaciones
• 🔧 Earthdata GIS Services - Portal con todos los servicios disponibles

Herramientas interactivas:

• 🗺️ TEMPO ArcGIS Viewer - Explora datos visualmente para entender qué información está disponible
• 🎮 ArcGIS REST Services Directory - Navega la estructura de servicios

Ejemplos prácticos:

• 💻 ASDC Data Services GitHub - Ejemplos de código de NASA para acceder a TEMPO

Resumen: ImageServer vs CMR

Próximos Pasos

En la siguiente lección aprenderás:

• Autenticación con Earthdata (opcional pero útil)
• Caching estratégico para optimizar performance
• Manejo de errores y datos faltantes de forma robusta
• Rate limiting y mejores prácticas
• Arquitectura de producción para tu app

Estas prácticas convertirán tu prototipo en una aplicación profesional lista para usuarios reales.