Utilice sus propios datos en CEO: conexión con WMS/WMTS [Español]

Utilice sus propios datos en CEO: conexión con WMS/WMTS [Español]

A menudo escuchamos de nuestros usuarios que tienen datos y que quisieran agregarlos a sus proyectos en Collect Earth Online (CEO). Afortunadamente, CEO brinda dos maneras fáciles de agregar sus propias imágenes a sus proyectos. La primera es mediante la conexión de sus propias imágenes vía el Servicio de Cartografía Web (WMS, del inglés Web Map Service) o el Servicio de Cartografía Web de Mosaicos (WMTS, del inglés Web Map Tile Service) y la segunda, conectando sus imágenes publicadas en el Google Earth Engine (GEE, del inglés Google Earth Engine). En este blog, nos enfocaremos en la conexión de fuentes de datos de WMS/WMTS a CEO.

Agradecemos a SERVIR-Amazonia por su apoyo en la traducción de esta publicación.

🤝 Conexión de su WMS/WMTS a CEO

WMSWMTS brindan especificaciones para proporcionar mapas georreferenciados en Internet. Muchos conjuntos de datos nacionales se encuentran disponibles a través de este protocolo.

Es posible que usted esté familiarizado con el uso de imágenes de WMS o WMTS en aplicaciones de escritorio, como ArcGIS o QGIS. Al igual que estas aplicaciones de escritorio, CEO puede desplegar imágenes de WMS o WMTS a través de la función de imágenes institucionales.

The Institutional Imagery addition form for WMS Imagery.
Formulario de adición de Imágenes Institucionales para imágenes de WMS.

El primer paso para prepararse para conectar su WMS/WMTS con CEO es verificar que su WMS/WMTS sea compatible con CEO. CEO requiere datos en EPSG: 3857 en Pseudo-Mercator WGS 84. Su servidor WMS/WMTS es responsable de reproyectar las imágenes que alberga en esta proyección. Afortunadamente, la mayoría de WMS/WMTS lo harán automáticamente. Una vez cargados sus datos, puede verificar visualmente que se alineen con buenas imágenes conocidas, como las de MapBox.

Para conectar su WMS/WMTS a CEO, es necesario que usted cuente con tres datos: la URL base de su WMS/WMTS, el nombre de la capa de su interés y cualquier otro parámetro que requiera su WMS/WMTS para proporcionar imágenes. Si necesita ayuda para encontrar dicha información, la siguiente sección brinda más detalles al respecto.

Los pasos básicos para conectar sus imágenes de WMS o WMTS son:

  • Diríjase al botón “Imágenes” (Imagery) en la parte superior de su institución en CEO y pulse en “Agregar nuevas imágenes” (Add New Imagery).
  • Seleccione “Imágenes WMS” (WMS Imagery) como opción bajo Seleccionar Tipo (Select Type).
  • Agregue un título y este será el nombre de imagen que se despliegue.
  • Agregue la atribución, que asigna los créditos al grupo que recopiló o posee las imágenes. Esto aparecerá en la pantalla de recolección de datos mientras los usuarios efectúan tareas de recolección de datos.
  • Agregue la URL, que debe ser la URL http:// o https:// de su WMS/WMTS y no contener una cadena de búsqueda.
  • Agregue el nombre de la capa de su servidor que usted desea que se despliegue.
  • Agregue cualquier parámetro que requiera su WMS/WMTS para su capa.
  • Y, por último, si necesita utilizar un proxy para su WMS/WMTS, marque la casilla Proxy Imagery. Es probable que deba usar esta opción si necesita ocultar una clave para su WMS o WMTS y para hacerlo utiliza un proxy (un servidor entre CEO y su WMS/WMTS).

 

Filled in WMS imagery form for GEBCO data.
Formulario completado de imágenes WMS para datos GEBCO.


Una vez que haya agregado la capa del WMS/WMTS, puede añadirla a cualquiera de sus proyectos y utilizar las imágenes durante la recolección de datos.

An example WMS image from GEBCO viewed in the CEO data collection screen.
Ejemplo de una imagen WMS de GEBCO vista en la pantalla de recolección de datos de CEO.

👩‍🔧 Localización de información para conexiones con WMS/WMTS

Sin embargo, a veces los usuarios tienen dificultad para identificar la URL correcta, el nombre de la capa y parámetros necesarios para conectar sus imágenes satisfactoriamente. Aquí hay algunos consejos para ayudarle a encontrar dicha información.

En primer lugar, localice la página de información en su WMS/WMTS. A menudo, estos sitios web contendrán la información necesaria para conectar su WMS/WMTS a CEO. Algunas veces, la fuente de datos de su elección presentará una página de información más compleja sobre los datos y enlaces a múltiples WMS/WMTS. Algunos ejemplos incluyen:

Al acceder a esta información, lo primero que hay que buscar es localización de la URL del WMS, Por ejemplo, https://geos1.snitcr.go.cr/Ortofoto2017/wms?VERSION=1.1.1.

Algo importante de notar es que todo lo que vaya después del ? en la URL de su WMS/WMTS es un parámetro. Al agregarla a CEO, no debe considerarse parte de la URL. Sin embargo, debe incluir el ? cuando agregue su URL a CEO, pero no se preocupe, ¡nosotros lo agregaremos si a usted se le olvida!

La segunda información que debe buscar son los nombres de capa que se encuentren disponibles. A menudo, la página de información contendrá un listado de capas que se pueden visualizar con el WMS/WMTS. Tome en cuenta que a veces su capa puede tener múltiples nombres, por lo que en la interfaz web debe asegurarse de que está viendo el nombre correcto.

You may need to view the layer’s metadata through the online portal in order to find the correct WMS/WMTS layer name.
Probablemente sea necesario que vea los metadatos de su capa a través del portal en línea, con el fin de encontrar el nombre correcto de la capa en WMS/WMTS.

También puede conectar el WMS/WMTS a una aplicación de escritorio, como ArcGIS o QGIS y acceder a los nombres de capa por medio de dicha aplicación.

The GEBCO WMS connection and its layers connected to QGIS.
La conexión GEBCO WMS y sus capas conectadas a QGIS.

Puede volver a inspeccionar las Propiedades de la capa (Layer Properties) para encontrar la información que necesita para conectar su capa WMS/WMTS a CEO.

Layer properties of the GEBCO_2020_Grid_3 layer as displayed in QGIS.
Propiedades de la capa de GEBCO_2020_Grid_3 como se despliegan en QGIS.

Aun si no puede cargar los datos en una aplicación GIS de escritorio y su WMS/WMTS solo utiliza un archivo XML que no contiene ninguna información de estilo asociada con ellos, puede encontrar el nombre de la capa, pero es más difícil. En este caso, la información se encuentra en una estructura de directorios difícil de leer. Si este fuera el caso y no puede cargar los datos en una aplicación GIS de escritorio, busque “Layer” y encuentre los campos de información <Layer> con <Name>, <Title> y <Abstract> que le siguen. El texto <Name> es el que usted está buscando. En este ejemplo, el nombre es “GEBCO_2020_Grid_3”.

An example of a layer for a WMS server that does not include XML styling, so you must look at the document tree.
Ejemplo de una capa para un servidor WMS que no incluye estilo XML, por lo que es necesario buscar en la estructura de directorio.

La última información identificar los parámetros. En nuestra URL, todo lo que se encuentra después del ? son parámetros, separados por el carácter “&”. Entre los elementos más comunes que se pueden observar en las URL se encuentran:

  • SERVICE=WMS
  • version=1.1.1 (u otro número de versión)
  • request=GetCapabilities

No queremos incluir ninguno de estos tres entre nuestros parámetros de CEO. Esto porque:

  • “Service=WMS” lo maneja CEO automáticamente,
  • “version=1.1.1” u otro número de versión probablemente también lo maneje, y
  •  “request=GetCapabilities” es una solicitud al servidor WMS para que proporcione un listado de funciones (p. ej., nombres de capa), no los mapas en sí.

Es posible que se necesiten otros parámetros. Por ejemplo, algunos WMS/WMTS poseen un parámetro de “map” que es necesario. Otros parámetros que se pueden observar incluyen “crs” (por lo general no es necesario), “format” (por lo general tampoco se necesita). Le sugerimos que lea los recursos adicionales acerca de la función WMS GetMap para ayudarle a identificar cualquier parámetro adicional que requiera su WMS para proporcionar imágenes.

Si logra cargar su WMS en una aplicación GIS de escritorio, puede utilizar la interfaz de Propiedades de la capa (Layer Properties) y así poder encontrar las propiedades que es necesario incluir.

Ahora que contamos con la información fundamental, podemos conectar el WMS a CEO.

  • En CEO, diríjase a su página de Imágenes Institucionales (Institutional Imagery).
  • Cree una nueva capa de imágenes de tipo Imágenes WMS (WMS Imagery).
  • Para el título (Title), ingrese el nombre que desee. Este puede ser el nombre de la capa de WMS, el nombre WMS, alguna combinación de ambos, etc.
  • Agregue la Atribución de su imagen.
  • Ingrese su URL de WMS (solo la parte antes del ?) que identificó anteriormente.
  • Ingrese el Nombre de su Capa WMS (Layer Name)
  • Ingrese sus parámetros adicionales de WMS. Es necesario escribirlos como objetos JSON.
    • Por ejemplo, “map=ortofoto.map” (un parámetro exclusivo requerido por WMS específicos).
    • Se convierte en {“MAP”:”ortofoto.map”}. Note las comillas rectas, “”
    • Si no cuenta con ningún parámetro, ingrese {}.
  • Verifique que haya ingresado toda la información de manera correcta ¡y presione Guardar! (Save).
Completed WMS Imagery form for a WMS where an additional WMS Parameter is needed.
Carga concluida de imágenes de WMS de un servidor WMS en el que se necesita un parámetro WMS adicional.

 

The imagery in the Data Collection interface.
Las imágenes en la interfaz de Recolección de datos (Data Collection).

💥 Enfoques adicionales para solución de problemas

If after you try these steps you are still having trouble, here are some additional troubleshooting hints.

Tome en cuenta que este servidor requiere SRS en vez de CRS. Ambos cumplen con OGC. Al momento de crear la URL WMS de trabajo, es posible que encuentre el siguiente error:

400 no SRS error.

La construcción de estos puede ser difícil. Una de las mejores maneras de construirlos es utilizar la consola de su buscador o herramientas de desarrollador, buscando en el panel “Network”. Cuando acceda a su proyecto en CEO y trate de cargar los datos, se debería alimentar con múltiples solicitudes para las distintas imágenes de mapa. Puede hacer doble clic en estas, con el fin de acceder a la imagen individual. Si no funciona, puede intentar agregando o cambiando la URL hasta que aparezca una imagen.

Use your browsers’ console or developer tools to try to get a list of the individual images.

Pulsando en una de estas (p. ej., https://www.gebco.net/data_and_products/gebco_web_services/2020/mapserv?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true&LAYERS=GEBCO_2020_Grid_3&WIDTH=256&HEIGHT=256&CRS=EPSG%3A3857&STYLES=&BBOX=-8766409.899970295%2C-313086.06785608083%2C-8609866.866042254%2C-156543.03392803986) intentará mostrar una imagen individual.

Si no ha configurado el WMS correctamente, pulsar en una de estas solicitudes desplegará un mensaje de error. Aquí se incluye un error como ejemplo:

<?xml version=’1.0′ encoding=”ISO-8859-1″ standalone=”no” ?>
<!DOCTYPE ServiceExceptionReport SYSTEM “http://schemas.opengis.net/wms/1.1.1/exception_1_1_1.dtd”>
<ServiceExceptionReport version=”1.1.1″>
<ServiceException code=”MissingParameterValue”>
msWMSLoadGetMapParams(): WMS server error. Missing required parameter SRS
</ServiceException>
</ServiceExceptionReport>

Para este WMS, eliminar el parámetro version=1.1.1 resolvió el problema de configuración.

Sugerimos leer los recursos acerca de la función WMS GetMap para que le ayude a interpretar estos errores, por ejemplo: http://opengeospatial.github.io/e-learning/wms/text/operations.html#getmap.

 

CEO quisiera agradecer a sus financistas actuales FAONASA–USAID SERVIRSilvaCarbon, un programa del Gobierno de los EE. UU. Gracias también a los socios tecnológicos de CEO: a la Iniciativa Internacional de Clima y Bosques de Noruega por financiar la disponibilidad de datos abiertos de alta resolución; a Planet, por proporcionar imágenes de alta resolución y al equipo del Motor de Google Earth, por crear una plataforma para datos y análisis de ciencias de la Tierra.

Collect Earth Online está trabajando constantemente en mejorar la experiencia del usuario y su retroalimentación es muy valiosa. Si usted tiene ideas que compartir, por favor escríbanos a support@collect.earth.

¡Gracias!