Esri ArcGIS REST API’s

Retired Version

This reference documents version 1.0 (a retired version) of MapData Services Esri Map Service. This version of the API is now retired and is no longer available for use.

Table of Contents

Security
Request
Response
Examples

What is Esri Map Service?

The Map Service (http://resources.arcgis.com/en/help/rest/apiref/mapserver.html) is a RESTful API that fulfills requests with pre-created tiles from a cache. To consume the Map Service you will need to use a Esri mapping API or Desktop product

The ESRI Map Service provides maps in the Web Mercator projection for 18 levels/Scales.

Security

This service supports Token based Authentication (Specified Tile Sets only).

Request

Each request to the Service must be a URI in the following format:

    http://{catalog}/{tileset}/MapServer?token={token}
Parameter Type Description
Catalog String The name of the MapData Services Service Catalog
Tileset String The name of the Tile Set
Token String The token required to access secure Map Services (Optional)

Response

The responses from the service are in the .png format.

Available Tile Sets

A Tile Set is a Raster Visualisation of a Data Set. The following Tile Sets are available via the Map Service.

MDS Foundation Map

The MDS Foundation Map Tile Set is a Colour Base Map for Australia and New Zealand.

MDS Foundation Map GreyScale

The MDS Foundation Map Grey Scale Tile Set is a Grey Scale Base Map for Australia and New Zealand. (Requires Token)

Examples

JAVASCRIPT

In the Javascript API, the MDS Foundation Map is referenced like any other Tiled Map Service. The example below shows the simplest case of using the Foundation Map as a base map layer in a JavaScript application.

  
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
        <mets http-equiv="X-UA-Compatible" content="IE=7"/>
        <!-- The viewport meta tag is used to improve the presentation and behavior of the samples on ios devices -->
        <meta name="viewport" content="intial-scale=1, maximum-scale=1, user-scalable=no" />
        <title>Create Map</title>
        <link rel="stylesheet" type="text/css" href="http://serverapi.arcgisonline.com/jsapi/arcgis/2.1/js/dojo/dijit/themes/claro/claro.css">
        <script type="text/javascript" src="http://serverapi.arcgisonline.com/jsapi/arcgis/?v=2.1"></script>
        <script type="text/javascript">
            dojo.require("esri.map");
            function init(){
                var map = new esri.Map("map");
                var tiledMapServiceLayer = new esri.layers.ArcGISTiledMapServiceLayer("<!-- Insert Request Uri Here -->");
                    map.addLayer(tiledMapServiceLayer);
            }
            dojo.addOnLoad(init);
        </script>
    </head>
    <body class="claro">
        <div id="map" style="width: 900px; height:600px; border 1px solid #000;"></div>
    </body>
</html>   
 

FLEX

In the Flex API, the MDS Foundation Map is referenced like any other Tiled Map Service. The example below shows the simplest case of using the Foundation Map as a base map layer in a Flex application.

 
<?xml version="1.0" encoding="utf-8"?>  
<s:Application   xmlns:fx="http://ns.adobe.com/mxml/2009"  
                    xmlns:s="library://ns.adobe.com/flex/spark"  
                    xmlns:esri="http://www.esri.com/2008/ags"  
                    pageTitle="A tiled map service">  
    <esri:Map>  
        <esri:ArcGISTIledMapServiceLayer url="<!-- Insert Request Uri Here -->"/>  
    </esri:Map>  
</s:Application>