jekyll-streetview — a Google Street View image of 100 S Hill Street, Griffin, GA embedded with a single Liquid tag.

Open Source Plugin ∙ 20 August, 2026

jekyll-streetview

A Jekyll plugin that provides a streetview Liquid tag for embedding Google Street View static images with no JavaScript required.

jekyll-streetview is a Jekyll plugin that embeds a Google Street View static image anywhere in your Jekyll site with a single tag. It outputs a plain <img> element powered by the Google Street View Static API — no JavaScript, no iframes, no SDK.

Demo

The image below shows 100 S Hill Street in downtown Griffin, Georgia:

100 S Hill Street, Griffin, Georgia

{% streetview "100 S Hill Street, Griffin, GA" heading=270 fov=80 width=640 height=400 %}

Why This Exists

Maps tell you where something is. Street View tells you what it looks like standing in front of it. For location-based writing — downtown revitalization projects, business profiles, neighborhood coverage — a Street View embed adds immediate context that a map alone can’t provide.

Source Code

GitHub: github.com/jchance/jekyll-streetview
RubyGems: rubygems.org/gems/jekyll-streetview

Installation

Add to your Gemfile:

gem "jekyll-streetview", "~> 0.1"

Add to _config.yml:

plugins:
  - jekyll-streetview

streetview:
  key: AIzaSy...

Your Google API key needs the Street View Static API enabled. If you use address strings, it also needs Geocoding API enabled.

Then run bundle install.

Usage

By address string (geocoded at build time, cached in _streetview_cache.json):

{% streetview "100 S Hill Street, Griffin, GA" %}

By latitude and longitude:

{% streetview lat=33.248329 lng=-84.263336 %}

With camera controls:

{% streetview "100 S Hill Street, Griffin, GA" heading=270 fov=60 pitch=10 %}

Supported Parameters

Parameter	Default	Description
`lat` / `lng`	—	Coordinates (required if no address string)
`width`	`800`	Image width in pixels
`height`	`400`	Image height in pixels
`heading`	auto	Camera compass heading (0-360). Omit to let Google point toward the location.
`fov`	`90`	Horizontal field of view (10-120). Lower values zoom in.
`pitch`	`0`	Up/down angle (-90 to 90). Positive = up, negative = down.
`radius`	`50`	Search radius in meters for nearest panorama
`source`	—	Set to `outdoor` to exclude indoor panoramas
`alt`	`"Street View"`	Alt text for the image

Note on image size

The Google Street View Static API caps image dimensions at 640x640 on the free tier. The plugin enforces this automatically — if you pass width=800 it will be clamped to 640. Billing-enabled accounts support up to 1280x1280.

Styling

The plugin outputs an <img> with the class jekyll-streetview:

.jekyll-streetview {
  width: 100%;
  height: auto;
  border-radius: 4px;
}