Introduction to ArcGIS API for ios. Divesh Goyal Eric Ito

Transcription

1 Introduction to ArcGIS API for ios Divesh Goyal Eric Ito

2 Agenda Introduction Getting Started Objective-C basics Common design patterns Key Concepts Q&A Remember to turn in your surveys.

3 ArcGIS - A Complete Geographic Information System Use Serve Author ArcGIS Server ArcGIS Desktop... For Authoring, Serving & Using Geographic Knowledge

4 ArcGIS Web & Mobile APIs Web APIs Flex JavaScript Silverlight REST Mobile APIs ArcGIS Server

5 ArcGIS API for ios Build native applications using Objective-C - iphone 3GS, iphone 4, ipod Touch, ipad - ios and up

6 Web or Native applications? ESRI supports both Advantages of native applications - Tighter integration with other native apps - Access to resources - Contacts, calendar events, photos - Marketing/Hosting/Reporting via AppStore Disadvantages - Dedicated effort to write and maintain

7 Before you begin.. You need an Intel-based Mac running OSX 10.6 (Snow Leopard) Join ios Developer Program - Standard : AppStore distribution - Enterprise : In-House distribution Download ios SDK (4.2.x) & Xcode IDE (3.2.x) ArcGIS API for ios - v1.0 : Resource center - v1.8 in public beta : Beta Community Portal

8 Objective-C Its C - Semicolons and curly braces - Pointers (uh-oh) But not your average C - colons and square brackets too - A different syntax Thankfully, Cocoa Touch frameworks provide elegant APIs

9 Objective-C basics Class = Interface + Implementation - MyController: UIViewController { // private variables here } // method declarations - MyController // method implementations

10 Objective-C basics Contd. Protocol - Declaring a // method definitions // method definitions - Adopting a MyDelegate: NSObject <UIApplicationDelegate> {

11 Objective-C basics Contd. Invoking methods = passing messages to objects [ object message ] ] ] foo.alloc(); foo.alloc().init(); point.setcenter(c); point.set(x,y); [foo alloc]; [[foo alloc] init]; [point setcenter:c]; [point setx:x andy:y];

12 Objective-C Basics Contd. Messages are read like English - presentviewcontroller: - writetofile: - applyeditswithfeaturestoadd:toupdate:todelete: Can get verbose gesturerecognizer:shouldrecognizesimultaneouslywith GestureRecognizer:

13 Objective-C basics Contd. Garbage collection is for kids, real developers manage their own memory You own an object if you - alloc - retain - copy MyObject* foo = [MyObject alloc]; [foo retain]; [foo copy]; If you own an object, you re responsible for releasing it [foo release];

14 Objective-C basics Contd. Properties make memory management easy ier Syntactic sugar dot MyController: UIViewController { MyObject* _foo; (nonatomic, retain) foo= mycontroller.foo = bar; //bar automatically retained mycontroller.foo = nil; //bar automatically released Monitor memory footprint with Instruments

15 Common design patterns Model View Controller Controller Model View

16 Common Design Patterns Contd. Delegation windowshouldclose: WindowDelegate YES

17 ArcGIS API

18 What you can do with the API Display maps Perform analysis Visualize results Collect data - Thu 8:30 AM & 1:30 PM

19 Displaying a Map UI Component : AGSMapView - Responds to gestures - Displays GPS location Mashup individual layers - ArcGIS Server Tiled, Dynamic, Image - Bing, Open Street Map Open ArcGIS.com web maps

20 Respond to Map events through Delegates Map Delegates Layer Delegate - Map loaded, failed to load - Layer loaded, failed to load Touch Delegate - Tap, Tap and Hold - Move Tap and Hold Callout Delegate - Did Show Callout, Should Show Callout - Did Click Accessory Button

21 Responding to Map Touch events 1. Adopt the Delegate MyController: UIViewController <AGSMapViewTouchDelegate> { } 2. Implement the protocol MyController -(void) mapview:(agsmapview*) mapview didclickatpoint:(cgpoint) screen mappoint:(agspoint*) mappoint graphics:(nsdictionary*) graphics { //handle touch event } 3. Set Delegate self.mapview.touchdelegate = self;

22 DEMO Display a map

23 Performing Analysis Query, Find, Identify Task - Search for features In the map Geoprocessing Task - Spatial analysis using GP tools and models Locator - Geocode and reverse geocode addresses GeometryService Task - Geometric operations such as cut, union, buffer, etc.

24 New at v1.8 Geometry Engine - native, high performance engine for performing geometric operations on the device Routing Task - Solve point-to-point and multipoint routes - Driving directions - Barriers, Time Windows, Best Sequence

25 Common Pattern for using Tasks 1. Adopt the Task Delegate MyController: UIViewController <AGSLocatorDelegate> { } 2. Implement the protocol methods -(void)locator:(agslocator*)locator operation:(nsoperation*)op didfindlocationsforaddress:(nsarray*)candidates { //todo } -(void)locator:(agslocator*)locator operation:(nsoperation*)op didfaillocationsforaddress:(nserror*)error { //todo }

26 Common Pattern for using Tasks 3. Instantiate the task self.locator = [AGSLocator locatorwithurl:[nsurl URLWithString:kGeoLocatorURL]]; 4. Set Delegate self.locator.delegate = self; 5. Perform operation NSOperation* op = [self.locator locationsforaddress:addresses returnfields:outfields];

27 DEMO Using Tasks

28 Visualizing Results Graphics - Geometry - Attribute - Symbol Symbols - Picture, Marker, Line, Fill, and Composite - Text (new at v1.8)

29 Visualizing Results Contd. //create the symbol AGSPictureMarkerSymbol *marker = [AGSPictureMarkerSymbol picturemarkersymbolwithimagenamed:@"bluepushpin.png"]; //create the graphic AGSGraphic *graphic = [AGSGraphic graphicwithgeometry:point symbol:marker attributes:dictionary //add the graphic to the graphics layer [self.graphicslayer addgraphic:graphic];

30 Visualizing Results Contd. Renderers - Simple - Unique Value, Class Breaks - Temporal

31 Visualizing Results Contd. //renderer for places AGSUniqueValueRenderer *placerend= [[AGSUniqueValueRenderer alloc] init]; placerend.field1 //unique value for city AGSSimpleMarkerSymbol *citysymbol= [AGSSimpleMarkerSymbol simplemarkersymbol]; citysymbol.style = AGSSimpleMarkerSymbolStyleDiamond; citysymbol.outline.color = [UIColor bluecolor]; AGSUniqueValue* city = [AGSUniqueValue uniquevaluewithvalue:@"city" symbol:citysymbol]; [placerend.uniquevalues addobject:city]; //unique value for town AGSSimpleMarkerSymbol *townsymbol = [AGSSimpleMarkerSymbol simplemarkersymbol]; townsymbol.style = AGSSimpleMarkerSymbolStyleCross; townsymbol.outline.width = 3.0; AGSUniqueValue* town = [AGSUniqueValue uniquevaluewithvalue:@ town" symbol:townsymbol]; [placerend.uniquevalues addobject:town]; //assign the renderer self.graphicslayer.renderer = placerend;

32 Visualizing Results Contd. Callout - Displayed automatically when user taps on a graphic Content - Title & Detail - Image - Accessory button - Custom UI View

33 Specifying Content for the Callout 1. Adopt the Delegate MyController: UIViewController <AGSInfoTemplateDelegate> { } 2. Implement the protocol MyController - (NSString *) titleforgraphic:(agsgraphic*)graphic screenpoint:(cgpoint)screen mappoint:(agspoint*)map { //todo } - (NSString *) detailforgraphic:(agsgraphic*)graphic screenpoint:(cgpoint)screen mappoint:(agspoint*)map { //todo } 3. Set the delegate on the graphic AGSGraphic *graphic =... graphic.infotemplatedelegate = self;

34 Responding to the Callout s Accessory button 1. Adopt the Delegate MyController: UIViewController <AGSMapViewCalloutDelegate> { } 2. Implement the protocol MyController -(void)- mapview:(agsmapview*) mapview didclickcalloutaccessorybuttonforgraphic:(agsgraphic*) graphic { //todo } 3. Set the delegate self.mapview.calloutdelegate = self;

35 DEMO Visualizing Results

36 More Resources ios Resource Center - Conceptual help, API Reference - Blog, Forums Samples on ArcGIS.com - ArcGIS for ios Developer Samples group API v1.8 Public Beta - betacommunity.esri.com Web Course : Getting Started with the ArcGIS API for ios - training.esri.com

37 Related Sessions Choosing a Mobile Deployment Platform - Today, 2:45 PM Meet the Teams - Today, 6 PM Advanced Development with ArcGIS API for ios - Thu, 8:30 AM, Repeat 1:30 PM

38 Thank You Help make this session better Turn in your surveys.

39