google-map-static-image-generator

A Ruby gem that wraps the Google Maps Static API to generate customizable static map images in Rails applications.

Installation

Add this line to your Gemfile:

gem 'google-map-static-image-generator'

Then run:

bundle install

Usage

map = GoogleMapStaticImage.new

response = map.get_response(
  "YOUR_GOOGLE_API_KEY",
  markers,           # array of marker coordinate strings
  style:    { feature: "all", element: "labels", visibility: "off" },
  path:     { weight: 3, color: "blue" },
  location: { lat: "48.8584", lng: "2.2945" },
  markers:  [["48.8584,2.2945"], ["48.8606,2.3376"]]
)

The response is the raw parsed response from the Google Static Maps API — typically image binary data or a redirect URL depending on your usage.

Options

Option Description
style Map style rules as a hash (key: value pairs joined with `\
path Path styling options (weight, color, etc.)
location Hash of lat/lng to append to the path
markers Array of marker groups; each group is an array of coordinate strings

The default image size is 1024x1024 at scale 2.

Dependencies