En EarthRanger, la integración de mapas base del Servicio de Mapas Web (WMS) requiere la creación de una URL de servicio basada en las capacidades del servicio WMS. Esta guía le guiará por los pasos para crear una URL de servicio WMS funcional para su uso en EarthRanger, garantizando que la URL incluya los parámetros necesarios para una correcta representación de los mapas.

Introducción a la creación de una URL WMS
 

Al trabajar con un servicio WMS, el primer paso es obtener la respuesta GetCapabilities, que proporciona los detalles necesarios para crear la URL de su WMS. Esto se suele hacer añadiendo ?service=wms&request=getcapabilities a la URL de su servicio WMS. Por ejemplo:

https://ortos.dgterritorio.gov.pt/wms/ortosat2023?service=wms&request=getcapabilities

La respuesta GetCapabilities estará en formato XML y enumerará los parámetros disponibles que utilizará para construir la URL WMS completa para integrar el mapa base en EarthRanger.
 

Construyendo la URL de WMS

Después de recibir el XML GetCapabilities, construirá la URL WMS final incluyendo varios parámetros que están enumerados explícitamente en las capacidades o fijados por el estándar WMS.

Ejemplo de URL final:
https://ortos.dgterritorio.gov.pt/wms/ortosat2023?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&FORMAT=image/png&TRANSPARENT=true&LAYERS=OrtoSat2023&STYLES=&WIDTH=256&HEIGHT=256&CRS=EPSG:3857&BBOX={bbox-epsg-3857}

Desglose de los parámetros de URL

A continuación se muestra una explicación detallada de cada parámetro incluido en la URL de WMS:

1.URL base: https://ortos.dgterritorio.gov.pt/wms/ortosat2023?

• Origen: Extraído de la etiqueta XML <OnlineResource> de GetCapabilities. 
• Explicación: Este es el punto final base para realizar solicitudes GetMap de WMS.

2. SERVICE=WMS: SERVICE=WMS

• Origen: Corregido por el estándar WMS. 
• Explicación: Siempre configurado en WMS según lo exige la especificación WMS.

3. VERSION=1.3.0: VERSION=1.3.0

• Origen: Extraído del nodo raíz <WMS_Capabilities>. 
• Explicación: Indica la versión de la especificación WMS compatible con el servicio.
   

4. REQUEST=GetMap: REQUEST=GetMap

• Origen: Corregido por el estándar WMS. 
• Explicación: Este es el tipo de solicitud para obtener imágenes de mapas.

5. FORMAT=image/png: FORMAT=image/png

• Origen: Seleccionado entre los formatos listados en <GetMap> en el documento de capacidades XML. 
• Explicación: Especifica el formato de imagen del mapa. Aquí se selecciona "image/png" y también puede ser JPG o JPEG.

6. TRANSPARENT=true: TRANSPARENT=true

• Origen: Parámetro opcional establecido por el usuario. 
• Explicación: Esto garantiza que el fondo del mapa sea transparente, lo cual resulta útil para superponer mapas.

7. LAYERS=OrtoSat2023: LAYERS=OrtoSat2023

• Origen: Extraído de la definición de <Layer> en XML. 
• Explicación: Especifica la capa que se mostrará, en este caso, OrtoSat2023.

8. STYLES=: STYLES=

• Origen: Requerido por el estándar WMS, pero se deja en blanco si no se define un estilo específico.
• Explicación: Dado que no se define un estilo específico en el XML, se deja en blanco.

9. WIDTH=256 & HEIGHT=256: WIDTH=256&HEIGHT=256

• Origen: Definido por el cliente dentro de los límites especificados en el XML.
• Explicación: Estos valores determinan el tamaño de la imagen del mapa solicitada. Normalmente, el tamaño estándar es de 256 x 256 píxeles.

10. CRS=EPSG:3857: CRS=EPSG:3857 

• Origen: Extraído de las etiquetas <CRS> dentro de los metadatos de la capa en el XML.
• Explicación: Especifica el Sistema de Referencia de Coordenadas (SRC) utilizado para la proyección cartográfica. EPSG:3857 se utiliza comúnmente para mapas web.

11. BBOX={bbox-epsg-3857}: BBOX={bbox-epsg-3857} 

• Origen: Generada dinámicamente por el cliente durante la ejecución.
• Explicación: Este parámetro representa el cuadro delimitador de la imagen del mapa, que suele proporcionarse como {bbox-epsg-3857} en la mayoría de los entornos de mapeo.
   

Up Next: Exporting and Preparing EarthRanger Data