IA Data Explorer – 10 July 2020 Release Notes

The latest version of InstantAtlas Data Explorer (version 2.0.2) is now available at https://hub.instantatlas.com/.

Version 2.0.2 includes two areas of change.

View ArcGIS Online Item button

If you are signed in to ArcGIS Online (i.e. you sign in via the Data Catalog app or the Data Explorer app is launched with a ?token=xxxxxx argument) you will see a View ArcGIS Online Item button displayed under the Data, Map, Time Series or Ranked Bar Chart tabs.

IA data explorer link to item button

When clicked, the button takes you to the item in ArcGIS Online that contains the data for indicator you are viewing in the data explorer.

This button has been added in order to make it easy to obtain the endpoint of the ArcGIS feature layer containing an indicator from an InstantAtlas data catalog. There are a number of scenarios in which it might be useful to have the endpoint, one being that it enables the use of the data held in the data catalog in other third party systems, such as Microsoft Power BI for example.

Update to sharing/token behaviour

The Data Explorer has been updated so that when it is run in authorised mode (i.e. not shared with everyone) it will pass the token down to all of the feature services it uses. Furthermore, a public-shared Data Explorer will detect whether it needs a sign in for specific feature layers. If the data for the indicator searched for is stored in a feature layer that is protected, the user will be asked to sign in to ArcGIS Online in order to view the indicator in question.

How to embed InstantAtlas apps into your website

The purpose of this post is to provide the necessary information for embedding InstantAtlas apps into a website. Colour is used to explain the code below – if you have difficulty distinguishing the colours used please contact support@instantatlas.com and we will find an alternative. The actual creation of the apps in the first place is not covered in this post.

Reports

InstantAtlas Report Builder is a tool for for designing and publishing any type of report on ArcGIS Online from simple snapshots to complex, multi-page area profiles. The reports created using Report Builder can be embedded using two methods: static or dynamic. In the first case, the report must first be published as a bundle of static HTML files – this can be done within Report Builder by the author of the report. We recommend using the static embedding method to ensure the report pages load as quickly as possible.

Static method

Add this code to a web page to embed a report that has been published as static HTML files:


<div>
        <div id="iaoReportContainer" class="iao-content report-container" data-config='{"reports": [{"id": "5db1ef44afe64e499b390b57c0f012ae", "name": "Ward"}], "default_geography":"5db1ef44afe64e499b390b57c0f012ae", "urlMode": "query", "controls": { "type": "drop-down", "container": ".iao-report-controls", "reportLabel": "Select a report", "featureLabel": "Select an area"}}'>
            <script type="text/javascript" defer src="https://reports.instantatlas.com/scripts/lib/IAO.embed.min.js?container=iaoReportContainer&auto=true"></script>
        </div>
    </div>

You can change the following elements:

  • 5db1ef44afe64e499b390b57c0f012ae – this is the app ID (from ArcGIS Online) of the report you wish to embed.
  • Ward – this is the label for the report that will be displayed in the “Select a Report” drop down menu.
  • Select a report and Select an area – these are the labels for the drop down menus that will be shown above the report.

You can embed multiple reports in the following way:


<div>
        <div id="iaoReportContainer" class="iao-content report-container" data-config='{"reports": [{"id": "5db1ef44afe64e499b390b57c0f012ae", "name": "Ward"},{"id": "0647c83c53f24789b8d637c0ad6578c0", "name": "LSOA"}], "default_geography":"5db1ef44afe64e499b390b57c0f012ae", "urlMode": "query", "controls": { "type": "drop-down", "container": ".iao-report-controls", "reportLabel": "Select a report", "featureLabel": "Select an area"}}'>
            <script type="text/javascript" defer src="https://reports.instantatlas.com/scripts/lib/IAO.embed.min.js?container=iaoReportContainer&auto=true"></script>
        </div>
    </div>

The app ID and name of each additional report should simply be added as shown above in red. The report that shows by default is defined by the app ID shown above in green.

Note: for the report embedding to work, jQuery must be loaded before the report. A defer setting has been used in the embed code to make sure the report loads last.

An example of embedding reports using this method can be seen in this page of the Suffolk Observatory.

Dynamic method

Add this code to a web page to embed a report using the dynamic method.


<div id="iaoReportContainer" class="iao-content" style="width: 1000px;height: 2751px;"><script type="text/javascript" src="https://reports.instantatlas.com/embed/5db1ef44afe64e499b390b57c0f012ae/E05007163?container=iaoReportContainer"></script></div>

Simply change app ID (shown above in red) to embed a different report and optionally the feature code (shown above in blue) to load the report for a different feature.

Data Explorer

InstantAtlas Data explorer connects directly to an InstantAtlas Data Catalog in ArcGIS Online and allow your web site users to browse and download data and create graphics for documents and presentations.

Add this code to a web page to embed a data explorer app.


<link href="https://hub.instantatlas.com/data-catalog-explorer/static/css/main.css" rel="stylesheet">
<div id="root"></div>
<script src="https://hub.instantatlas.com/data-catalog-explorer/static/js/main.js"></script>
<script>window.dataCatalogExplorer.launch({ "appid": "e3d83edc76bd45548ddd0e2ee4fe4bdf", "container": "root" })</script>‎

e3d83edc76bd45548ddd0e2ee4fe4bdf – this is the app ID (from ArcGIS Online) of the data explorer app you wish to embed.

An example of embedding a data explorer app can be seen on this page of the Suffolk Observatory.

Map Explorer

The Map Explorer app is a simple-to-use app that that allows a user to select from a pre-defined set of indicators from an InstantAtlas Data Catalog and visualize them as thematic maps.


<div id="ia-map-panel" style="width: 100%; min-height: 500px; height: calc(100vh - 300px);">
<script src="https://hub.instantatlas.com/map-explorer/embed?c=ia-map-panel&appid=917b1891e5934d6baeeff23cdb0e9f38"></script>
</div>

917b1891e5934d6baeeff23cdb0e9f38 – this is the app ID (from ArcGIS Online) of the map explorer app you wish to embed.

Custom Area Reporter

The InstantAtlas Custom Area Reporter allows users to define their own areas and generate reports for them. Users select areas from a map using a range of selection tools. Once an area is defined users can produce one or more reports for the area. The report presents aggregated figures for the chosen area based on the underlying geography.

Add this code to a web page to embed a custom area reporter app.


<div>
        <div id="report-content-panel" style="width: 100%; height: 100%; border: 1px solid #ccc; position: relative;">
            <script type="text/javascript" defer src="https://reports.instantatlas.com/embed-selector?appid=1a451d1bbe3544849585ab2745c25f5d&container=report-content-panel&flush=true"></script>
        </div>‎
    </div>
    <script src="https://js.arcgis.com/3.24/"></script>‎

1a451d1bbe3544849585ab2745c25f5d – this is the app ID (from ArcGIS Online) of the custom area reporter app you wish to embed.

An example of embedding a custom area reporter app can be seen on this page of the Suffolk Observatory.

Support

If you have any difficulties embedding InstantAtlas apps in a website please contact support@instantatlas.com.

IA Data Explorer – 17 June 2020 Release Notes

The latest version of InstantAtlas Data Explorer (version 2.0.1) is now available at https://hub.instantatlas.com/.

Version 2.0.1 adds powerful new filtering, user interface improvements and bug fixes.

Enhancements

  • New functionality to filter features in the active geography using one or more fields in the feature layer. This allows you to filter to the features contained in a larger area (see example given below)
  • Modal windows now have Apply, Clear and Cancel buttons
  • Search now launches when user clicks a Go button or hits Enter
  • Adjustments to size of modal windows and mobile layout
  • Title and description removed from the list when viewing the Metadata tab (as these are already displayed at the top of the page)

Bug fixes

  • Search not accepting a space in the search term
  • Search launching too quickly when typing a term
  • Filter screen showing incorrect content when the data explorer was set to be filtered to a single root theme in the data catalog (Root Theme ID setting)
  • Modal window display in Internet Explorer 11

New filtering

Setup

A new configuration setting (Field Filters) has been added that allows the owner of the app to supply a comma-delimited list of filter fields that will be displayed in the data explorer.

Display

The list of field filters is displayed when the user clicks the Filter Settings button in the data explorer. If multiple filter fields have been defined, these will be shown in a drop down menu. If only a single filter field has been defined, this will be shown as text. If a field filter contains the same value for all of the features in the active geography, that field will automatically be hidden from the user.

IA Data Explorer field filters

The end user can select a field to filter the features displayed in the active tab. In the Map tab, the map will automatically zoom to the bounding box of the filtered features. The filter is retained when switching between tabs. In the Time Series tab, the Limit Features button/checkbox will automatically disappear if the number of filtered features is less than 10. The user has the option to perform further filtering to select specific features within the field filter by clicking the Features button.

For example, the Map tab is showing Lower Super Output Areas (LSOAs) for Suffolk County.

IA Data Explorer map showing LSOAs

The user can filter to the LSOAs in a particular district, for example Ipswich (District=Ipswich). The map automatically zooms to the filtered features.

IA Data Explorer filtered map

Switching to the Data tab retains the filter and the table (and the data download) will contain only the LSOAs in Ipswich.

IA Data Explorer filtered data tab

Modal windows

The modal windows in the data explorer have gained Apply, Clear and Cancel buttons to make them more user-friendly.

IA Data Explorer modal window

IA Data Explorer – 27 April 2020 Release Notes

The latest version of InstantAtlas Data Explorer (version 2.0.0) is now available at https://hub.instantatlas.com/.

Version 2.0.0 extends the functionality of the data explorer for searching and visualising data in an InstantAtlas data catalog still further by adding powerful charting capabilities and a new redesigned user interface.

Enhancements

  • Improved interface with tabs to switch between metadata, table, map, time series and ranked bar chart
  • New charts to visualize indicator data – time series and distribution/ranking
  • Options to view time series as line, bar or stacked bar chart
  • Improved mapping functionality – within the app rather than as a separate app – version 4 of JavaScript API replaces version 3
  • Full control over which features and dates are displayed in the charts and tables
  • Improved admin/author control over which functionality is available to end users (via ArcGIS Online configure app)
  • Options to view tabular data in “standard” or “flat” format
  • Improvements to download of data

Bug fixes

  • Fixes for bugs when using Internet Explorer 11
  • Fix for commas in area names breaking data downloads
  • Other minor bug fixes

Improved user interface

The data explorer has been updated so that all data visualisation options are integrated within the app. Once an indicator has been selected in the data explorer, a series of tabs provide access to the different views:

  • Metadata: view a description and the full set of metadata for the selected indicator
  • Table: view the selected indicator for all available features and dates, and download as a CSV file
  • Map: view the selected indicator as a thematic map with different classifications available including shaded areas and proportional circles
  • Time Series: view the time series for the selected indicator using a line, bar or stacked bar chart that can be downloaded
  • Ranked Bar Chart: view a bar chart ranking the features for the selected indicator

Controls

Each view can be customised by the end user via a series of controls located at the top of the tab. These controls are hidden by default but can be displayed by clicking the  cog wheel icon.

  • Select geography menu: use this menu to select from the list of available geographies
  • Select dates: use these menus to select the range of dates you would like to view data for
  • Filter features: use this button to access the list of features belonging to the active geography and use the checkboxes to make your selection. Click X to apply the selection.
  • Table format: choose between Standard and Flat formats for the data
  • Download: download the data as a CSV file that can be opened in another package such as MS Excel for further analysis.

Table

The table by default will show data for all dates available for the selected indicator, for all of the features in the active geography. The end-user can filter the features and change the date range using the controls above the table. The table can be scrolled if there are too many features/dates to show on the screen. The download button will download the table as a CSV file; only the data showing in the table when the button is clicked will be downloaded.

IA Data Explorer Data tab

Map

The map will show data for a single date for the selected indicator, for all of the features in the active geography. The end user can change the geography, select a different available date for the indicator and change the map classification. The map is interactive and can be dragged and zoomed. There are a number of options available from the map area:

  • Home: return to the default map extent
  • Export: export the map as an image or a PDF – there are various options to change the layout, or add a title and other text
  • Basemap: change the basemap for the thematic map
  • Search: type in the search box to search for a feature in the active geography or a place in the map area

IA Data Explorer Map tab

Time Series

The chart will by default show data for all dates for the selected indicator, for up to 10 features in the active geography. The end user can change the date range and filter the features using the controls above the table. They may also click the checkbox to remove the 10 feature limit, although this may create a messy chart depending on the number of features in the active geography. There is a menu to change the type of chart:

  • Line: a separate line is shown for each feature
  • Bar: a separate bar is shown for each feature
  • Stacked bar: one bar is shown for each date and features are stacked

IA Data Explorer Time Series tab - line chart
IA Data Explorer Time Series tab - bar chart
IA Data Explorer Time Series tab - stacked bar chart

Ranked Bar Chart

The ranked bar chart shows the data for a single date for the selected indicator, with a bar for each feature in the active geography. The end user can change the selected geography, date, filter the features or download the chart as an image.

IA Data Explorer Ranked Bar Chart tab

Metadata

The metadata tab displays the description and the full set of metadata for the selected indicator. This can be download as a CSV file using the download button.

IA Data Explorer Metadata tab