Personalizar el mapa de búsqueda
En el archivo\\geoportal\WEB-INF\classes\gpt\config\gpt.xml se hace referencia al mapa de búsqueda. Este servicio también se usa en la página Vista previa, en la página Detalles y en los formularios del editor de metadatos, pero no en las páginas de descarga personalizadas. El mapa se llama en la interfaz a través de la API JavaScript de ArcGIS Server. Este tema cumbre el cambio del tipo de servicio de mapas de búsqueda utilizado, el cambio de la extensión inicial del mapa, consideraciones que se han de que tener en cuenta al configurar el mapa de búsqueda y cómo cambiar las dimensiones del mapa de búsqueda en la página de búsqueda.
Cambio del Servicio de mapas de búsqueda
Para cambiar el servicio mismo de mapas de búsqueda abra el archivo \\geoportal\WEB-INF\classes\gpt\config\gpt.xml y actualice el mapServiceUrl para hacer referencia a un servicio diferente.
Importante: en las versiones 0.9 a 1.1.1 del Geoportal Server, solo se admiten los servicios del servidor de mapas de ArcGIS Server. Comenzando desde la versión 1.2 del Geoportal, existen cuatro tipos de servicios compatibles; los parámetros adicionales del archivo gpt.xml deben ser configurados para los servicios WMS u OpenStreetMap:
Extremo de REST del servidor de mapas de ArcGIS for Server
Compatible en todas las versiones del servidor del Geoportal. Este debe ser un URL de REST. No puede ser una URL SOAP. El mapServiceType debe estar establecido en "dinámico"; si se establece en "teselado", las funciones de zoom del mapa Javascript no se representarán correctamente. Los servicios de ArcGIS Online también están disponibles para este parámetro si no hay ningún otro servicio de ArcGIS Server que prefiera usar su organización.
Ejemplo de configuración del elemento interactiveMap:
- mapServiceUrl="http://serverName/arcgis/rest/services/serviceName/MapServer"
- mapServiceType="dinámico"
URL del servicio WMS
Admite el servidor del Geoportal versión 1.2. Para un URL del servicio WMS, la cadena de caracteres específica de OGC "?request=GetCapabilities&service=WMS" no debe ser incluida. Un elemento opcional llamado mapVisibleLayers está disponible; mapVisibleLayers es un conjunto de nombres de capa WMS visibles. Este parámetro debe solo definirse cuando WMS se utilice como un servicio de mapas. Las capas se encuentran en el elemento name del archivo XML WMS GetCapabilities.
Ejemplo de configuración del elemento interactiveMap:
- mapServiceUrl="http://serverName/arcgis/services/serviceName/WMSServer"
- mapServiceType="wms"
- mapVisibleLayers="['nameA','nameB','nameC']"
URL del servicio WMTS
Admite el servidor del Geoportal versión 1.2. Para un URL del servicio WMTS, la cadena de caracteres específica de OGC "?request=GetCapabilities&service=WMST" no debe ser incluida. La compatibilidad para wmts es muy genérica, algunos de los escenarios más elaborados requerirán algoritmos personalizados para trabajar con ciertos servicios WMTS. La implementación de tales algoritmos se deja a discreción de su organización. Consulte WMTSLayer para obtener más información sobre el API o WMTS layer y WMTS: información de recursos para ver más ideas sobre cómo personalizar la compatibilidad con WMTS mediante programación.
Ejemplo de configuración del elemento interactiveMap:
- mapServiceUrl="http://v2.suite.opengeo.org/geoserver/gwc/service/wmts"
- mapServiceType="wmts"
El Servicio OpenStreetMap
Admite el servidor del Geoportal versión 1.2. En OpenStreetMap, deje el valor de mapServiceUrl vacío.
Ejemplo de configuración del elemento interactiveMap:
- mapServiceUrl=""
- mapServiceType="openstreet"
Cosas importantes que recordar para el servicio de mapas
Asegúrese de que el servicio de mapas de búsqueda que use, considere lo siguiente:
- Los servicios proyectados son compatibles, pero con consecuencias. Debido que los sobres del documento de metadatos y las búsquedas se basan en coordenadas opuestas del sistema de coordenadas geográficas, las esquinas opuestas no se pueden trazar en un rectángulo proyectado. Esto hará que hayan instancias en donde los resultados de la búsqueda no coinciden con el criterio visible. Para poder usar un servicio proyectado, el atributo geometryServiceUrl se debe establecer en la etiqueta <interactiveMap>.
- No utilice los servicios del mapa con referencia espacial no definida usando una Id. reconocida (WKID). Debido a que el mapa de búsqueda se basa en el API de JavaScript, las limitaciones para el API de JavaScript aplicarán al mapa de búsqueda. Existe un problema conocido con el API de JavaScript que solo es compatible con sistemas de coordenadas definidos a través de una WKID. También es posible definir la referencia espacial de un mapa como una cadena de caracteres de definición (WKT), pero esto ocasionará comportamientos extraños en el mapa de búsqueda Por ejemplo, es posible que no vea una huella de los registros de los metadatos en la página de búsqueda, que no pueda definir el sobre para los metadatos creados/editados en el formulario Crear metadatos y la Vista previa fallará en la visualización de servicios 'gráficos' tales como GeoRSS o KML/KMZ.
- Solo en las versiones 1.0 y 1.1.x: si desea usar un servicio de mapas en su mapa de búsqueda que utilice un sistema de coordenadas distinto al de WGS 1984 - EPSG 4326, es posible que tenga que establecer el parámetro jsapiUrl del archivo gpt.xml para que haga referencia a la versión 1.6 de el API JavaScript en lugar de a la versión 2.0 predeterminada.
Cambio de la extensión inicial del mapa
Por defecto la extensión inicial del mapa del geoportal es la misma que la extensión inicial del servicio mismo. En el servidor del Geoportal versión 1.2, es posible definir la extensión inicial del mapa y por lo tanto invalidar la extensión inicial del servicio. Esta funcionalidad está disponible para cualquier tipo de servicio, independientemente de si es "dinámico", "openstreet", "wms" o "wmts". Sin embargo, solo afecta al mapa en la página de búsqueda y en la página de vista previa; no está habilitado en la página de detalles de metadatos (ya se acerca al sobre) o en el editor de metadatos (que, o bien se acerca al sobre si se editan metadatos ya existente, o utiliza un mecanismo separado de definición de la extensión inicial si se crean nuevos metadatos).
Como configurar la extensión inicial
En el elemento interactiveMap del archivo gpt.xml, agregue un atributo "mapInitialExtent". El valor de ese atributo es una definición que cumple los requisitos de JSON de la extensión de el API JavaScript de Esri (consulte Extensión).
Ejemplo: <interactiveMap mapInitialExtent="xmin:0,ymin:0,xmax:90,ymax:45,spatialReference:{wkid:4326}"
Cambie las dimensiones del mapa de búsqueda
Si cambia el mapa de búsqueda predeterminado que aparece en la página de búsqueda, es posible que tenga que cambiar las dimensiones del contenedor del mapa en sí para que se adapte mejor al área geográfica. El código de la página de búsqueda se encuentra en el archivo \\geoportal\catalog\search\criteria.jsp.
- Abra el archivo \\geoportal\catalog\search\criteria.jsp en un editor de texto.
- Desplácese al div que tenga un id interactiveMap.
- El div tiene un ancho y un alto asociados en el atributo style. Cambie los valores de width (ancho) y de height (alto) según corresponda.
- El div que contiene el interactiveMap tiene un div principal que dibuja el borde alrededor del mapa. Si cambia las dimensiones del div secundario, también deberá modificar las del div principal. Busque la declaración div justo encima del div de interactiveMap. Cambie los valores de width (ancho) y de height (alto) del atributo style según corresponda.
- A continuación, se muestra un ejemplo en el que el alto y el ancho se cambian a 537 y a 360 píxeles, respectivamente:
<f:verbatim> <div id="locatorCandidates" class="locatorCandidates"></div> <div style="width: 537px; height: 360px; margin-top: 1px; border: 1px solid #000000;"> <div id="interactiveMap" dojotype="dijit.layout.ContentPane" style="width:537px; height:360px; cursor:pointer; cursor:pointer;"></div> </div> </f:verbatim>
- También es importante cambiar el ancho del tamaño de la página del Geoportal para acomodar el mapa más grande. Para cambiar el ancho, abra el archivo preview.css de la carpeta \\geoportal\catalog\skins\themes\[color theme]. En ese archivo, cambie el valor width para aumentar el tamaño de la página. En el siguiente ejemplo, el ancho se aumenta de 880 píxeles a 980 píxeles:
div#gptMainWrap {width: 980px; - Guarde los archivos alterados, reinicie la aplicación Web del geoportal y abra una nueva ventana del navegador para el Geoportal para ver el cambio ya realizado.