ArcGIS Online REST API

And there it is! the ArcGIS Portal REST API documentation was made public today. The API was there all the time of course, but using it needed some detective work using FireBug or your favorite HTTP sniffer.

You can of course continue on that path. You never know what you find along the way. But for those who want to get going quickly developing custom apps on the ArcGIS Online platform, the documentation should come in handy.

We've been using the API in some of our projects (like the gallery in geo.data.gov and the open government data label in geoplatform.gov), Kentucky's KyGovMaps site, and even the integration of Geoportal Server with ArcGIS Online I described earlier is possible thanks to this API. But it doesn't end there. Want to build your site in Drupal or Microsoft SharePoint? Now there's an API for that.

Or if you want to develop a custom application template like this one:

This template takes a webmap with (in this case) the location of dams. One of the attributes is the age of those dams. Using the ArcGIS Portal REST API, this (JavaScript) app, fetches the data included in the webmap (uploaded from a CSV). It then calculates the average age of dams visible in the current map extent and uses that to drive the gauge.

Whether you want to access a group to build your gallery from or do something interesting with the content of individual webmaps, the ArcGIS Portal REST API documentation helps you build your apps.

Perhaps this will now push me to finish up this Drupal module I had started a while ago. OR perhaps someone out there is adventurous enough to help me with that...

Strange Connections

This past week was one of strange connections, when GI Science, friends and family, business and society all seemed intertwined...

It started off with AGILE, no, not this one, but the 14th edition of the get-together of the Association Geographic Information Laboratories Europe. This lead to some confusion, but perhaps we got some of the AGILE (the big one) to appreciate GIS a little bit...

We spoke about mixing and matching open source with closed source work with various samples shown coming from 52North, Research Studios Austria, and ourselves with respect to sensor observation, web processing, contributing to OpenStreetMap, and information discovery.

With the growing amount of information, the desire to filter out what's not relevant is growing as well. What I found one of the best paper presentations at the AGILE conference (the small one), was about Modeling Umwelten following the ideas of German scientist Jakob von Uexküll.

Jakob was no uilskuiken, no matter how similar the two terms may sound...

Jakob's theory states that an organism creates and reshapes its own Umwelt when it interacts with the world, creating a so-called 'functional circle'. This reminded by of Social Circles by @padday.

Filtering information becomes critical in disaster response situations. Some of the presentations at AGILE spoke of semantic filtering of information feeds using the context (dare I say Umwelt?) of the event and its participants. Surprisingly I found my self discussing emergency response using Eagle with my old colleagues at Esri NL.

During the week I crossed more of my Social Circles: meeting an old friend, spending time with Esri NL, and spending a day with my brother and our cousin-several-times-removed at DeLimes.

At DeLimes, we played urban golf with BuurtLab, studied how farms are managed differently, and what makes a local store survive, by actual visits and listening to the people themselves, following the 7S Framework.

When did you last ask a user how what they got actually was what they needed (will a new laptop really help you land a job?).

And so ended a week of interactions with different groups, discussions of software delivery models, management approaches, and catching up with family and friends. New links were established, old links where renewed and strengthened.

Are we there yet?

Is anybody home?
It's been three weeks since we announced that the Esri Geoportal extension would be released as open source. It may have seemed a bit quiet since, but rest assured, a lot has happened.

In my previous post I indicated we were looking at a Creative Commons-esk license model. Several people pointed out that this license is not recommended for source code. And yes we did see the FAQ on that topic.

And so started a quest for an appropriate license model that would give everyone: developers, implementers, and (sorry folks!) Esri what they need. If there only was a geek channel on TV. this would have made a great 'America's next top (license) model' show.

Along the way we revisited a great resource collected by the state of Massachusetts IT Division. It’s a bit dated, but the basics still apply.

While Esri has experience with open source from a licensing-in perspective, with the Geoportal extension going open source, we're flipping into a new role for the first time of licensing-out Esri software under an open source license.


From the 50+ (!) models discussed in that spreadsheet, it would have been great fun to use the Motosoto or Sleepycat license models, just because of their names. But no, we didn't select either.

Geoportal Extension will be released under the Apache 2.0 license!

Are we there yet?

Almost. We now have the task of moving source code, documentation, and such to a public source repository and find a proper way to integrate/link with the Esri websites (resource centers and such). But with this big step made, we're getting close.

Geoportal Extension to Become Open Source

Despite code documentation and samples as included on the Geoportal Resource Center, implementers of the Geoportal Extension have continued asking for source code access to support integration with content management systems, map viewers, desktop etc.

Esri listened to these requests and I am happy to be able to announce that:

the Geoportal Extension will enter a next phase in its evolution and become a Free and Open Source solution from Esri.

Seven years ago we created what was then called the GIS Portal Toolkit as a software and services solution, based on code from a number of earlier projects and prototypes for data discovery and map viewing. 

Since starting with GIS Portal Toolkit, those using it to create geoportals and clearinghouses have had access to its source code. Understandably, as people looked at creating websites that reflected the organization's identity.

At version 9.3 this resulted in Geoportal becoming a fully supported extension with a full maintenance program. We put a lot of effort in making Geoportal Extension configurable to a large extent with respect to authentication, metadata profile support, the index used for discovery, localization, skin development, and more.

The Geoportal Extension will be released under one of the variants of the Creative Commons open source license and will include elements like:

• Geoportal Web application
• OGC CSW 2.0.2 catalog service with OGCCORE and ISO Application Profile support
• INSPIRE compliant discovery service
• Extensible FGDC, ISO, DC metadata support
• Configurable search engine including spatial ranking algorithm
• Federated searches to standards-based (CS-W), Web 2.0 (OpenSearch), or other types of search providers (CMS, Document Management Systems, …)
• CSW clients (.NET + Java)
• Data Discovery Widget for Flex
• Data Discovery Widget for Silverlight
• Data Discovery Widget for HTML
• Ontology Service (java webapp)
• WMC clients (.NET)
• Publishing client (.NET)

We have some administration to do, but check back in later this month and next as we get the code out there. I'm looking forward to working with a larger community to further develop this product.

Data.gov Adds Geoviewer

Today, Data.gov added a new capability to its growing arsenal of tools that allow for using the data the website makes accessible. The so-called Data.gov GEO Viewer has some interesting capabilities:

• Data loaded into viewer in Real-time through web URLs – the viewer downloads data directly from the authoritative source. An ArcGIS Server Geoprocessing service uncompresses data if needed (.zip, .gz, .tar), transforms data to JSON, and streams this back to the flex viewer.
• The GEO Viewer loads data in Web Mercator (if data or service supports it).Otherwise the GEO Viewer changes its basemap projection to Geographic Coordinate System and loads the data.
• The viewer supports the following data types:
• Map Services: OGC WMS, ArcGIS
• Feeds: GeoRSS
• Files: KML/KMZ, Shapefile
• The GEO Viewer allows for mashing up multiple datasets, map services, and feeds in one view. It supports basic navigation using the keyboard (without the need to use the "shift+alt+F7+drag the mouse+release alt and mouse button at the same time"-like features...).
• Set a basic color for the added data layer, set transparency for the layers, and use a swipe/see-through feature.
• Basic identify operation on the added data.
• Switching the basemap.

There are some limitations with this viewer, most of which are due to the fact that it downloads data from the source every time someone wants to see it:

• File size limit of 10MB – Shapefiles and KML files can have large compression ratios. While the registered file in Data.gov may be an under 10MB KMZ file, this can easily expand into a 100MB KML that then is streamed as JSON features to the client. This simply takes time.
• The information about the files is not enough to make an upfront assessment of whether the file is viewable or not. Almost every file in Data.gov is a .zip file. The GEO Viewer has to determine if it's dealing with an Esri Shapefile, OGC KML, Arc/Info Export (e00, remember these?), Microsoft Excel, CSV, or whatever format(s) until after it downloads the file. The metadata in neither raw data catalog nor geodata catalog includes this information. A result is that sometimes users will only be notified that the file type is not supported until after the viewer is launched.
• Registration of content is not readily usable by an application (James Fee found one of these...). There are several registrations of content that link to web pages or web applications, rather than the actual data. In this case, the content is however also available as an ArcGIS Server Map Service (although that's not in the registration in Data.gov).

 Are we there yet?

No. This GEO Viewer is not the end point. It's another step towards allowing users to interact and understand the data discoverable through Data.gov. The viewer illustrates the need to include more map services in Data.gov. Even registering map services alone may not be enough. In this world of service architectures, platforms, and such, we become more and more dependent on each other. Offering a service means signing up to a responsibility to keep this service running and available for an extended period of time.


Oh! And the proof of the pudding is in the eating! Here some samples:

1. My most favorite dataset on Data.gov: the locations and characteristices of world copper smelters.
2. For the patient folks: Active Mines and Mineral Plants in the US
3. My next house location: Geophysical Surveys of Bear Lake, Utah-Idaho
4. The dataset James was looking for: USGS Oil and Gas Assessment Database

Give it a whirl and provide your feedback to Data.gov.

Announcing the ArcGIS Editor for OpenStreetMap

For a while, ArcGIS users have been able to use the OpenStreetMap (OSM) content as a basemap in ArcGIS Desktop or in web applications thanks to a republishing of this content through ArcGIS Online. After the earthquakes, we have received many requests from users of ArcGIS who want to contribute to OSM, but who prefer to use the editing capabilities of ArcGIS Desktop.

For users of ArcGIS 10 this is now possible using the new free add-on ArcGIS Editor for OpenStreetMap.

The ArcGIS Editor for OpenStreetMap is designed to help ArcGIS desktop users to become an active member in the growing community of users building an open and freely available database of geographic data.

The provided tools allow the user to download data from the OSM servers and store it locally in a geodatabase. The user can then use the advanced editing environment of ArcGIS Desktop 10 to create, to modify, and to delete data. Once the edits are complete, the edit changes can be posted back to the OSM server and become available to all OSM users.

The interaction with the OSM server is accomplished using as set of geoprocessing tools to download, to manage, and to upload data.

A total of six tools support the a disconnected editing like workflow: download data from OSM, edit locally, and upload the result back to OSM.

OSM has a very flexible data model, to support some consistency in created feature types. However for more focused data capture activities, such as those that occurred after the Haiti and Chile earthquakes, a more focused data model approach is suggested. To use the new ArcGIS 10 template feature, we have mapped the common tags used in OSM to attributes and feature types, created templates for these, and implemented suggested symbols.

Editing is straightforward. After downloading your work area from OSM, you use the normal ArcGIS Desktop editing features. There are some things to keep in mind in this first release:

• Only simple and single part geometries are supported.
• You cannot create features with more than 5000 nodes. The OpenStreetMap server has a limit of accepting geometries with up to 2000 nodes.
• Deleting a point, line, or polygon can have an effect of changing the relation in which the feature participates.
• Editing of OSM relations or super-relations directly is not supported in this first release.
• Polyons generated from data downloaded from OSM may be corrupt. To be safe: run the repair geometry tool before starting to edit.

As with any multi-user editing environment, you may run into a situation where multiple users edit the same area. This results in conflicts when trying to upload your edits to OSM. In order to mitigate the conflict the ArcGIS Editor for OpenStreetMap offers a simple Conflict Editor to help resolve the situation. Best practice is to edit a relatively small area and to save back to OSM frequently.

We are releasing this first version of the ArcGIS Editor for OpenStreetMap. and are looking for feedback. More details on the tool will become available over time, including access to the source code, and enhanced documentation.

Enjoy!