Uso de la caché de mapa por parte de los clientes
En este tema
- Cómo acceden y utilizan la caché las aplicaciones
- Mejorar el rendimiento en la visualización de servicios de mapas en caché
- Almacenamiento en caché local de capas en
ArcGIS for Desktop - Superponer cachés
- Forzar un dibujo dinámico
Este tema contiene tres partes. La primera sección describe cómo acceden y utilizan las teselas en una caché de mapa las aplicaciones de ArcGIS. La segunda parte explica cómo estas aplicaciones almacenan las teselas para usar más tarde. La tercera sección explica cómo mejorar el rendimiento de visualización de teselas ajustando el tiempo durante el cual el navegador web reutiliza las teselas que se encuentren en su caché local. La sección final proporciona algunas instrucciones para superponer las cachés de mapa en aplicaciones de ArcGIS.
Cómo acceden y utilizan la caché las aplicaciones
Una vez que define un esquema de ordenamiento en teselas para el servicio de mapas, el servicio inmediatamente comienza a intentar utilizar la caché. Cualquier aplicación de ArcGIS que pueda mostrar un servicio de mapas utiliza la caché, aunque la manera en la que se recuperan y utilizan las teselas varía entre las aplicaciones.
Aplicaciones Web
Al desarrollar con ArcGIS API for JavaScript, utiliza una clase concreta para especificar que se está conectando a un servicio de mapas teselado (en caché). Por ejemplo, utiliza ArcGISTiledMapServiceLayer para conectarse a un servicio en caché. Cuando utiliza el servicio en caché, las teselas se recuperan del directorio de caché mediante las llamadas REST al servicio de mapas. La solicitud de tesela toma la forma http://<map service URL>/tile/<level>/<row>/<column>.
Si está viendo un servicio en caché simple en cualquier aplicación Web y realiza un desplazamiento panorámico en un área donde no existen teselas, la aplicación no muestra una imagen dinámica; por lo contrario, no ve nada. Una forma de asegurarse de ver un mapa cuando realiza un desplazamiento panorámico en un área que no está en caché es habilitar la caché según demanda.
Sugerencia:
Si el mapa aparece más lento de lo esperado, examine las direcciones URL de las imágenes de mapa para verificar que la aplicación esté recuperando las teselas. Una forma de hacer esto es abrir la aplicación en Mozilla Firefox y hacer clic en Firefox > Web Developer > Web Console. Cuando aparece la consola, haga clic en el botón Red y haga zoom o realice un desplazamiento panorámico en el mapa.
Si ve direcciones URL como esta, su aplicación está obteniendo las teselas correctamente de las solicitudes REST:
http://gisserver.domain.com:6080/arcgis/rest/services/myService/MapServer/tile/10/1723/3495.jpg
Si ve algún otro formato de dirección URL para sus imágenes de mapa, su aplicación está recuperando la tesela de una manera menos eficiente o la caché no se está usando.
ArcMap y ArcGIS Pro
Agrega servicios de mapas en caché a ArcMap y ArcGIS Pro mediante el botón Agregar datos de la misma manera que agrega cualquier otro servicio de mapas. Hay dos formas en las que puede ver una caché:
- Acceder a la caché a través de un servicio de mapas: para ver una caché de esta forma, examine el servidor SIG y el servicio de mapas que se utilizó para crear la caché. En este escenario, se realiza una conexión inicial al servidor SIG para determinar si el servicio tiene una caché. A continuación, se recuperan las teselas del directorio de caché en el sistema de archivos del servidor.
- Acceder a la caché como un dataset ráster: para ver una caché de esta forma, examine el directorio que contiene las teselas de caché y agregue el dataset. La caché se representa con el mismo icono que se utilizó para agregar todos los otros rásteres mediante el botón Agregar datos. Una caché a la que se accede como ráster es para visualizar solamente y no se puede consultar. La ventaja con este tipo de caché es que no está vinculada a un servicio de mapas y se puede visualizar cuando está desconectada del servidor, siempre y cuando pueda acceder al directorio de caché.
Cuando se realiza una solicitud de una tesela en una escala que coincide exactamente con un nivel de escala en la caché, el servicio de mapas devuelve la tesela directamente. Con mayor frecuencia, las solicitudes no coinciden exactamente con los niveles de escala en la caché. En esta situación, se solicita y remuestrea la tesela del nivel de escala más cercano para que coincida con la escala solicitada. Este remuestreo es aún más rápido que generar una tesela dinámicamente; sin embargo, da como resultado una imagen que tiene un aspecto diferente de la tesela original. Las etiquetas de mapa que se almacenaron en la caché pueden ser difíciles de leer en ciertas escalas debido a este remuestreo. Para obtener mejores resultados, visualice el mapa en o cerca de las escalas a partir de las cuales se creó la caché.
ArcGlobe y ArcGIS Explorer
ArcGlobe y ArcGIS Explorer pueden leer cachés 2D y desplegarlas sobre la superficie del globo. Obtendrá el mejor rendimiento si crea la caché con el esquema de ordenamiento en teselas ArcGIS Online/Bing Maps/Google Maps. Si no puede utilizar uno de estos esquemas de ordenamiento en teselas, su un mejor rendimiento resultará de utilizar la caché de servicios de globo.
Un escenario donde es posible que desee agregar un servicio de mapas en ArcGlobe es cuando creó una caché de mapa 2D y desea crear una caché de globo 3D idéntica a partir de la caché 2D. En este escenario, sólo le preocupará generar la caché y no navegar por el globo.
Mejorar el rendimiento en la visualización de servicios de mapas en caché
Cuando los clientes envían peticiones a ArcGIS Server para visualizar un servicio de mapas, por lo general, la respuesta del servidor queda en caché en el servidor y se reutiliza durante cierto tiempo. Este comportamiento ayuda a ArcGIS Server a lograr el mejor rendimiento de visualización posible del servicio de mapas. No obstante, según cómo se utilicen el servicio de mapas y sus datos asociados en aplicaciones, es posible que deba ajustarse el tiempo durante el cual el navegador debe utilizar una respuesta del caché. Esto se puede lograr agregando una propiedad llamada cacheControlMaxAge a la Notación de objetos JavaScript (JSON) del servicio.
Cómo se utiliza la propiedad cacheControlMaxAge
Las respuestas de los servicios de mapas de ArcGIS Server incluyen una etiqueta de entidad (ETag) y un encabezado Cache-Control. El valor del encabezado ETag es un identificador único de la respuesta. El encabezado Cache-Control tiene un valor max-age que proporciona información al navegador en relación con el tiempo máximo durante el cual se puede reutilizar la respuesta del caché del navegador. Este valor se controla mediante la propiedad cacheControlMaxAge.
Si una solicitud se repite y no se ha superado la duración máxima del caché, el navegador utiliza la respuesta del caché sin enviar la solicitud al servidor. Si se ha superado la duración máxima del caché, el navegador debe enviar la solicitud al servidor y establecer un encabezado IF-NONE-MATCH con un valor de ETag asociado correspondiente a la respuesta en su caché. ArcGIS Server evalúa la solicitud y utiliza el valor de ETag para determinar si la respuesta ha cambiado. Si la respuesta del servidor es distinta de la copia que hay en el navegador, el servidor envía una respuesta totalmente nueva al navegador. Si la respuesta es idéntica a la copia que hay en el navegador, el servidor alerta al navegador para que continúe utilizando la respuesta que tiene en el caché.
Definición del valor de la propiedad cacheControlMaxAge
Como administrador de ArcGIS Server, puede definir la propiedad cacheControlMaxAge para especificar durante cuánto tiempo se permite al navegador utilizar una respuesta que esté en el caché. Puesto que se reduce la necesidad de que ArcGIS Server envíe respuestas completas, esto permite que el caché del navegador sea más eficiente, ayuda a optimizar las aplicaciones y ahorra ancho de banda.
Para servicios de mapas en caché que no permitan a los clientes poner teselas en el caché localmente, el valor predeterminado es 0. Esto significa que el navegador siempre vuelve a enviar las solicitudes y que ArcGIS Server procesará las solicitudes y enviará respuestas completas al navegador si el contenido ha cambiado. Este valor funciona correctamente para la mayoría de aplicaciones.
En el caso de servicios de mapas que permitan a los clientes poner las teselas en el caché local, el valor predeterminado es 86.400 segundos (1 día). Esto significa que si una solicitud se repite en un plazo de 1 día, el navegador volverá a utilizar la respuesta de su caché.
En el caso de servicios de imágenes en los cuales el mapa o los datos no cambien frecuentemente, se recomienda aumentar el valor predeterminado hasta 30 días (2.592.000 segundos) o más para minimizar el tráfico de la red.
Para agregar la propiedad cacheControlMaxAge a un servicio y especificar su valor predeterminado, se hace así:
- En un navegador web, abra el Directorio del administrador de ArcGIS Server e inicie sesión con un usuario que tenga privilegios de administración. La URL tiene el formato http://gisserver.domain.com:6080/arcgis/admin.
- Haga clic en servicios y seleccione el servicio de mapas que desee modificar en la lista Servicios. Si no ve el servicio en la lista, es posible que se encuentre en un directorio debajo de la carpeta Raíz.
- En la página Servicio - <nombre de servicio> (<tipo de servicio>), desplácese a la parte inferior y haga clic en editar.
- En el cuadro de diálogo Propiedades del servicio, busque la sección properties del JSON del servicio.
- Agregue la propiedad cacheControlMaxAge a la sección y especifique el valor (en segundos) de la propiedad. Por ejemplo:
"properties": { "cacheControlMaxAge": "2592000", - Haga clic en Guardar cambios.
- En la página Servicio - <nombre del servicio> (<tipo de servicio>), compruebe que la propiedad cacheControlMaxAge y el valor especificado aparezcan en la sección Propiedades.
Almacenamiento en caché local de capas en ArcGIS for Desktop
ArcGIS for Desktop (ArcMap, ArcGIS Pro, ArcGIS Explorer y ArcGlobe) mantienen cachés locales de las teselas que visitó. Cuando hace zoom y se desplaza por estas áreas, las aplicaciones utilizan la caché local y no tienen que volver a recuperar las teselas del servidor.
Puede elegir si desea guardar la caché local en el disco para utilizarla en sesiones futuras o utilizar la caché local para la sesión actual solamente.
También puede elegir no guardar las teselas en la caché local. Aunque esto hace que pierda el beneficio de rendimiento del almacenamiento en caché local, siempre puede asegurarse de que obtiene la última tesela del servidor.
Es posible que el administrador del servidor haya deshabilitado el almacenamiento en caché local de la capa, lo que también significa que siempre obtiene la tesela más actualizada. Si este es el caso, las otras opciones para guardar la caché localmente no están disponibles.
Si el administrador del servidor actualiza un área de la caché del servidor que ya observó, debe borrar la caché local para ver los cambios. ArcGIS for Desktop no puede detectar si se actualizó una caché. Si es administrador del servidor, debe alertar a los usuarios cuando estén disponibles los datos actualizados para que sepan que deben borrar sus cachés.
Superponer cachés
Al diseñar cachés de mapa que se superpondrán con otras cachés de mapa, hay algunos factores de diseño de caché importantes a considerar según qué aplicación se utilizará para ver las cachés.
Superponer caché de mapa en aplicaciones Web
Las aplicaciones Web creadas con ArcGIS API for JavaScript requieren que haga coincidir el sistema de coordenadas y el tamaño de teselas cuando superponga las cachés. También es una buena práctica hacer coincidir la mayor cantidad de escalas posible.
La forma más sencilla de hacer esto es hacer coincidir los esquemas de ordenamiento en teselas para las dos cachés y, a continuación, crear solamente las teselas en las escalas que tienen sentido para cada caché. De esta manera, puede asegurarse de que hizo coincidir el sistema de coordenadas y el tamaño de teselas y de que el software reconoce que las dos cachés tienen escalas en común.
Superponer cachés de mapa en ArcMap y ArcGIS Pro
Puede superponer cualquier cantidad de cachés de mapa en ArcMap y ArcGIS Pro. Las cachés no necesitan tener los mismos esquemas de ordenamiento en teselas o proyecciones; sin embargo, debido al remuestreo o reproyección que se realiza, utilizar esquemas de ordenamiento en teselas y proyecciones equivalentes puede mejorar la calidad de rendimiento y estética de su mapa.
Forzar un dibujo dinámico
Hay ocasiones en las que podría querer obligar al servicio a ignorar la caché y se dibujar dinámicamente, incluso cuando las teselas están disponibles en algunos niveles. Por ejemplo, imagine que está desarrollando una aplicación Web con ArcGIS API for JavaScript. Usted tiene un mapa que se almacena en la caché de los niveles de zoom 0-15, pero se dibujan dinámicamente desde los niveles 16-19. Este podría ser el caso si desea mostrar los datos en tiempo real en grandes escalas, o si el mapa abarca demasiado espacio de un área que se almacena en caché en grandes escalas.
La solución a esta situación es habilitar las capas dinámico en el servidor y especificar en su mapa a escalas 16-19 que desea utilizar la dinámica capas. De lo contrario, el servicio devolverá un mapa construido a partir de teselas disponibles, que estará en blanco en zonas donde no existen teselas.