The REST API supports responses in several formats. You specify the response format using the query parameter f
. A list of valid formats is included for each of the resources and operations where f
is a parameter.
- f=html: Default format unless otherwise stated. The response is an HTML page. The set of these HTML pages for each resource in the system is called the Services Directory.
To view the Services Directory page for the root directory of ArcGIS Online, you would use the following URL:
Note that since "html" is the default value, you are not required to include this parameter in the URL. This means that the above URL is equivalent to the following URL:
- f=json: The response is a JSON object. This format is used primarily by the JavaScript APIs.
To retrieve the information in a JSON object, you would use the following URL:
You can also reference a callback function in the URL:
http://server.arcgisonline.com/arcgis/rest/services?f=json&callback=myMethod
If you want the JSON object to be more readable, you can use pjson
. You should not include this parameter in your production applications as it will affect performance. Use the parameter for debugging purposes only.
- f=amf: The response is in Action Message Format, which is a binary format used to serialize ActionScript objects. This format is primarily
for Adobe Flex / Adobe AIR clients, as it is much more efficient than JSON for large responses. AMF is supported in Query / Query related operations for
both Map and Feature services. It is also supported in Synchronous GP, and for fetching the results of a Async GP operation.
- f=image: The response is a streamed image. No other information is included in the response.
- f=help: The response is a context sensitive help document. The following URL opens the Help on the page that provides information about the map service resource:
- f=lyr: Generates a layer file for viewing in ArcMap:
- f=nmf: Generates a layer file for viewing in ArcGIS Explorer:
- f=jsapi: The response is a Web page for viewing a map service in a Web browser using the ArcGIS JavaScript API.
- f=ve: The response is a Web page for viewing a map service in a Web browser using Bing Maps. Note that this format is supported only when the service is cached and in the Web mercator projection (102113, 102100 or 3857):
- f=gmaps: The response is a Web page for viewing a map service in a Web browser using Google maps. Note that this format is supported only when the service is cached and in the Web mercator projection (102113, 102100 or 3857):
- f=kmz: The response is a KML document wrapped in a KMZ file. It may be a footprint or the result of an operation.
In the following example, a request is made for a KML footprint of a map service with an extent of the United States:
For more information about kml as an output option, see KML support.