Mapkick Static

Create beautiful static maps with one line of Ruby. No more fighting with mapping libraries!

See it in action

🔥 For JavaScript maps, check out Mapkick

Installation

Add this line to your application’s Gemfile:

gem "mapkick-static"

Mapkick Static uses the Mapbox Static Images API. Create a Mapbox account to get an access token and set ENV["MAPBOX_ACCESS_TOKEN"] in your environment.

Maps

Point map

<%= static_map [{latitude: 37.7829, longitude: -122.4190}] %>

Area map

<%= static_area_map [{geometry: {type: "Polygon", coordinates: ...}}] %>

Data

Data can be an array

<%= static_map [{latitude: 37.7829, longitude: -122.4190}] %>

Point Map

Use latitude or lat for latitude and longitude, lon, or lng for longitude

You can specify a color for each data point

{
  latitude: ...,
  longitude: ...,
  color: "#f84d4d"
}

Area Map

Use geometry with a GeoJSON Polygon or MultiPolygon

You can specify a color for each data point

{
  geometry: {type: "Polygon", coordinates: ...},
  color: "#0090ff"
}

Options

Width and height

<%= static_map data, width: 800, height: 500 %>

Alt text

<%= static_map data, alt: "Map of ..." %>

Marker color

<%= static_map data, markers: {color: "#f84d4d"} %>

Map style

<%= static_map data, style: "mapbox/outdoors-v12" %>

History

View the changelog

Contributing

Everyone is encouraged to help improve this project. Here are a few ways you can help:

• Report bugs
• Fix bugs and submit pull requests
• Write, clarify, or fix documentation
• Suggest or add new features

To get started with development:

git clone https://github.com/ankane/mapkick-static.git
cd mapkick-static
bundle install
bundle exec rake test