Overview

StateBook ChartIT product provides a simple JavaScript API for easily displaying StateBook charts on your website. The API can display interactive charts and graphs for specific geographic regions and specific topics, similar to those shown on the StateBook website. Very little development experience is needed to integrate the API into your website.

The API allows you to display either individual charts and graphs, or groups of charts and graphs called component packs, or collections of charts called dashboards. This allows you to control the data that is seen on your website, and also to show a large choice of data using a very little code. The API will provide pulldown menus and selectors that allow the user to control which chart is seen.

What is an Individual Chart?

As the website developer, you can request an individual chart or graph from StateBook. This would represent a single topic such as showing ACS data on Age Range Demographics. Charts are highly interactive, with options to drill down through hierarchical data, scroll through larger sets of data, and hover over chart components to see additional data points and footnotes.

Chart Styles

A wide variety of charts are possible; however, StateBook currently focuses on charts that measure five sets of statistics:

• Single Year – Values or percentages for a single year
• Five Year History - Comparative values or percentages for the past five years
• Average Yearly Change – Average yearly change values and percentages, calculated for a historical set of years.
• Benchmark – Comparisons against state and national benchmarks

Customization

Charts can be customized to help match the website’s theme and dimensions.  The settings that can be configured per chart are:

• Height (in pixels)
• Width (in pixels)
• Chart title
• Chart subtitle
• Border 
• Margin
• Chart Series Colors
• Number of X Axis Items

Printing and Exporting

Charts can be printed, and can also be exported to common picture formats (PDF, JPG, PNG, SVG).

What is a Component Pack?

As the website developer, you can request a component pack, which is a series of charts or tables controlled by selectors and pulldowns at the top.  In this example, users could select from a variety of topics, chart styles, years, and specific criteria.  The entire component pack can be implemented in a web page with a single API call.

What is a Dashboard?

As the website developer, you can request a dashboard, which is a series of charts or tables arranged in a grid, optionally controlled by selectors and pulldowns at the top.  In this example, users could select from a variety of geographies, topics, chart styles, years, and specific criteria.  The entire dashboard can be implemented in a web page with a single API call.