A Combat Support Agency Defense Information Systems Agency Common Map Widget API June 05, 2013

A Combat Support Agency Agenda Background The API Current Status Implementation Example (picture only) 2

A Combat Support Agency Background: OWF Widgets: web pages or apps contained in an iframe, often used to provide views of dynamic content Ozone: combination layout manager and messaging mechanism for hosting widgets within a Web browser. –It resembles iGoogle, and uses Shindig, an open source Google gadget (widget) container.iGoogleShindig Because browsers don't permit communication between iframes from different domains, Ozone also provides cross- domain-compatible pub-sub mechanism. –Enables development of Web apps composed of multiple intercommunicating widgets. OWF = Ozone Widget Framework: in wide use across DoD/IC programs 3

A Combat Support Agency Background Current Users: –Joint Command and Control Common User Interface (JC2CUI) –Global Command and Control System – Integrated Imagery and Intelligence (GCCS-I 3 ) –Distributed Common Ground System – Intelligence Community (DCGS-IC) –Defense Intelligence Information Enterprise (DI2E) Framework –Army Tactical Mission Command –NSA Other Prospective Partners: –Navy C2RPC (PEO-C4I/PMW-150) –AOC-WS –US Coast Guard –CIA 4 Adopted by OWF GOSS as OWF related project

A Combat Support Agency 5 Background A Common Pattern –Widgets query for or manipulate data –Map widget displays results The Vision –Mix and match query widgets and map widgets from different programs –I.e., plug and play The Problem –Map widgets are tightly coupled to query widgets –Interwidget comms (channels) unique to each program The Solution –Common Map Widget API

A Combat Support Agency First Principles First principle of design patterns: program to an interface, not an implementation From Design Patterns: Elements of Reusable Object- Oriented Software by the "Gang of Four” 6

A Combat Support Agency The API (Basic Approach) Identify basic map operations Abstract operations away from any physical map Define channels and messages, and associate with basic map operations (i.e., the API) Any widget can subscribe to map channels and react appropriately –not just a map Don’t tie API to any particular implementation or map renderer –e.g. Google Earth, OpenLayers 7

A Combat Support Agency The API (Conceptual View) 8 Map Widget “container” OpenLayers Library Map Library-Unique APIs (e.g., OpenLayers, GoogleMaps, Proprietary, etc) Common Map Widget API – enables widgets from different communities to interoperate with different maps JavaScript Translation Code Search Widget Analysis Widget SA Widget Map Widget “container” Google Earth Library JavaScript Translation Code Map Widget “container” Google Map Library JavaScript Translation Code Intel Widget

A Combat Support Agency –Overlays map.overlay.create map.overlay.remove map.overlay.hide map.overlay.show map.overlay.update –Features map.feature.plot map.feature.plot.url map.feature.unplot map.feature.hide map.feature.show map.feature.selected map.feature.update –Drag And Drop The API (summary) 9 Will expand these in next few slides –View map.view.zoom map.view.center.overlay map.view.center.feature map.view.center.location map.view.center.bounds map.view.clicked –Status map.status.request map.status.view map.status.format map.status.about –Errors map.error

A Combat Support Agency The API (Actual Text) 10

A Combat Support Agency The API (Actual Text) 11

A Combat Support Agency The API (in code) –Load kml feature data onto map widgetEventingController.publish('map.feature.plot.url', '{ "featureId": “SAGE_PUBLIC", "url": " }'); –Center Map on Location (pan) widgetEventingController.publish('map.view.center.location', '{ "location": {"lat": , "lon": } }'); 12

A Combat Support Agency Current Status Current spec (v1.1) –Requires KML and WMS (getMap) –Signed off early 2013 –Growing community of adopters Next version (v1.2) –Ambiguity fixes –User manipulation support –Optional extensions (e.g., widget intents, clustering) –Considering GeoJSON –Growing community of participants 13

A Combat Support Agency Common Map Widget API Implementations: –JC2CUI – Reference Map Widget. Pluggable architecture, supports dynamically selected map renderer. JavaScript library can be reused for any desired renderer. Current implementations include Google Maps API version 2, Google Maps API version 3, Google Earth Plugin, OpenLayers –Army – Google Earth Plugin based Map Widget with Army extensions. JavaScript wrapper library can be reused for any desired renderer. NASA World Wind implementation under development. –GCSS-I3 – NASA World Wind and Open Layers based implementations 14

A Combat Support Agency JC2 CUI Example 15 Publish map.feature.plot message Receive message. Plot tracks on map Receive message. Show tracks in grid Publish map.feature.selected message Receive message. Center on selected track Publish map.feature.selected message Receive message. Center on selected track Receive message. Scroll to selected track

A Combat Support Agency Additional Information More Information: –Common Map API Group: –Common Map API Wiki: POCs for additional info: –Ken Trabue - –Stephen Lubowsky - –Marty Dowd - –Chris Bashioum – 16