Giorgos Sarigiannidis

A map block for Gutenberg which uses <a href="https://www.openstreetmap.org" rel="nofollow ugc">OpenStreetMap</a> and <a href="https://leafletjs.com" rel="nofollow ugc">Leaflet.js</a>. It needs no API keys and works out of the box (or, out of the Block, if you prefer). Benefiting from Gutenberg’s potential, the plugin tries a different take on how to add your locations on the map and rethinks a few things, UX-wise.
Instead of manually adding coordinates for each one of your markers, just click-and-drop them directly on the map. You want to adjust their position? Just drag them wherever you want. And instead of filling-in custom fields to set each marker’s popup content, just open that popup and start writing in it, the Gutenberg way (it supports WYSIWYG editing, with links, images, and all). It even stores the map’s zoom level as you use it so that you don’t have to set it by hand.
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/FGe7zJnrIgo?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe>
<ul>
<li><a href="https://github.com/gsarig/ootb-openstreetmap" rel="nofollow ugc">Follow the project’s development on GitHub</a></li>
<li><a href="https://github.com/gsarig/ootb-openstreetmap/releases" rel="nofollow ugc">Release history</a></li>
<li><a href="https://github.com/users/gsarig/projects/1" rel="nofollow ugc">Roadmap</a></li>
<li><a href="https://github.com/gsarig/ootb-openstreetmap?tab=readme-ov-file#hooks" rel="nofollow ugc">Hooks🪝</a></li>
<li><a href="https://github.com/gsarig/ootb-openstreetmap?tab=readme-ov-file#shortcodes" rel="nofollow ugc">Shortcodes</a></li>
</ul>
<h4>Features</h4>
<ul>
<li>No need for API keys. Just install and use it.</li>
<li>Support for multiple markers.</li>
<li>Support for a different icon per marker.</li>
<li>Support for polygons and polylines.</li>
<li><a href="https://www.gsarigiannidis.gr/wordpress-gutenberg-map-block-openstreetmap/" rel="nofollow ugc">Dead-simple interface</a>. Don’t search for coordinates and don’t get overwhelmed by too many fields when using multiple markers. Just point and click on the map to add your marker where you want it and edit it’s popup content directly from there.</li>
<li><a href="https://www.gsarigiannidis.gr/openstreetmap-place-search/" rel="nofollow ugc">Place search</a>. Find locations by typing keywords.</li>
<li>Remembers the zoom that you set when adding the markers and stores it so that you don’t set it by hand (which you can do anyway if you prefer).</li>
<li>AI integration which allows you to add markers by using commands in natural language. Just say “please” to activate (e.g. “Please, show me where GOT was filmed”). Requires an API key from an AI Provider. <a href="https://www.gsarigiannidis.gr/openstreetmap-openai-integration/" rel="nofollow ugc">Read more</a>.</li>
<li>Query Maps: Supports creating a map out of maps added on other posts or post types. This can be quite powerful when, for example, you have a custom post type for “Places” with each place having its own map, and you want to dynamically gather-up all the places on a single map.</li>
<li>Shortcode support: You can use the shortcode <code>[ootb_query]</code> as an alternative way to use the aforementioned Query Maps feature (see the FAQ for more info).</li>
<li>Support for a location custom field, which can be used to store a post’s or post type’s location, following the <a href="https://codex.wordpress.org/Geodata" rel="nofollow ugc">Geodata guidelines</a>. Read more in the <a href="https://github.com/gsarig/ootb-openstreetmap/releases/tag/2.8.0" rel="nofollow ugc">v.2.8.0 release notes</a>.</li>
<li>Adjust the map height.</li>
<li>Change the default marker icon with a custom one.</li>
<li>Enable or disable map dragging.</li>
<li>Enable or disable touch zoom.</li>
<li>Enable or disable double-click zoom.</li>
<li>Enable or disable scroll wheel zoom.</li>
<li>Set a minimum and maximum limit that the user can zoom on the frontend. Setting the same value to both fields will lock the zoom at that level.</li>
<li>Support for other Layer Providers: MapBox (using your own API key) and Stamen.</li>
<li>Option to export locations in a JSON file</li>
<li>Option to import locations from a JSON file</li>
</ul>

Out of the Block: OpenStreetMap

Just because we don't need an API license key, and we can have multiple pins per map among other things, for me this is the best mapping block. And of course, the plugin works exactly as advertised.

Until now, I was using my own map block I had created with ACF Pro, but that was just simple Google Map embed, which again did not require an API key, but was restricted to one pin per map, and of course no live data like traffic and other visuals, along with no street view.

Well done, and thank you,
Nick.

The best map block


In 5 minutes I had a map with a marker. Easy!


Loved it!

A map block for Gutenberg using OpenStreetMap and Leaflet that needs no API keys and works out of the box. Or should we say, ...Out of the Block?

Step-Byte-Service GmbH

Add beautiful maps to your WordPress pages with ease. Customize location, map styles, up to two markers, routing and more. Include the map as Gutenberg block, WPBakery Page Builder (formerly Visual Composer) content element or shortcode.
<h3>General Settings</h3>
This plugin comes with sane predefined settings. Adjust them to your liking. The marker is optional and is not displayed by default.
<h4>Map Settings</h4>
Map Style Choose the style of the map from one of the available map tile providers to fit your needs. 
Map Style Key Enter an API key or access token for the provider depending on the chosen map style. Only required for some map style providers. 
Map Height in Relation to Width Change the map’s aspect ratio. Works nicely with responsive designs. 
Zoom Level Change the view distance. The higher the number, the closer the distance to the map. (Note: not all styles support all zoom levels). 
Zoom With CTRL-Key Only Prevent zooming during page scroll. 
Latitude/Longitude of the Map’s Center Specify the map’s center position. Only needed if no marker configured or no marker is set as center of the map. 
Activate Routing Activate route planning for the user. 
Show Attribution Display or hide attribution for map styles and data. If you disable the checkbox please consider the legal circumstances.
<h4>Routing Settings</h4>
Default Routing Destination Enter the number of the marker that should be the default routing destination. 
Routing Service Choose the routing service that is used for retrieving the routing information. 
Routing Key Enter an API key or access token depending on the chosen routing service.
<h4>Geocoding Settings</h4>
Geocoding Service Choose the geocoding service that is used to translate addresses to latitude and longitude. 
Geocoding Key Enter an API key or access token depending on the chosen geocoding service.
<h4>Marker Settings</h4>
Center map on Enter the number of the marker that should be in the center of the map. 
Determine Position By Choose if you want to specify the marker position by an address or coordinates. The marker appears only if you specify an address or coordinates. 
Address Insert the marker’s address here with comma separated address parts (only used if you have chosen ‘Address’ in previous setting). 
Latitude/Longitude Specify marker position with latitude and longitude data (only used if you have chosen ‘Coordinates’ in first setting). 
Icon The icon to appear on the marker. Subset from <a href="https://material.io/resources/icons/?style=outline" rel="nofollow ugc">Material Icons</a> in outlined style (available categories: Maps, Places, Social). 
Color Background color of the marker. 
Popup Text Content of the popup that appears if the user clicks on the marker.
<h3>Gutenberg</h3>
The block is located in the ‘Embed’ category and supports the wide and full width options.
<h3>WPBakery Page Builder</h3>
The content element for the map can be found on the ‘Content’ tab with the name ‘SBS OpenStreetMap’. The content element for the marker can also be found on the ‘Content’ tab with the name ‘SBS Openstreetmap Marker’ but only as child of the map element.
<h3>Shortcodes</h3>
The Plugin comes with two shortcodes: <code>[sbs_openstreetmap]</code> for the map and <code>[sbs_marker]</code> for the markers (need to be placed between the opening and closing tags of the map shortcode). 
If parameters are not specified, the defaults are used (the same as in the other components). The popup text for the marker can be specified between the opening and closing tags of the marker shortcode.
<h4>Parameters Map Shortcode</h4>
See section ‘General Settings’ for description. Name in parentheses is the entry there.
map_style (Map Style) 
Choose provider and style variant and define map_style as ‘provider.variant’ (eg. Thunderforest.Transport) or in case of a provider without variants just ‘provider’ (eg. OpenTopoMap) . (pay attention to upper and lower case)
Available Provider with Variants: 
OpenStreetMap — Variants: DE (default), Mapnik, France, HOT 
OpenTopoMap 
Stadia — Variants: AlidadeSmooth, AlidadeSmoothDark, Outdoors, OSMBright, StamenToner, StamenTonerLite, StamenTerrain, StamenWatercolor 
Thunderforest — Variants: OpenCycleMap, Transport, TransportDark, SpinalMap, Landscape, Outdoors, Pioneer, MobileAtlas, Neighbourhood 
MapBox — Variants: Streets, Outdoors, Light, Dark, Satellite 
CartoDB — Variants: Positron, DarkMatter, Voyager 
MapTiler — Variants: Basic, Bright, Pastel, Positron, Hybrid, Streets, Toner, Topo, Voyager
For more information see section ‘Map Styles’. 
map_style_key (Map Style Key) Needed for certain map providers. 
map_height (Map Height in Relation to Width) Use a number as percentage of the width. Default value is 50. 
zoom (Zoom Level) Number between 0 and 20. Default value is 15. 
ctrl_mouse_zoom (Zoom With CTRL-Key Only) Set to true or false. Default is false. 
latitude (Latitude of the Map’s Center) 
longitude (Longitude of the Map’s Center) 
routing (Activate Routing) Set to true or false. Default is false. 
show_attribution (Show Attribution) Set to true or false. Default is true. 
destination_marker (Default Routing Destination) Number of the marker shortcode based on order inside the map shortcode. 0 if no marker is supposed to be the default routing destination. Default is 1. 
router (Routing Service) Available values: 
osrmv1 (default) 
mapbox 
router_key (Routing Key) Needed for certain routing services. 
geocoder (Geocoding Service) Available values: 
nominatim (default) 
mapbox 
geocoder_key (Geocoding Key) Needed for certain geocoding services. 
center_marker (Center Map on) Number of the marker shortcode based on order inside the map shortcode. 0 if no marker is supposed to be the center of the map. Default is 1.
<h4>Parameters Marker Shortcode</h4>
See section ‘General Settings’ for description. Name in parentheses is the entry there.
marker_source (Determine Position By) Available values: 
address (default) 
coordinates 
marker_address (Address) 
marker_latitude (Latitude) 
marker_longitude (Longitude) 
marker_icon (Icon) CSS classes for the icon. Go to the Material Icon website and choose your desired icon. To get the CSS classes, use the icon’s name, replace the underscore with a hyphen and prepend ‘sbs-map-icon sbs-map-‘. Example: icon ‘local_airport’ becomes ‘sbs-map-icon sbs-map-local-airport’ 
marker_color (Color) Available values: 
red 
white 
dark_blue (default) 
green 
black 
orange 
yellow
Examples:
<pre><code>[sbs_openstreetmap][sbs_marker][/sbs_marker][/sbs_openstreetmap]
</code></pre>
Uses default values
<pre><code>[sbs_openstreetmap center_marker="1"][sbs_marker marker_source="coordinates" marker_color="green" marker_latitude="52.4681196" marker_longitude="13.3279639" marker_icon="sbs-map-icon sbs-map-my-location"][/sbs_marker][/sbs_openstreetmap]
</code></pre>
Green marker from coordinates with my_location icon, centered map at marker and no popup text
<pre><code>[sbs_openstreetmap map_style="CartoDB.Voyager" map_height="30" zoom="14" ctrl_mouse_zoom="true"][sbs_marker marker_color="dark_blue" marker_address="Bundesallee 87, 12161 Berlin" marker_icon="sbs-map-icon sbs-map-beenhere"]Popup Text[/sbs_marker][/sbs_openstreetmap]
</code></pre>
CartoDB Voyager style, Zoom with CTRL key only, dark blue marker from address with popup text
<pre><code>[sbs_openstreetmap map_style="MapBox.Streets" map_style_key="<your access token>"][/sbs_openstreetmap]
</code></pre>
Mapbox Streets style that needs an access token
<pre><code>[sbs_openstreetmap zoom="12" latitude="52.493558" longitude="13.375148" center_marker="0"][sbs_marker marker_address="Bundesallee 87, 12161 Berlin"]Marker 1[/sbs_marker][sbs_marker marker_address="Platz der Republik 1, 10557 Berlin"]Marker 2[/sbs_marker][/sbs_openstreetmap]
</code></pre>
Two markers with different addresses, center of the map somewhere in between through coordinates
<h3>Map Styles</h3>
The selectable styles are offered by various providers. Each provider has its own terms of use and licensing, which should be taken into account before using the styles. (See section ‘Licenses/Policies’ for links) 
Providers could change their terms of use or might not be available at all times (especially if they are free/ without registration).
<h4>Providers</h4>
OpenStreetMap 
Usable without registration. 
Variants: DE, Mapnik, France, HOT 
Examples: <a href="https://www.openstreetmap.de/karte.html" rel="nofollow ugc">DE</a>, <a href="https://www.openstreetmap.org/#map=6/55.801/22.126" rel="nofollow ugc">Mapnik</a>, <a href="http://tile.openstreetmap.fr/" rel="nofollow ugc">France</a>, <a href="https://www.openstreetmap.org/#map=6/55.179/22.830&layers=H" rel="nofollow ugc">HOT</a> 
Tiles: 
* DE: https://tile.openstreetmap.de/{z}/{x}/{y}.png 
* Mapnik: https://tile.openstreetmap.org/{z}/{x}/{y}.png 
* France: https://{s}.tile.openstreetmap.fr/osmfr/{z}/{x}/{y}.png 
* HOT: https://{s}.tile.openstreetmap.fr/hot/{z}/{x}/{y}.png 
Attributions: 
* DE, Mapnik: © <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">OpenStreetMap</a> contributors 
* France: © OpenStreetMap France | © <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">OpenStreetMap</a> contributors 
* HOT: © <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">OpenStreetMap</a> contributors, Tiles style by <a href="https://www.hotosm.org/" rel="nofollow ugc">Humanitarian OpenStreetMap Team</a> hosted by <a href="https://openstreetmap.fr/" rel="nofollow ugc">OpenStreetMap France</a>
OpenTopoMap 
Usable without registration. 
<a href="https://opentopomap.org/#map=6/49.532/16.194" rel="nofollow ugc">Example</a> 
Tiles: 
* https://{s}.tile.opentopomap.org/{z}/{x}/{y}.png 
Attributions: 
* Map data: © <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">OpenStreetMap</a> contributors, <a href="http://viewfinderpanoramas.org" rel="nofollow ugc"></a> | Map style: © <a href="https://opentopomap.org" rel="nofollow ugc">OpenTopoMap</a> (<a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="nofollow ugc">CC-BY-SA</a>)
Stadia 
In order to use Stadia maps, you must <a href="https://client.stadiamaps.com/signup/" rel="nofollow ugc">register</a> and whitelist your domain within your account. Map styles from Stamen are now included in Stadia. 
Variants: AlidadeSmooth, AlidadeSmoothDark, Outdoors, OSMBright, StamenToner, StamenTonerLite, StamenTerrain, StamenWatercolor 
<a href="https://docs.stadiamaps.com/themes/" rel="nofollow ugc">Examples</a> 
Tiles: 
* https://tiles.stadiamaps.com/tiles/{variant}/{z}/{x}/{y}{r}.{ext} 
Attributions: 
* Stamen: © <a href="https://www.stadiamaps.com/" rel="nofollow ugc">Stadia Maps</a> © <a href="https://www.stamen.com/" rel="nofollow ugc">Stamen Design</a> © <a href="https://openmaptiles.org/" rel="nofollow ugc">OpenMapTiles</a> © <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">OpenStreetMap</a> contributors 
* Other: © <a href="https://www.stadiamaps.com/" rel="nofollow ugc">Stadia Maps</a> © <a href="https://openmaptiles.org/" rel="nofollow ugc">OpenMapTiles</a> © <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">OpenStreetMap</a> contributors
Thunderforest 
In order to use Thunderforest maps, you must <a href="https://www.thunderforest.com/pricing/" rel="nofollow ugc">register</a>. Once registered, you get an API key to use for the map styles. 
Variants: OpenCycleMap, Transport, TransportDark, SpinalMap, Landscape, Outdoors, Pioneer, MobileAtlas, Neighbourhood 
<a href="https://www.thunderforest.com/maps/" rel="nofollow ugc">Examples</a> 
Tiles: 
* https://{s}.tile.thunderforest.com/{variant}/{z}/{x}/{y}.png?apikey={apikey} 
Attributions: 
* © <a href="http://www.thunderforest.com/" rel="nofollow ugc">Thunderforest</a>, © <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">OpenStreetMap</a> contributors
MapBox 
In order to use MapBox maps, you must <a href="https://account.mapbox.com/auth/signup/" rel="nofollow ugc">register</a>. Once registered, you get an access token to use for the map styles. 
Variants: Streets, Outdoors, Light, Dark, Satellite 
<a href="https://www.mapbox.com/maps" rel="nofollow ugc">Examples</a> 
Tiles: 
* https://api.mapbox.com/styles/v1/{id}/tiles/{z}/{x}/{y}{r}?access_token={accessToken} 
Attributions: 
* © <a href="https://www.mapbox.com/about/maps/" rel="nofollow ugc">Mapbox</a> © <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">OpenStreetMap</a> contributors <a href="//www.mapbox.com/map-feedback/" rel="nofollow ugc">Improve this map</a>
CartoDB 
Basemaps are usable without registration. 
Variants: Positron, DarkMatter, Voyager 
<a href="https://carto.com/help/building-maps/basemap-list/" rel="nofollow ugc">Examples</a> 
Tiles: 
* https://{s}.basemaps.cartocdn.com/{variant}/{z}/{x}/{y}{r}.png 
Attributions: 
* © <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">OpenStreetMap</a> contributors <a href="https://carto.com/attributions" rel="nofollow ugc">CARTO</a>
MapTiler 
In order to use MapTiler maps, you must <a href="https://cloud.maptiler.com/auth/widget?mode=select&next=https%3A%2F%2Fcloud.maptiler.com%2Fstart" rel="nofollow ugc">register</a>. Once registered, you get an API key to use for the map styles. 
Variants: Basic, Bright, Pastel, Positron, Hybrid, Streets, Toner, Topo, Voyager 
<a href="https://www.maptiler.com/maps/#streets/raster/1/2.3/8.2" rel="nofollow ugc">Examples</a> 
Tiles: 
* https://api.maptiler.com/maps/{variant}/{z}/{x}/{y}{r}.{ext}?key={key} 
Attributions: 
* <a href="//www.maptiler.com/copyright/" rel="nofollow ugc">© MapTiler</a> <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">© OpenStreetMap contributors</a>
<h4>Deprecated</h4>
These values are deprecated and will be mapped onto the corresponding new values for the same map style. 
openstreetmap_de 
opentopomap 
stamen_toner 
stamen_toner_light 
stamen_terrain 
stamen_watercolor 
wikimedia (not available anymore and if set in map, will be replaced with OpenStreetMap.DE)
<h3>Licenses/Policies</h3>
<h4>External Services</h4>
Provides the map data 
OpenStreetMap <a href="https://www.openstreetmap.org/copyright" rel="nofollow ugc">ODbL</a> 
Providers for routing 
OSRM Demo Server <a href="https://github.com/Project-OSRM/osrm-backend/wiki/Api-usage-policy" rel="nofollow ugc">Usage policy</a> 
Mapbox <a href="https://www.mapbox.com/legal/tos/" rel="nofollow ugc">Terms of service</a> 
Providers for geocoding 
Nominatim <a href="https://operations.osmfoundation.org/policies/nominatim/" rel="nofollow ugc">Usage policy</a> 
Mapbox <a href="https://www.mapbox.com/legal/tos/" rel="nofollow ugc">Terms of service</a> 
Providers used for choosable map styles 
OpenStreetMap <a href="https://operations.osmfoundation.org/policies/tiles/" rel="nofollow ugc">Terms of use</a> 
OpenTopoMap <a href="https://opentopomap.org/about" rel="nofollow ugc">CC-BY-SA/Terms of use</a> 
Stadia <a href="https://stadiamaps.com/terms-of-service/" rel="nofollow ugc">Terms of use</a> 
Thunderforest <a href="https://www.thunderforest.com/terms/" rel="nofollow ugc">Terms of use</a> 
MapBox <a href="https://www.mapbox.com/legal/tos/" rel="nofollow ugc">Terms of use</a> 
CartoDB <a href="https://carto.com/legal/" rel="nofollow ugc">Terms of use</a> 
MapTiler <a href="https://www.maptiler.com/cloud/terms/" rel="nofollow ugc">Terms of use</a>
<h4>Third-Party Components</h4>
<a href="https://leafletjs.com/" rel="nofollow ugc">Leaflet JS</a> <a href="https://github.com/Leaflet/Leaflet/blob/master/LICENSE" rel="nofollow ugc">BSD 2-Clause “Simplified” License</a> 
Leaflet.GestureHandling <a href="https://github.com/elmarquis/Leaflet.GestureHandling/blob/master/LICENSE" rel="nofollow ugc">MIT License</a> 
Leaflet-providers <a href="https://github.com/leaflet-extras/leaflet-providers/blob/master/license.md" rel="nofollow ugc">BSD 2-Clause “Simplified” License</a> 
Leaflet-control-geocoder <a href="https://github.com/perliedman/leaflet-control-geocoder/blob/master/LICENSE" rel="nofollow ugc">BSD 2-Clause “Simplified” License</a> 
Leaflet-routing-machine <a href="https://github.com/perliedman/leaflet-routing-machine/blob/master/LICENSE.md" rel="nofollow ugc">ISC License</a>

OpenStreetMap for Gutenberg and WPBakery Page Builder (formerly Visual Composer)

A really good alternative to google maps.

Nice and easy

OpenStreetMap Gutenberg block, WPBakery PageBuilder content element and standalone WordPress shortcode

Out of the Block: OpenStreetMap vs OpenStreetMap for Gutenberg and WPBakery Page Builder (formerly Visual Composer)