Overlaying your own caches with ArcGIS Online services in the Java Web ADF

When you create any cache that will be used with an ArcGIS Online layer in the Java Web ADF, the following items require attention:

Coordinate system of your map

Ensure your map is in the same coordinate system as ArcGIS Online services, which is WGS 1984 Web Mercator (Auxiliary Sphere). If you choose to not use this coordinate system, your map will need to be projected on the fly and you will lose the advantage of the cache.

Tile origin and tile size

The tile origin represents the upper left corner of the geographic extent covered by the cache tiles. When building any cache that will be viewed through the Java Web ADF, you should avoid placing the tile origin at any point inside the full extent of the map. Placing the tile origin on the upper left corner of the full extent is appropriate.

When entering the parameters for the map cache, avoid changing the tile origin that appears by default. This value is derived automatically from the upper left corner of the full extent of the map document.

When overlaying caches in the Java Web ADF, the tile origins of the caches are not required to match. The tile sizes can also differ between caches.

Scale levels

When you add any cached service to your map, your map becomes visible only at the scale levels of that cached service. When you add two or more cached services to your map, the map becomes visible at all scale levels in all the cached services. However, the caches will only overlay at the scale levels they have in common.

To provide a smooth navigation experience for the users of your Web applications, ensure that the scale levels in your caches match whenever possible. Failure to sequentially match the scales of the caches could result in layers not being visible at expected scales. For example, in the diagram below, Cache A was not created at scale level 3, therefore when the user zooms to scale 3, only Cache B will be visible. Similarly, at scale level 5, Cache A will not be available, but since it is common behavior for a layer to become unavailable at a minimum or maximum scale, this may not present the same problem as the gap at scale level 3.

Many of the caches for ArcGIS Online services have worldwide coverage at a large variety of scales. You do not need to create your cache using all of these scales, but where possible, the scale levels you use should match the ones used by ArcGIS Online services.

When you build your cache to overlay ArcGIS Online services, choose to load an existing tiling scheme. Then choose the ArcGIS Online service tiling scheme from the drop-down list. This will populate all the high-precision scale values automatically. You can then add and remove scales as needed.

Image format

The basemap services from ArcGIS Online use the JPEG image format, while the reference overlay caches use 24-bit PNG. Although the JPEG format displays faster than other formats, it does not support transparency. Therefore, any basemap services from ArcGIS Online will obscure layers that are placed beneath them. Similarly, if you create your own JPEG cache, you will not be able to see any layers you place beneath it.

When overlaying two PNG 24-based caches, be aware that PNG 24 files do not show transparency in Internet Explorer 6. (See the related Microsoft technical article). In this scenario, the bottom cache will be obscured.

Related Topics


11/18/2013