This document is archived and information here might be outdated.  Recommended version.

ITiledMapServer2 Interface (ArcObjects .NET 10.5 SDK)

ArcObjects Library Reference (Carto)

ITiledMapServer2 Interface

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

[C#]

Example 1: Print Cache Service's Description Information

/*
 *  The function prints all information coming from ICacheDescriptionInfo
 *  Inputs: a TiledMapServer2 object
 *  a map (dataframe) name
 *  Outputs: all information are printed on .NET Console
 */
private void printCacheInfo(ITiledMapServer2 pTiledMap2, string sMapName)
{
    ICacheDescriptionInfo pCacheDscInfo=pTiledMap2.GetCacheDescriptionInfo(sMapName);
    ICacheControlInfo pCacheCtrlInfo=pCacheDscInfo.CacheControlInfo;
    ILayerCacheInfos pLyrCacheInfos=pCacheDscInfo.LayerCacheInfos;
    ITileCacheInfo pTileCacheInfo=pCacheDscInfo.TileCacheInfo;
    ILODInfos pLODInfos=pTileCacheInfo.LODInfos;
    ITileImageInfo2 pTileImgInfo2=pCacheDscInfo.TileImageInfo as ITileImageInfo2;

    Console.WriteLine("CacheType: " + pCacheDscInfo.CacheType.ToString());
    Console.WriteLine("CacheControlInfo::");
    Console.WriteLine("   ClientCachingAllowed: " + pCacheCtrlInfo.ClientCachingAllowed.ToString());
    Console.WriteLine("LayerCacheInfos::");
    for (int i=0; i < pLyrCacheInfos.Count; i++)
        Console.WriteLine("   ID: " + pLyrCacheInfos.get_Element(i).ID.ToString() + "; HasCache: " + pLyrCacheInfos.get_Element(i).HasCache.ToString());
    Console.WriteLine("TileCacheInfo::");
    Console.WriteLine("   DPI: " + pTileCacheInfo.Dpi.ToString());
    Console.WriteLine("   Origin: " + pTileCacheInfo.Origin.X.ToString() + "," + pTileCacheInfo.Origin.Y.ToString());
    Console.WriteLine("   SRS: " + pTileCacheInfo.SpatialReference.Name);
    Console.WriteLine("   TileCols: " + pTileCacheInfo.TileCols.ToString());
    Console.WriteLine("   TileRows: " + pTileCacheInfo.TileRows.ToString());
    Console.WriteLine("   LODInfos::");
    for (int i=0; i < pLODInfos.Count; i++)
        Console.WriteLine("      LevelID: " + pLODInfos.get_Element(i).LevelID + "; Resolution: " + pLODInfos.get_Element(i).Resolution + "; Scale: " + pLODInfos.get_Element(i).Scale);
    Console.WriteLine("TileImageInfo::");
    Console.WriteLine("   Antialiasing: " + pTileImgInfo2.Antialiasing.ToString());
    Console.WriteLine("   CompressionQuality: " + pTileImgInfo2.CompressionQuality.ToString());
    Console.WriteLine("   Format: " + pTileImgInfo2.Format);
}

 

 

Example 2: Find out map tiles for Single Fused Cached Service that intersects with a map extent at a specific scale

/*
 * The funtion computes tile�s URLs that interects the specified map extent
 * Inputs: a TiledMapServer
 *           map (dataframe) name
 *           sTileHandlerURL: is the endpoint URL for the service can be access from IAGSServerObjectName.URL property
 *           MapExtent for which tiles will be calculated
 *           a CacheDescriptionInfo object
 *           Cached scale
 * Outputs: (1) Prints Static URLs for each tile on .NET Console
 *              (2) Prints URLs for each tile (to be used with TileHandler) on .NET Console
 */
private void getMapTilesURL(ITiledMapServer2 pTileMapServer2, string sMapName, string sTileHandlerURL, IEnvelope pMapExtent, double dScale)
{
    ICacheDescriptionInfo pCacheDescriptionInfo=pTileMapServer2.GetCacheDescriptionInfo(sMapName);
    string sCachedVirtualDirectory=pTileMapServer2.GetVirtualCacheDirectory(sMapName, -1);    //LayerID=-1 for Single Fused Cached

    IPoint pTileOrigin=pCacheDescriptionInfo.TileCacheInfo.Origin;
    double dblOriginX=pTileOrigin.X;
    double dblOriginY=pTileOrigin.Y;

    /***********************
     * Getting cache resolution & levelID for the specified scale
     ***********************/
    ILODInfos pLODInfos=pCacheDescriptionInfo.TileCacheInfo.LODInfos;
    double dLODResolution=-1; int iLevelID=0;
    for (int i=0; i < pLODInfos.Count; i++)
    {
        if (pLODInfos.get_Element(i).Scale == dScale)
        {
            dLODResolution=pLODInfos.get_Element(i).Resolution;
            iLevelID=pLODInfos.get_Element(i).LevelID;
            break;
        }
    }
    if (dLODResolution == -1)
    {
        Exception e=new Exception(String.Format("LOD for Scale:{0} not found!",dScale));
        throw e;
    }

    /***********************
     * Finding the tile that contains map extent's upper-left & lower-right corner
     ***********************/
    //Calculating Tile's width & height in map unit
    double dblTileWidth=pCacheDescriptionInfo.TileCacheInfo.TileCols * dLODResolution;
    double dblTileHeight=pCacheDescriptionInfo.TileCacheInfo.TileRows * dLODResolution;

    IPoint pPntExtentUL, pPntExtentLR;
    pPntExtentUL=pMapExtent.UpperLeft;
    pPntExtentLR=pMapExtent.LowerRight;
   
    // Tile's Row & Column for map's upper-left corner
    int intULTCOL=(int)Math.Floor((pPntExtentUL.X - dblOriginX) / dblTileWidth);
    int intULTROW=(int)Math.Floor((dblOriginY - pPntExtentUL.Y) / dblTileHeight);

    // Tile's Row & Column for map's lower-right corner
    int intLRTCOL=(int)Math.Floor((pPntExtentLR.X - dblOriginX) / dblTileWidth);
    int intLRTROW=(int)Math.Floor((dblOriginY - pPntExtentLR.Y) / dblTileHeight);

    /***********************
     * Generating URL for each tile that intersects with the map extent
     ***********************/
    string sImgExtension="";
    if (pCacheDescriptionInfo.TileImageInfo.Format == "JPEG")
        sImgExtension="jpg";
    else
        sImgExtension="png";

    string url;
    for (int r=intULTROW; r <= intLRTROW; r++)
    {
        for (int c=intULTCOL; c <= intLRTCOL; c++)
        {
            url=string.Format("L{0:D2}/R{1:D8}/C{2:D8}",iLevelID,r,c);
            Console.WriteLine(sCachedVirtualDirectory + "/" + url + "." + sImgExtension);
            Console.WriteLine(sTileHandlerURL + string.Format("?mapname={0}&layer={1}&level={2}&row={3}&column={4}&format={5}", sMapName, "_alllayers", iLevelID, r, c, sImgExtension));
        }
    }
}

 

 

Example 3: Getting image for a specific tile using GetMapTileEx() function for a Single Fused Cached serivce

/*
 * The funtion gets tiles using GetMapTileEx() function and load that on a PictureBox control
 * Inputs: a TiledMapServer
 *   Level Id
 *  Row Id
 *  Column Id
 *  Image format (by using ICacheDescriptionInfo.TileImageInfo.Format property)
 */
private void getMapTileImg(ITiledMapServer2 pTileMapServer2, int l, int r, int c, string format)
{
    int f=0;
    switch (format)
    {
        case "PNG":
            f=0;
            break;
        case "PNG24":
            f=1;
            break;
        case "PNG32":
            f=2;
            break;
        case "JPEG":
            f=3;
            break;
        default:
            f=0;
            break;
    }

    byte[] imgTile;
    try
    {
        imgTile=pTileMapServer2.GetMapTileEx(m_strDefMapName, l, r, c, f);
    }
    catch (Exception)
    {
        MessageBox.Show(String.Format("Problem loading tile for Level:{0}, Row:{1}, Col: {2}", l, r, c), "", MessageBoxButtons.OK, MessageBoxIcon.Error);
        return;
    }
    MemoryStream ms=new MemoryStream(imgTile);
    Bitmap bmp=new Bitmap(ms);

    pictureBox1.Image=bmp;
}