L.esri.Request

Generic methods for GET and POST requests to ArcGIS Online or ArcGIS Server resources. These methods will handle serializing the input parameters and parsing of the response, making them available in a callback function via a response and error property similar to Node JS.

GET requests will be made with XMLHttpRequest (via CORS) if the browser supports it and will fallback to JSONP. POST requests will always be made with XMLHttpRequest (via CORS) but the ArcGIS API for JavaScript proxy and the ArcGIS Resource Proxy are support via L.esri.Services.Service.

If you are using a version of ArcGIS Server before 10.1 your server does not support CORS by default. Either enable CORS support on your server, documentation is available at http://enable-cors.org/. If you cannot or do not want to enable CORS on your server the following code will make all requests utilize JSONP.

L.esri.get = L.esri.Request.get.JSONP;

L.esri.request(url, params, callback);

Executues a GET or POST via XMLHttpRequest or JSONP request depending on the capabilities of the browser and the length of the request. GET is used when the browser supports CORS and the request url is less then 2000 characters. POST is used when the browser supports CORS and the request exceeds 2000 characters. JSONP is used when the request is less then 2000 characters and the browser does not support CORS.

Params

Param	Value	Description
url	String	The URL to request.
params	Object	The parameters to send as a query string.
callback	Function	Function to run when the request completes, will be passed an error and response.
context	Object	Optional function context for the callback.

Example

L.esri.request('http://services.arcgis.com/rOo16HdIMeOBI4Mb/arcgis/rest/services/Heritage_Trees_Portland/FeatureServer/0', {}, function(error, response){
  if(error){
    console.log(error);
  } else {
    console.log(response.name);
  }
});

L.esri.get(url, params, callback)

Execute a GET request via `XMLHttpRequest' (via CORS) or JSON depending on what is available in the browser.

Note: ArcGIS Server before 10.1 does not have CORS support enabled by default. You can either enable CORS on your server or tell Esri Leaflet to always make JSONP requests with L.esri.get = L.esri.Request.get.JSONP; After you load Esri leaflet, but before calling your own scripts.

Params

Param	Value	Description
url	String	The URL to request.
params	Object	The parameters to send as a query string.
callback	Function	Function to run when the request completes, will be passed error and response.
context	Object	Optional function context for the callback.

Example

L.esri.get('http://services.arcgis.com/rOo16HdIMeOBI4Mb/arcgis/rest/services/Heritage_Trees_Portland/FeatureServer/0', {}, function(error, response){
  if(error){
    console.log(error);
  } else {
    console.log(response.name);
  }
});

L.esri.post(url, params, callback)

Execute a POST request via `XMLHttpRequest' (via CORS).

This request is made via XMLHttpRequest which cannot make cross domain requests in IE 8 and 9. Esri Leaflet supports both the ArcGIS API for JavaScript proxy and the ArcGIS Resource Proxy which can be hosted on your server and used with the L.esri.Services.Service classes to work around this issue.

Param	Value	Description
url	String	The URL to request.
params	Object	The parameters to send as a query string.
callback	Function	Function to run when the request completes, will be passed error and response.
context	Object	Optional function context for the callback.

Example

L.esri.post('http://services.arcgis.com/rOo16HdIMeOBI4Mb/arcgis/rest/services/Heritage_Trees_Portland/FeatureServer/0', {}, function(error, response){
  if(error){
    console.log(error);
  } else {
    console.log(response.name);
  }
});

Edit this page on GitHub