Skip to content
This repository was archived by the owner on Nov 1, 2025. It is now read-only.
/ mbplugin-maps Public archive

Micro.blog plugin for embedding static, and on-click interactive maps from OpenStreetMap while respecting data privacy.

License

Notifications You must be signed in to change notification settings

flschr/mbplugin-maps

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

174 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Warning

This plugin is deprecated. Please consider switching to the new, more robust and reliable version of this plugin: https://github.com/flschr/mbplugin-osm-embeds

OpenStreetMap Plugin for Micro.blog

OSM Map embeds for Micro.blog

A privacy-friendly plugin for embedding OpenStreetMap views in Micro.blog posts. Shows an optional static preview image that turns into an interactive map when clicked.

Quick Start

Add this shortcode to your post:

{{< map loc="48.1351,11.5820" zoom="14" >}}

That's it! The map will be embedded automatically.

Parameters

  • loc – Coordinates in latitude,longitude format (e.g. 48.1351,11.5820)
  • zoom – Zoom level from 0 (whole world) to 19 (building level), default: 14

Recommended zoom levels:

  • 10–13 for city/region
  • 14–16 for neighborhood/town center (default)
  • 17–19 for individual buildings

Example

Embedded OSM in a Micro.blog posting

Live example: fischr.org/2017/09/03/oben-links-am-lago-di

Testing

Use the OSM Embed Validator to try out your settings in the browser.

Settings

Configure these options in your Micro.blog plugin settings:

  • Geoapify API Key – For static preview images (optional but recommended)
  • Default Zoom – Used when no zoom is specified in the shortcode
  • Preview Style – Map design for light/dark mode
  • Privacy Notice – Text for optional privacy overlay

Set Up Static Previews (Optional)

Without an API key, the map embeds directly. With Geoapify you get a clickable preview image:

  1. Create free account at Geoapify (3000 requests/day free)
  2. Generate API key in dashboard
  3. Enter key in plugin settings
  4. Optional: Choose map style (e.g. osm-carto, dark-matter-yellow-roads)

Notes

  • The plugin uses OpenStreetMap servers. High-traffic sites should consider running their own tile servers.
  • RSS feeds will show maps automatically when coordinates are provided.

👤 Author

René Fischer – https://fischr.org

Changelog

  • 5.0.1 – CSS-only preview toggle without JavaScript
  • 5.0.0 – Direct OpenStreetMap iframe, coordinates required
  • 4.x – Migration from Google Maps to OpenStreetMap

About

Micro.blog plugin for embedding static, and on-click interactive maps from OpenStreetMap while respecting data privacy.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages