Building Applications with ArcGIS Runtime SDK for Android Part II. Will Crick Dan O Neill

Transcription

1 Building Applications with ArcGIS Runtime SDK for Android Part II Will Crick Dan O Neill

2 Agenda Intro Connected editing summary Offline capabilities - Local features - Geometry Engine Platform integration Accessing content from ArcGIS Online/Portal Best practice - Layer performance - UI thread - Device support

3 Intro

4 Who are we all? Who are you? Who are we?

5 ArcGIS 10 A Complete System Easier More Powerful and Everywhere Cloud Mobile Web Discover Create Manage Visualize Analyze Collaborate Enterprise Local Desktop

6 Runtime SDKs Native ArcGIS Runtime SDKs ios Android Windows Phone Windows Mobile Windows Linux Runtime SDK Runtime SDK Runtime SDK Runtime SDK Runtime SDK Runtime SDK Objective C Java Silverlight.NET WPF, Java Java Core Runtime

7 Runtime Architecture Local Server Geocoding GP Mapping Editing WPF Java Runtime Core Tile Package Messaging OpenGL Server Sync Spatial analysis GPS Advanced Symbology DirectX Offline Routing Offline Geocoding Native platform capabilities Android Windows Mobile ios Remote Server Geocoding GP Mapping Editing Windows Phone

8 SDK Release Status ArcGIS for Android SDK current (12/11) 1800 unique installs to be released next week - Multiple maps - Advanced symbology/message processing - ArcGIS Online/Portal & webmap loading - Group layer - Improved secure service framework - Supports ADT r17-1.x/2.0 summer

9 Connected editing

10 Editing AttributeEditor & GeometryEditor samples in SDK Uses Feature Service - Same model as other webapis - applyedits() AttributeEditor sample - check field data types - Data entry - Validation

11 Geometry Editing Sample Uses a sketch graphics layer - Uses MapOnTouchListener - Implements tap and drag events Track local edit history yourself Uses local GeometryEngine - No server call

12 FeatureLayer.applyEdits() method Aynchronous method - CallbackListener / AsynTask - Callback tells success for each feature applyedits(adds, deletes, updates, callback) Attribute updates - Graphic - only changed attributes & ID

13 Offline capabilities

14 What can you do offline today? Advanced symbology In memory feature layers Base maps Message Processing Geometry operations Routing Geocoding Store features in ArcGIS db Query attributes offline Sync offline data with server See the futures section at the end for news on this stuff!

15 Adding base maps As seen in part I Local tiled layers - compact caches from 10.0 server - NOT 10.1 TPKs [yet] - Fat32 4GB file size limit basemaplayer = new ArcGISLocalTiledLayer( file:///mnt/sdcard/<cachename>/layers", false);

16 Offline features A Use in memory feature collection Feature Layer - Feature set [array of features] - Layer definition [json from a feature service] Change features using: - addgraphic() / removegraphic() methods - applyedits() method [new in 1.1 for feature collection!] Write features to/from disk in json [new in 1.1!] B Graphics layers - Add/remove graphics C Advanced Symbology - Process messages

17 Offline features code examples Create the layer <! strings.xml--> <string name="config.windturbine.layer.definition"> {\"currentversion\":10.01,\"id\":0,\"name\":\"wind Turbine\ </string> //Java class turbinesfeaturelayer = new ArcGISFeatureLayer(R.string. config.windturbine.layer.definition, FeatureSet, null); (Demo app is different, creates layer then loads json features, then adds features) Add/edit features featurelayer.addgraphics(graphics); //or Graphic[] graphics = new Graphic[ g ]; featurelayer.applyedits( //adds graphics, //updates, //deletes);

18 to/fromjson Jackson JsonParser Serialize to disk - FeatureSet.toJson(); - String - JsonGenerator.writeRawValue(); Read from disk - Passed to activity in a bundle - FeatureSet.fromJson(jsonParser, hasspatialref); File jsonfile = bladerunnerapp.getjsonfile(bladerunnerapplication.teamareasname); JsonFactory jsonfactory = new JsonFactory(); JsonParser jsonparser = jsonfactory.createjsonparser(jsonfile); FeatureSet featureset = FeatureSet.fromJson(jsonParser, true);

19 Blade Runner demo Will Crick

20 Message Processing Add features to the map via a message - Radio/UDP/wifi - Different actions, add/update/delete - Different message types - Requires an initialized group layer Support for advanced symbology - Based on symbol packages (dictionary.dat files) c Military symbology (new in 1.1) - Build your own custom dictionary (future release) - Needs desktop support

21 Message Processor Workflow MessageProcessor processes a message from an external resource DictionaryType enum dictates message format DictionaryType is backed by a resource bundle - Dictionary data file - Message file types MessageProcessor bound to a Group Layer - Used to display, update, and remove MultilayerSymbol

22 Message Processing Code example Create a MessageProcessor Object MapView map = (MapView)findViewById(R.id.map); final GroupLayer grouplayer = new GroupLayer(); map.addlayer(grouplayer); try { MessageProcessor processor = new MessageProcessor(DictionaryType.Mil2525C, grouplayer); } catch (FileNotFoundException e) { e.printstacktrace(); }

23 Message Processing Code example Create a Message object Process it! // Message creation Message lmessage = new Message(); UUID luuid = UUID.randomUUID(); lmessage.setid(luuid.tostring()); lmessage.setproperty("_type", "position_report"); lmessage.setproperty("_action", "update"); String controlpoints = x1 + "," + y1; lmessage.setproperty("_control_points", controlpoints); lmessage.setproperty("sic", "SFGPUCRRL--E---"); lmessage.setproperty("_wkid", "3857"); lmessage.setproperty("uniquedesignation", "2020"); // process message and add point processor.processmessage(lmessage);

24 Update Graphics Get GraphicLayer from GroupLayer Get Graphic from GraphicsLayer Get Geometry from Graphic Set Property with update Process messsage Message message = processor.createmessagefrom(gr); String controlpoints = (String)message.getProperty( MessageHelper.MESSAGE_2525C_CONTROL_POINTS_PROPERTY_NAME); if (targetcontrolpt!=null) { message.setproperty( MessageHelper.MESSAGE_2525C_CONTROL_POINTS_PROPERTY_NAME, targetcontrolpt.getx() + "," + targetcontrolpt.gety()); } message.setproperty("_action", "update"); processor.processmessage(message);

25 Message processing demo Dan O Neill

26 Platform integration Will Crick

27 Using the GPS Wraps Android Location Service Adds useful functions - Symbol - Accuracy [changed at 1.1] - Auto pan LocationService ls = map.getlocationservice(); ls.setsymbol(symbol); ls.setaccuracycircleon(true); ls.setbearing(false); (Demo app uses simulated location to make things easier!)

28 Compass sensor integration Use SensorManager to get access to sensors Create Sensor object ( TYPE_ORIENTATION / getorientation() ) Register SensorEventListener with SensorManager public void onsensorchanged(sensorevent event) { } sensorvalues = event.values; map.setrotationangle(sensorvalues[0]);

29 Bluetooth devices Laser range finder to add a point using an offset Get BlueToothDevice from BlueToothAdapter(String address) Create a custom service (BlueToothSerialService) - reads bytes from a socket - send bytes in a message to MapViewActivity Handler - Converts to string buffer - Reads LSR sentence - Uses local method/ (maths) to create point from offset - PointFromOffset will be in future version of SDK

30 Blade Runner app code

31 ArcGIS Portal (new in 1.1) Dan O Neill

32 Portal API basics Organization - Part of portal created for specific entity - Configurable site - Invite and manage users Groups and Users - Collaboration with other portal users - Exchange content related to activities/projects

33 Accessing a Portal Portal Class - Entry point - Instantiate with credential or as guest - 2 cases - 1. Organization account - 2. Portal - If credential provided automatically connects to Organization account

34 Workflow Create a Portal Get the feature group query list with portalinfo Loop through the list of queries and retrieve each group For each group get the title and thumbnail Update the View with the results

35 Portal connection Create the portal with credentials and Portal URL //set up portal portalurl = " credentials = new UserCredentials(); credentials.setuseraccount("mobile_org", "dev.team"); //create a new instance of portal Portal.newInstance(portalUrl, credentials, new PortalListener<Portal>() public void onerror(throwable e) { e.printstacktrace(); public void oncallback(portal portal) {... });

36 Search Portal Construct query string - PortalQueryParams methods return query strings - finditemswithqueryparams queries items and groups Find list of items in a group PortalQueryParams queryparams = new PortalQueryParams(); queryparams.setqueryforitemsingroup(groupid); // You can also create your custom PortalQueryParams object PortalQueryParams queryparams = new PortalQueryParams(); // Once you have the query parameter string, // you can make the query on the portal. portal.finditems(queryparams, portallistener);

37 ArcGIS Portal demo Dan O Neill

38 Best Practice

39 ArcGIS for Android Layer performance Try to minimize traffic - Requests are expensive - Processing of results cost ArcGISFeatureLayer - types - Snapshot / feature collection - On Demand - Selection TileLayer (ArcGIS, Bing) - Static - Also have dynamic access Dynamic map service layer - Image only ArcGISLocalTiledLayer - No network requests! Combine together

40 The importance of the UI Thread Work with Views on the UI Thread Async methods are common - Run in other threads Options - AsyncTask - Handler() bound to creation thread - Processed in a queue - messages & runnables - View.runOnUiThread(new runnable(){ }) - ExecutorService - Threads

41 OS support %!

42 Device & OS support Single app deployment - UI = fragments/different views Compatibility libraries - Fragments Action Bar 3.0+ Some devices don t have features - cameras/gps Deployment - Manifest settings are really important Localisation means global

43 The future

44 Future releases Playing ios catchup J - Open Streetmap layer - NAServer task - Wrap around - Navigation modes 10.1 server support - Editor tracking - Replica service - Also local data storage and a sync api - Related tables!!! Online features - Wms/wmts/kml - Csv by ref Runtime..

45 Summary info Where to get more info - Resource centre Blog Forum - Android - Last resort arcgis4android@esri.com Where to get code - We will post demo app to arcgis online android group shortly -

46 Questions?? All yours.

47