Building Web Services using ArcGIS Server
Access web services through simple APIs
Michele Lundeen & Steve Mulberry
SERUG 2008
Agenda
ArcGIS Server GIS services
APIs SOAP, ArcObjects, REST
Service Types and Capabilities
Web Enabling
Demonstration - Publish, Enable, Test
SOAP web services
Definitions of Components
Demonstration Developer consuming GIS Services via SOAP
ArcObjects functioanlity exposed via a web services
Demonstration Calling ArcObjects functionality via a web service
Consuming Web Services with New 9.3 APIs
Demonstrations
How to get started?
Training
Helpful Links
ArcGIS Server - Web Services
ArcGIS Server GIS services
SOAP API
ArcObjects API
REST API and JavaScript API
How to get started?
What are ESRI GIS Services?
Out - of - Box
Mapping (2D & 3D)
Mobile
KML
Geodatabase
Geoprocessing
Locators
ESRI
ESRI Web
Web Services
Services
Clients
ArcGIS Desktop
Mobile
Web Applications
ArcGIS Explorer
SERUG 2008
ArcGIS Server
GIS Service types
Coorespond to items that can be published
5 available at 9.2
7 available at 9.3
ArcGIS Server: GIS Services
Each service type has one or more capabilities
Map Service
Map (always)
KML
WMS
WFS
WCS
Mobile Data Access
Network Analysis
Geodatabase
Geodata (always)
WFS
WCS
Geocode Service
Geoprocessing Service
Globe Service
Geometry Service
Image Service
ArcGIS Server: Web Enable GIS Capabilities
Use Server Manager or ArcCatalog
Check box enables web access
Provides URL
Demonstration
Publishling GIS Services for Web Access
SERUG 2008
What are ESRI GIS Services?
Out - of - Box
Mapping (2D & 3D)
Mobile
KML
Geodatabase
Geoprocessing
Locators
ESRI
ESRI Web
Web Services
Services
Clients
ArcGIS Desktop
Mobile
Web Applications
ArcGIS Explorer
SERUG 2008
ArcGIS Server - Web Services
ArcGIS Server GIS services
SOAP API
ArcObjects API
REST API and JavaScript API
How to get started?
What are SOAP Web Services?
Standard way of integrating Web based applications using XML,
SOAP, WSDL, and UDDI
Share business logic
Language neutral
Operating system neutral
UDDI
Enables
discovery of
Is accessed
using
Binds to
WSDL
SOAP
Enables
Communication
between
Describes
Web
Services
SERUG 2008
11
Review: What is UDDI?
Universal Description, Discovery and Integration
Registry
Businesses can publish service listing on the internet
Discovery of services
12
Review: What is XML?
Extensible Markup Language
Customized tags
Enables the
Definition
Transmission
Validation
Interpretation of data between applications and between
organizations.
13
Review: What is SOAP?
Used to stand for Simple Object Application Protocol
Application communication over the Internet
XML Messages over HTTP
Web Standard
Platform Independent
Language Independent
Simple and Extensible
Send messages between applications
14
Example SOAP Request
POST /item HTTP/1.1
Host: 189.123.345.239
Content-Type: text/plain
Content-Length: 200
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soapenvelope" soap:encodingStyle="http://www.w3.org/2001/12/soapencoding">
<soap:Body>
<m:GetPrice xmlns:m="http://www.server.com/prices">
<m:Item>Apples</m:Item>
</m:GetPrice>
</soap:Body>
</soap:Envelope>
Example SOAP Response
200 OK
Content-Type: text/plain
Content-Length: 200
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soapenvelope" soap:encodingStyle="http://www.w3.org/2001/12/soapencoding">
<soap:Body>
<m:GetPriceResponse xmlns:m="http://www.server.com/prices">
<m:Price>1.90</m:Price>
</m:GetPriceResponse>
</soap:Body>
</soap:Envelope>
Working with SOAP (outside the Web ADF)
Use a SOAP Toolkit (.NET or Java)
Proxy object (MapServer. GeocodeServer, etc.)
Methods and Properties
Value objects (supporting objects)
Properties
Review: What is WSDL?
Web Services Description Language
XML-based language
Describes what functions are available
Obtaining the WSDL for a service
http://www.xyz.com/service_endpoint?wsdl
SOAP Toolkit
18
Accessing ArcGIS Services via SOAP
No license required to use GIS Services
No ESRI software required
Accessing Services via SOAP
Each capability has a URL which can be referenced
http://www.w.org/arcgis/services/NorthAmerica/MapServer?wsdl
Demonstration
Accessing GIS Services via SOAP
SERUG 2008
21
ArcGIS Server - Web Services
ArcGIS Server GIS services
SOAP API
ArcObjects API
REST API and JavaScript API
How to get started?
What is the ArcObjects API?
Very large API that Supports:
ArcGIS Desktop applications
ArcGIS Engine applications
SOAP and REST ArcGIS Server APIs
Use course grained ArcObjects
Reasons to use ArcObjects API
Access greater functionality
Editing
Geometric Network Traces
Return x,y for Route Name and Measure
Functions not available in course grained objects and not
available via Geoprocessing
Leverage existing code
How to Utilize ArcObjects API
Accessible via ArcGIS Server SOAP API
Via Local Connection Only
Wrap code in a web service to give access to users and
applications over the web
Getting to ArcObjects from Server
Dim GISServerCon As IGISServerConnection = New
GISServerConnectionClass()
GISServerCon.Connect(machineName)
Dim som As IServerObjectManager =
GISServerCon.ServerObjectManager
Dim soc As IServerContext =
som.CreateServerContext(mapService, "MapServer")
Dim mapServer As IMapServer = soc.ServerObject
Dim mapServerObjects As IMapServerObjects2 = mapServer
Dim map As IMap = mapServerObjects.Map(dataFrame)
Demonstration
Accessing a Custom Web Service
SERUG 2008
27
ArcGIS Server - Web Services
ArcGIS Server GIS services
SOAP API
ArcObjects API
REST API and JavaScript API
How to get started?
Consuming Web Services with New 9.3 API
Front ends
JS APIs
Mobile
Applications
Web
Service
Interfaces
Back end
GIS Server
Google
Earth
Composite
Applications
WCS
KML
Browser Applications
WFS-T
REST
SOAP
Web Tier
WMS
ArcGIS
Explorer
ArcGIS
Desktop
Web Controls
Map Caching
Workflows
2D Mapping
3D Globe
Geodatabase
Locator
Geoprocessing
Image
What is REST?
Representational State Transfer
Simple Interface
Requests to the REST API are through HTTP GETS
Hierarchy of Resources
Browser is the new command line
ArcGIS Server provides a REST API at 9.3
http://server/arcgis/rest/services
ArcGIS Server REST API
Example URL:
http://localhost/ArcGIS/rest/services/MyStreets/GeocodeServer/
findAddressCandidates?Street=1058+Citrus+Av&f=html
Returns:
Shape:
X: 872241
Y: 1131422
Score: 100
Match_addr: 1058 CITRUS AVE
ArcGIS Server 9.3 REST API
Resources and operations results can be returned as:
HTML (Services Explorer-default)
IMAGE (direct streamed image)
KML (Google Earth, Google Maps, Virtual Earth)
JSON (developer)
JavaScript Object Notation
32
ArcGIS Server REST API
Resources and Operations:
Map Service
Export, Find, Identify
Map Service Layers
Query
Geocode Service
FindAddressCandidates, Reverse Geocode
Geoprocessing
Execute, Submit Job
ArcGIS Server 9.3 - Developer Experience:
New Services
Geometry Service
Project, Simplify, Buffer, Length And Area, Relation
Image Services
Export
Map example
Base Map URL:
http://atlanta.esri.com/ArcGIS/rest/services/chatham_county/MapServer
Export operation
baseUrl/export?bbox=855242,611406,1095348,838633
Exports Maps based on query
parameters specific to the URL
Demonstrations
1. Using REST API to access GIS Services
2. Building a Simple JavaScript Web Site
3. An Example Site
SERUG 2008
36
ArcGIS Server - Web Services
ArcGIS Server GIS services
SOAP API
ArcObjects API
REST API and JavaScript API
How to get started?
Choose the API for your requirements
ESRI ArcGIS Server Training
Introduction to ArcGIS Server (2 days)
Developing Applications Using ArcGIS Server for .NET (3 days)
Developing Applications Using ArcGIS Server for Java (3 days)
ArcGIS Server: Web Administration Using .NET (2 days) new
Help resources
ESRI Developer Network http://edndoc.esri.com
Direct link to SOAP API help
http://edndoc.esri.com/arcobjects/9.2/NET_Server_Doc/developer/ArcGIS
/SOAP/overview.htm
Direct link to ArcObjects API help
http://edndoc.esri.com/arcobjects/9.2/NET_Server_Doc/developer/ArcGIS
/ArcObjects/server_apis.htm
Soon as easier navigation to all help documentation at 9.3.
http://resources.esri.com
Help Resources continued
Sample 9.3 Severs
http://sampleserver1.arcgisonline.com/ArcGIS/rest/services
http://sampleserver2.arcgisonline.com/ArcGIS/rest/services
9.3 Help (beta)
http://resources.esri.com
ArcGIS Server Developer Blog
http://blogs.esri.com/Dev/blogs/arcgisserver/default.aspx
ArcGIS Server - Web Services
Questions?
