Agenda. Introduction. Supported Formats. Creating a Custom REST Service. What s Next

Transcription

1 Using the ArcGIS Server REST API Jeremy Bartley Keyur Shah

2 Agenda Introduction Design and Concepts Supported Formats REST API Admin Creating a Custom REST Service What s New (Since 9.3) What s Next Conclusion ESRI Developer Summit

3 Agenda Introduction Design and Concepts Supported Formats REST API Admin Creating a Custom REST Service What s New (Since 9.3) What s Next Conclusion ESRI Developer Summit

4 Introduction Developers should do simple things simply ArcGIS Server is REST enabled Available in both Java and.net Server ArcGIS Server embraces open web standards ESRI Developer Summit

5 ArcGIS Server can work with many different clients Yh Yahoo Pipes SAP Google Maps PopFly.Net Java ArcGIS Explorer Microsoft Virtual Earth Flex/Flash Microsoft Silverlight Yahoo! Maps Google Earth ArcMap Ruby OpenLayers Python PHP ArcGIS Mobile ESRI Developer Summit

6 ArcGIS Server Services Map Based on a Map Document (.mxd) authored using ArcMap Can be used to identify features on the map Can be used to query individual layers in the map Geocode Published locator file that can be used to perform find address and find location Geometry A computational service, not bound to any data on the server. New at 9.3 An ArcGIS Server can host a Geometry Service Provides basic geometric operations for use by web service clients ESRI Developer Summit

7 ArcGIS Server Services Geoprocessing Allows organizations to centralize both data and processing on the server Exposes spatial analysis functionality as easy to use tasks Allows GIS Analysts to easily author and publish geoprocessing models ImageServer, Geodata, Network Analysis ESRI Developer Summit

8 ArcGIS Server Publishing GIS Web Services Author GIS resources (eg maps, locators, models) using desktop. Publish GIS resources to create GIS Services. Each capability is exposed to consumers as an independent GIS Web Service accessible through SOAP or REST ESRI Developer Summit

9 Agenda Introduction Design D i and Concepts Supported Formats REST API Admin Creating a Custom REST Service What s New (Since 9.3) What s Next Conclusion ESRI Developer Summit

10 REST The Elevator Pitch 4 Key Principles * Identification Of Resources Manipulation Of Resources Through Representations Self-Descriptive Messages Hypermedia As The Engine Of Application State Everything is a URL Exchange standard formats using standard verbs Every request asks the full question, every response includes the full answer Hyperlinks <a href= url >Yeah!</a> *Thank you: ESRI Developer Summit

11 Everything is a URL Hierarchy of resources Catalog, C t l Services (Map, Geocode, etc.), Layers, Tasks, etc. wget, curl... JavaScript, Ruby, Python, Perl... Java,.NET interoperable Bookmark-able Browser is the new command line ESRI Developer Summit

12 HTTP Goodness HTTP as an application protocol Cache-Control headers ETags (Conditional GETs) Compression (gzip) Status codes ESRI Developer Summit

13 Agenda Introduction Design and Concepts Supported Formats REST API Admin Creating a Custom REST Service What s New (Since 9.3) What s Next Conclusion ESRI Developer Summit

14 Supported Formats All REST URLs support an f (format) parameter Default is html List of supported formats html (Services Directory) json kmz image help lyr, nmf, jsapi, gmaps, ve ESRI Developer Summit

15 f=html Services Directory simple and instant access to Service Level Metadata Designed to be a developer tool Developers who work with the Web APIs might not work with the json responses directly, but will work with the Services Directory. ESRI Developer Summit

16 f=json Used by the Web client libraries Can be used by any programming language JSON with callbacks f=json&callback=mymethod Pretty JSON f=pjson More readable For debugging purposes only ESRI Developer Summit

17 f=kmz Out of the box KML support in ArcGIS Server for Map and image service footprints Fused raster representation for map and image services Regionated and Dynamic Ground Overlays Query Results Geocode Results Geoprocessing task results You can build Web pages that contain links to the above KML content ESRI Developer Summit

18 Agenda Introduction Design and Concepts Supported Formats REST API Admin Creating a Custom REST Service What s New (Since 9.3) What s Next Conclusion ESRI Developer Summit

19 REST API Admin Currently supports only two administrative options Disable Services Directory Clear REST Cache Important Note: Always clear the REST API Cache whenever you add, delete or update services Access to REST Admin is secured Only agsadmin users can login (same as Manager) ESRI Developer Summit

20 Agenda Introduction Design and Concepts Supported Formats REST API Admin Creating a Custom REST Service What s New (Since 9.3) What s Next Conclusion ESRI Developer Summit

21 Creating a Custom REST Service Web APIs work with RESTful services Use Cases SOAP API feature not support by REST Custom data (for ex. database tables) Custom Server Object Extensions ESRI Developer Summit

22 Custom REST Service Guidelines Only one required rule Everything is a URL Good Principles Natural URI Design 4 REST Principles HTTP Goodness Unsafe operations!= GET JSON, JSONP (JSON with padding / callback) Error Handling ESRI Developer Summit

23 Custom REST Service Feature Response Feature = Geometry + Attributes { geometry : { }, attributes : { } } Geometry Objects Attributes Dictionary of field name field value pairs { field1 : value1, field2 : 2, } ESRI Developer Summit

24 Agenda Introduction Design and Concepts Supported Formats REST API Admin Creating a Custom REST Service What s New (Since 9.3) What s Next Conclusion ESRI Developer Summit

25 What s New (Since 9.3) Quality and Performance Improvements Solve Route Operation on Route Layers Simple Routing Advanced Features: Time Windows, Impedance Attributes, etc. Improved Search-ability Public Services Directories are already searchable Register sitemaps and geositemaps with search engines f=sitemap, f=geositemap ESRI Developer Summit

26 Agenda Introduction Design and Concepts Supported Formats REST API Admin Creating a Custom REST Service What s New (Since 9.3) What s Next Conclusion ESRI Developer Summit

27 What s Next Feature Editing Service New Geometry Service Operations Service Area and Closest Facility Solvers Publish Standalone Tables Scriptable REST Admin Faster JSON Generation ESRI Developer Summit

28 Agenda Introduction Design and Concepts Supported Formats REST API Admin Creating a Custom REST Service What s New (Since 9.3) What s Next Conclusion ESRI Developer Summit

29 Conclusion Open API accessible from a gamut of clients Continues to evolve New features, quality and performance improvements Adheres to HTTP standards Services Directory = Instant access to service level metadata Publish a service = KML support Add, delete, update services = Clear REST API Cache ESRI Developer Summit

30 Post-Conclusion 3 points to remember Everything is a URL Everything is a URL Everything is a URL ESRI Developer Summit