Landline

Creating a map with Landline is as easy as passing it some GeoJSON.

var map = new LandLine(YOUR_GEOJSON).all();

Landline does the work of translating GeoJSON to SVG, so the level of complexity of your map is really up to you. The resulting SVG string can be sent right to the browser (for modern browsers) or proxied through Raphael.js for universal support.

With Landline, you bring your own projection (based on how the GeoJSON was processed), but you can also pass in your own projection function if you’d like to reproject the map on the fly.

Landline has no dependencies other than Underscore.js.

Stateline

Creating a state map with Stateline is as easy as requiring the packaged state or county JSON file, specifying a container element and whether you’d like a state or county map:

var stateMap = new Landline.Stateline(container, "states");

You can also pass your own data to the map by joining on two-digit or five-digit FIPS codes associated with states and counties. This is ideal for presenting census data (such as the income map on our demo page), which comes with FIPS-based geoids.

The state and county maps packaged for Stateline are in the Albers projection for the continental U.S., and respective state plane projections for Alaska and Hawaii.

Stateline requires Underscore, jQuery and Raphaël.

Although we’re releasing Landline and Stateline to the public today, it’s still very much a work in progress. One thing we’re considering is moving the library to TopoJSON, a lighter weight format for sending geographic data over the wire (as it stands, the prepackaged county file clocks in at around 800 kilobytes, which is a bit big for most web applications). We’d also like to build up our library of Stateline packages for maps of counties within individual states, and other countries. Want to help out? Send us a pull request!