Simple Shortcode for Google Maps


Simple to use, yet powerful, Google Maps plugin! Reviews say this is «Best Google Map Shortcode plugin».

Put a Google map on your WordPress posts and pages simply and easily with a shortcode. Straight forward and easy to use! Ideal for contact page maps, maps showing delivery areas and many other uses!

This plugin will enable a simple shortcode that you can use for embedding Google Maps in any WordPress post or page. The shortcode uses the WordPress HTTPS API and the Transients API for delivering cached Google maps with little to no impact on your site’s performance.

Maps are displayed with the [pw_map] shortcode:

[pw_map address="New York City" key="YOUR API KEY"]

Теперь Google требует, чтобы новые учетные записи использовали ключ API. Вы можете зарегистрировать бесплатный ключ API здесь.

You can have multiple map pins, simply add multiple addresses separated by semi-colon ;

[pw_map address="Statue of Liberty National Monument NYC;Empire State Building, New York, NY, USA" key="YOUR API KEY"]

All Shortcode Options


  • address — Description: The address you want pinned — Allowed values: any address that Google can find, multi addresses separated by ;
  • key — Description: Your Google Maps API Key — Allowed values: valid key
  • Optional ( with default values)

  • width — Description: sets the map width — Default: 100% — Allowed values: size in % or px
  • height — Description: sets the map height — Default: 400px — Allowed values: size in % or px
  • enablescrollwheel — Description: zooming on the map using a mouse scroll wheel — Default: true — Allowed values: true or false
  • zoom — Description: The initial Map zoom level — Default: 15 — Allowed values: Valid zoom values are numbers from zero up to the supported maximum zoom level
  • disablecontrols — Description: Enables/disables all default UI buttons. May be overridden individually. Does not disable the keyboard controls — Default: false — Allowed values: true or false
  • force — Description: disable caching of geocoding, only use this on test — Default: false — Allowed values: true or false
  • zoomcontrol — Description: display the Zoom +/- buttons — Default: true — Allowed values: true or false
  • nozoom — Description: fixes the zoom level by seeting min and max to the starting zoom — Default: false — Allowed values: true or false
  • gesturehandling — Description: This setting controls how the amp handles gestures on the map. — Default: auto — Allowed values:
    • «cooperative»: Scroll events and one-finger touch gestures scroll the page, and do not zoom or pan the map. Two-finger touch gestures pan and zoom the map. Scroll events with a ctrl key or ⌘ key pressed zoom the map. In this mode the map cooperates with the page.
    • «greedy»: All touch gestures and scroll events pan or zoom the map.
    • «none»: The map cannot be panned or zoomed by user gestures.
    • «auto»: Gesture handling is either cooperative or greedy, depending on whether the page is scrollable or in an iframe.
  • maptypeid — Description: Determines the initial map display type — Default: roadmap — Allowed values:
    • «roadmap»: This map type displays a normal street map.
    • «satellite»: This map type displays satellite images.
    • «hybrid»: This map type displays a transparent layer of major streets on satellite images.
    • «terrain»: This map type displays maps with physical features such as terrain and vegetation.


    Этот плагин предоставляет 1 блок.

    • Simple Google Maps Google Maps Block


    1. Активируйте плагин.
    2. Получить ключ API здесь.
    3. Добавление [pw_map address=»your address here» key=»YOUR API KEY»] к любой записе или странице.

    Часто задаваемые вопросы

    Могу ли я изменить ширину или высоту карты?

    Да, просто введите параметр ширины и высоты:

    [pw_map address="New York City" width="400px" height="200px" key="YOUR API KEY"]

    Вы также можете использовать проценты для высот:

    [pw_map address="New York City" width="50%" height="200px" key="YOUR API KEY"]

    Могу ли я отключить колесо прокрутки?

    Да, просто добавьте enablescrollwheel="false" к шорткоду карты.

    [pw_map address="New York City" enablescrollwheel="false" key="YOUR API KEY"]

    Могу ли я отключить элементы управления картой?

    Да, просто добавьте disablecontrols="true"к шорткоду.

    [pw_map address="New York City" disablecontrols="true" key="YOUR API KEY"]

    Как кэшируются карты?

    Maps are cached using the WordPress Transients API, which allows for very efficient and WordPress standard database-based caching.

    Каждый раз, когда вы показываете карту, указанный адрес используется для создания уникального хэша md5, который используется для идентификатора кэша. Это означает, что если вы измените адрес, используемый для карты, кэш будет обновлен.

    For testing ONLY if you want to not use the cache then specify force=true


    [pw_map address="New York City" force="true" key="YOUR API KEY"]

    Как часто обновляется кэш?

    Карты кэшируются в течение 3 месяцев. Кэши автоматически очищаются (для отдельных карт) при изменении адреса в шорткоде.

    Can I specify multiple pins?

    Yes simply separate addresses with a semi-colon ; the map will center on the first pin

    [pw_map address="New York City;New Jersey" zoom="8" key="YOUR API KEY"]

    How do I change the initial zoom?

    Initial zoom can be controlled with the shortcode option zoom= the default is zoom=15 use for instance zoom=10 to zoom out

    [pw_map address="New York City" zoom="8" key="YOUR API KEY"]

    Why do I get REQUEST_DENIED error?

    This is likely to be an issue with the authorization you granted to your API key see Google API REQUEST_DENIED troubleshooting

    It is recommended that you set an Application Restriction to restrict your API key from others using it.

    However restricting the referrer HTTP will cause this error ‘API keys with referer restrictions cannot be used with this API’, this is because the geoencoding is performed server side and cached server side, so there is no browser referrer.
    If you get this message change your restriction to IP addresses (web servers, cron jobs, etc.) using the IP address of your website.

    If you restrict your API key to specific APIs make sure you enable at least
    * Maps JavaScript API
    * Geocoding API

    Are there any filters for developers?

    For developer documentation on filters visit here


    14.09.2022 4 ответа
    This was exactly what I needed. I’m using my page title to set the location and couldn’t do it with any of the Maps that require you to set the location in the block. Those are great if you are putting a map on a page and the address will never change. I’m using this shortcode map on a page I’ve created as a template, thus every page created on that template has a different address, ie a different map. Of course it took some coding on my end to use the page title but much less than if I did this without the plugin. Much appreciated!!!
    Посмотреть все 45 отзывов

    Участники и разработчики

    «Simple Shortcode for Google Maps» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:


    «Simple Shortcode for Google Maps» переведён на 3 языка. Благодарим переводчиков за их работу.

    Перевести «Simple Shortcode for Google Maps» на ваш язык.

    Заинтересованы в разработке?

    Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

    Журнал изменений


    • allow . (dot) in addresses so coordinates can be used


    • add filters for developers
    • add option to disable zoom
    • remove special characters from address that can break Google

    Full Change History