Skip to content

This WordPress widget adds a mobile-optimised Google Static Map Image with a colored pin centered on a destination of your choosing.

Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



61 Commits

Repository files navigation

Mobile Map Widget

January 1, 2021: No longer in active development, use at own risk

Version 2.4.2
requires at least WordPress 4.4
tested up to 5.4
Author: Pieter Bos

This WordPress widget adds a mobile-optimized Google Static Map Image with a colored pin centered on a destination of your choosing.


Mobile Map Widget is meant for websites that target browsing via mobile devices. This widget adds a mobile-optimized Static Google Maps Image with a colored pin centered on your destination. Once clicked it opens the Google mobile maps website where you can fill in your Current Location if it is not already there. Then you can see the directions from your location to the destination as well as the map with the route of your choice. Optimized for mobile use. Google Static Maps API-key is required.

The reason we developed the Mobile Map Widget as a plugin, is because while implementing the widget for a mobile framework we were building for the hospitality industry, we realized that this widget can come in handy for many other scenarios too. It can for example be added to a company website to help people find the office location from wherever in the city they are. A travel information site can use it to include maps of tourist attractions, bars and restaurants can use it, you can use it to direct people to your new home, it can even come in handy for if you organize a party with a location that is kept secret till the very last moment!

Once activated you can go to your Widgets (in the backend under Appearance or via the Customizer) and drag the Mobile Map Widget to the sidebar of your choice. When you have placed the widget in a sidebar you need to fill in the following data:

  1. Title (optional).

  2. Destination. Use an address or use the coordinates. The map will also be automatically centered on this location.

  3. Color of the pin. You can choose from black, brown, green, purple, yellow, blue, gray, orange, red, white.

  4. Zoom level. From 0 (world view) to 21+ (street view); from 15 and up seems to be good for locations in larger cities, but best to check and play around with it a bit.

  5. Width in pixels. The image width will be automatically scaled to optimize for mobile screens.

  6. Height in pixels.

  7. Google Static Maps API Key (REQUIRED). Since July 16, 2018 a valid credit card is required by Google to sign up for the API-key

  8. Description (optional). You can use this field to add a description under the map image, for example to inform your visitors that the image is clickable.

Save the widget and check the frontend of the site to see the map image.

We support this plugin here on Github. Therefore, if you have any questions, need help and/or want to make a feature request, please open an issue here.

If you like the Mobile Map Widget plugin, please consider leaving a review or making a donation. Thanks!

Mobile Map Widget plugin by SO WP.

Frequently Asked Questions

Where is the settings page?

You can stop looking, there is none. You can adjust all the necessary settings in the widget itself.

A few settings are done by default: the scale of the image is set to 2, to optimize it for mobile resolutions and the link opens in a new tab.

Please note that the zoom, width and height parameters take a numerical value only.

After adding the widget, why does it show some place in the middle of the North Atlantic Ocean?

The widget takes default settings, so what better location to choose than the very spot we operate from? Just replace the default setting with the address (or the coordinates) of the location you wish to add. The same goes for the other default values of the widget.

Do I need a Google Static Maps API-key?

The Google Static Maps API-key is mandatory, get it at Google Map APIs. Since July 16, 2018 a valid credit card is required by Google to sign up for the API-key

Nothing shows on the frontend

Did you enter a valid Google Static Maps API-key? Since July 16, 2018 a valid credit card is required by Google to sign up for the API-key Make sure to go through all the settings, because to be honest Google is not making it very easy to add the key and validate it properly...

Where can I sign up for the Google Static Maps API-key?

See above.

I cannot display a map larger than 640 x 640 pixels

That is a limit Google has put on the use of Static Maps images:

Static Maps images can be returned in any size up to 640 x 640 pixels.

When I use the Customizer to add the Mobile Map Widget I am seeing a lot of PHP Notices or nothing at all. What's wrong?

This only happens if you have not yet added the Google Static Maps API Key. You will need to generate a new API key and add it to the widget settings. Once you have, the widget will automatically auto-refresh (WP 4.5 and above) and you will now see a map instead.



Connect with me through

BHI Localization for Websites


WP Tips






  • November 1, 2018
  • fix deprecated function to register the widget
  • version: 20182.4.2


  • October 29, 2018
  • change link to find coordinates
  • add details new Google API requirements
  • edit readme files with new FAQ entries among others
  • change some links due to renewal SO WP website
  • clean up irrelevant screenshots
  • add new screenshots
  • verified compatibility WP 5.0


  • June 1, 2017
  • change default location and pin color
  • clean up tabs and spaces
  • remove redundant language files
  • verified compatibility WP 4.8


  • April 12, 2017
  • change http links to https, props @senatorman


  • November 29, 2016
  • fix typo in settings that link to help map to get coordinates
  • update URL to help map
  • remove version check
  • tested up to WP 4.7


  • March 31, 2016
  • implement selective refresh support for Customizer (WP 4.5 feature)
  • adjust FAQ
  • bump minimum required WP version up to 4.2


  • July 7, 2015
  • in WP 4.3 PHP 4 style constructors are deprecated, the plugin contained such a constructor, therefore replaced with PHP 5 style constructor




  • Change input type to number for zoom, width and height to address issue #2 and adjust FAQ
  • Add format=jpg to map parameters to allow for the smallest size and progressive loading of the image
  • Fix typo textdomain function
  • Move minimum required WP version up to 3.7


  • Made sure that Widget Preview (WP 3.9 feature) works for the plugin


  • Tested up to WP 3.9-alpha
  • Change format version numbers
  • Add widget default values to get rid of undefined index error




  • added optional description field


  • release version


Preview of the widget in the backend and on the frontend.

Widget Settings in the WordPress backend.

The widget showing the Google Static Map Image of your destination (frontend).


This WordPress widget adds a mobile-optimised Google Static Map Image with a colored pin centered on a destination of your choosing.






No packages published