Application Development Using Image Services Web APIs. Hong Xu, Wenxue Ju

Transcription

1 Application Development Using Image Services Web APIs Hong Xu, Wenxue Ju

2 Session Outline Discuss and demonstrate the following image service web application patterns: Display image service in your web applications Measure building height from an image service On-the-fly server side image processing Develop web app that allows users to upload images Surface profiling by extracting pixel values from image services Download raw images and process image from server mosaicking and cataloging 10.2 Image Service REST APIs

3 What Image Services Offer? Provides image data and the associated functionality through web application - Serve single image (raster dataset) - Mosaic a collection of images (mosaic dataset) - Catalog collections of images (mosaic dataset) - Dynamic processing Provides fast image display through image service cache Server Sources

4 Image Service Clients REST, SOAP Web APIs - Silverlight, Flex, JavaScript ArcGIS.com ArcGIS Desktop ArcGIS Explorer Mobile Silverlight Java Flex Web APIs REST SOAP Clients OGC Standards - WMS, WCS, WMTS, KML Server

5 Image Service Source Data Raster datasets - Including raster products Mosaic datasets - Requires ArcGIS Server Image Extension license Raster or mosaic layers - To control rendering - Predefined query Sources

6 Mosaic Dataset Brief A data model used to manage and process your collections of images - Stored in geodatabase as a table - Each row contains a raster function - The function references image files on disk - On-the-fly processing and mosaicking Can be accessed as - A catalog - A mosaic Created with geoprocessing tools

7 Raster Function A definition of an image process - NDVI, pansharpen, orthorectification - band composition, stretch - Hillshade, Slope, Shaded relief etc. Stored within the data model and processed on-the-fly - Functions can be chained - Fast and save disk space by avoiding intermediate results New process chain Orthorectify ExtractBand Stretch Clip Old process chain Orthorectify ExtractBand Stretch Clip

8 Mosaic Rules Mosaic Method defines the order - By Attribute - Closest to Center - Closest to Nadir - North-west (default) - Seamline Mosaic operators resolve the overlaps - First (Default) - Last/Min/Max - Mean/Blend

9 Demo Publish an image service

10 Image Service REST APIs Operations: ExportImage Query Identify Measure Add, Delete, Update ComputeHistogram Resources: Tile RasterCatalogItem Colormap, RasterAttributeTable Metadata KeyProperties File

11 Image Service Web APIs RasterFunction ArcGISImageServiceLayer MosaicRule ImageServiceParameters Get (Colormap, AttributeTable, Histogram, KeyProperties) Get (RasterInfo, KeyProperties, Metadata, Thumbnail) Add/Update/Delete Rasters ImageServiceIdentifyTask ArcGISTiledMapServcieLayer MensurationTask QueryTask

12 Display Image Service Dynamic image services using ArcGISImageServiceLayer <script> dojo.require( esri.map ); function init(){ var map = new esri.map( imagemap, {extent: initextent}); var params = new esri.layers.imageserviceparameters(); params.format= jpgpng ; var ISLayer = new esri.layers.arcgisimageservicelayer(imageserviceurl, params); map.addlayer(islayer); } dojo.ready(init); </script> Image service cache using ArcGISTiledMapServiceLayer <script> dojo.require( esri.map ); function init(){ var map = new esri.map( imagemap, {extent: initextent}); var ISCacheLayer= new esri.layers.arcgistiledmapservicelayer(imageserviceurl); map.addlayer(iscachelayer); } dojo.ready(init); </script>

13 Demo Display dynamic and cached image services

14 Server Raster Function ArcGISImageServiceLayer Raster function on the server used to response to client call Support many built-in functions - Hillshade, Aspect, ShadedRelief, Slope, Colormap, Statistics, Stretch, NDVI, Remap, Convolution Use RenderingRule class to send process request RedenderingRule var map = new esri.map( imagemap, {extent: initextent}); var rasterfunction = new esri.layers.rasterfunction(); rasterfunction.functionname = Aspect ; rasterfunction.variablename = DEM ; var params = new esri.layers.imageserviceparameters(); var ISLayer = new esri.layers.arcgisimageservicelayer(imageserviceurl, params); ISLayer.setRenderingRule(rasterFunction); map.addlayer(islayer);

15 Extending Server Raster Function Expandable through raster function template - Create with ArcMap - Added to server during publishing - Support customized raster function (COM extensible)

16 Demo Create Raster Function Template Stretch Remap-Colormap-ColormapToRGB

17 Mosaicking ArcGISImageServiceLayer MosaicRule Apply to image service from mosaic dataset Use MosaicRule class - Set mosaic method - Set mosaic operator esrimosaiccenter esrimosaiclockraster esrimosaicattribute esrimosaicnorthwest esrimosaicnadir esrimosaicseamline esrimosaicviewpoint var imageservicelayer = new esri.layers.arcgisimageservicelayer (imageserviceurl) var mrule = new esri.layers.mosaicrule(); mrule.method = esri.layers.mosaicrule.method_attribute; mrule.sortfield = "AcquisitionDate"; mrule.operation = esri.layers.mosaicrule.operation_last; imageservicelayer.mosaicrule = mrule; map.addlayer(imageservicelayer);

18 Cataloging Use to make selection var layersrequest = esri.request({ url: imageserviceurl + /query ; content: {geometry: mypolygon, spatialrel: "esrispatialrelintersects", where:"category=1", geometrytype: type, returngeometry: true, outfields: "*",f: "json" }, handledas: json ; callbackparamname: callback }); layersrequest.then( function(response){ queryfeatures = response.features; dojo.foreach(queryfeatures), function(feature){ // displaying feature geometry using Graphics and attributes in DataGrid }

19 Demo Mosaicking and cataloging

20 Identifying and Profiling Identify pixel values using - ImageServiceIdentifyTask or REST Elevation profile: multiple requests Time-series profile - identify one point, return all pixel values at this location from time-series image collection var layersrequest = esri.request({ url: layerurl+"/identify", content: {geometry: pointjson, geometrytype: "esrigeometrypoint", returngeometry : false, returncatalogitems: false, f: "json" }, handleas: "json", callbackparamname: "callback" }); layersrequest.then( dojo.hitch(callbackfunc,"chartit"), dojo.hitch(errorbackfunc,"chartit"))

21 Demo Elevation Profile

22 Image Mensuration Measuring height/distance/area/location from image service Mensuration capabilities are defined when dataset is created from image metadata Enable mensuration capability during publishing the service

23 Image Mensuration REST API fromgeometry={"x": ,"y": ,"spatialreference":{"wkid":3857}}& togeometry={"x": ,"y": ,"spatialreference":{"wkid":3857}}& geometrytype=esrigeometrypoint& measureoperation=esrimensurationheightfromtopandtopshadow& f=json var layersrequest = esri.request( url: content: {fromgeometry.}, handledas: json, callbackpapamname: callback } layersrequest.then( function(response){ Console.log( height=, response.height.displayvalue) } }

24 Demo Measure CN Tower

25 Image Service Editing Allow add/delete/update images from image service The backend must be an SDE mosaic dataset - optional turn on editor tracking Enable editing capability - Set workspace on server - Set raster type - Extend using raster type template - Example: LAS Access control AGS users can add Owner can update delete

26 Image Service Editing REST APIs (post) Add rasters itemids=itemid1,itemid2&rastertype=raster Dataset&maximumCellSizeFactor=10&f=json Update rasters - rasterid=10&attributes={"minps":0,"maxps":10,"groupname":"las"} Delete rasters itemids=1,2&f=json

27 Demo Sharing rasters and LAS files through image services web applications

28 Download and Export Image Download raw images from server - Applies to image service of mosaic dataset - Clip/Convert in pixel space - Output maintains transformation Export image - Proccessed image - TIFF (GeoTIFF) and other formats

29 Downloading Capability Enable catalog and download capability during publishing Set the download parameters: - Download size - Maximum download - Download directory

30 Demo Download and Export

31 Performance Background: Cached service; Dynamic access: JPGPNG Format, or jpg Hybrid use: - cache for display; - dynamic access for query, identify, mensuration

32 New 10.2 Image Service REST APIs Compute class statistics for image classification - Compute tie points for image registration - Get samples (e.g. elevation values) - <imageservice-url>/getsamples Image Service Legend - <imageservice-url>/legend Other enhancements - Client defined raster function templates - ExportImage supports compression and png32 format - MosaicRule supports new operation MT_SUM

33 Help and Sample Services Imagery resource center - Web API Image content - World Landsat service:

34 Questions Thank you! Please fill out your surveys Offering ID: 270