Title: Yatmo Neighbourhood Map
Author: Yatmo SRL
Published: <strong>December 29, 2023</strong>
Last modified: September 30, 2026

---

Search plugins

![](https://ps.w.org/yatmo-map/assets/banner-772x250.png?rev=3721770)

![](https://ps.w.org/yatmo-map/assets/icon-256x256.png?rev=3721770)

# Yatmo Neighbourhood Map

 By [Yatmo SRL](https://profiles.wordpress.org/yatmo/)

[Download](https://downloads.wordpress.org/plugin/yatmo-map.2.0.0.zip)

 * [Details](https://srd.wordpress.org/plugins/yatmo-map/#description)
 * [Reviews](https://srd.wordpress.org/plugins/yatmo-map/#reviews)
 *  [Installation](https://srd.wordpress.org/plugins/yatmo-map/#installation)
 * [Development](https://srd.wordpress.org/plugins/yatmo-map/#developers)

 [Support](https://wordpress.org/support/plugin/yatmo-map/)

## Description

Yatmo gives real estate websites neighbourhood intelligence: schools, shops, public
transport, healthcare and more around each property, with real travel times on foot,
by bike, by car and by public transport, and a written summary of the area.

This plugin brings Yatmo to your property pages with two blocks, also available 
as shortcodes:

 * **Yatmo Neighbourhood Map**: the interactive Yatmo widget (map, places, travel
   times, summary). You choose the layout and the look in the block sidebar; the
   plugin builds the embed, so there is no URL to write and no JavaScript to add
   to your theme.
 * **Yatmo Neighbourhood Text**: a written description of the neighbourhood (schools,
   shops, public transport, roads, leisure, nearby cities), inserted in the page
   as ordinary headings and paragraphs, so search engines and AI assistants read
   it as part of your listing.

**A Yatmo licence key is required.** Yatmo is a paid service for real estate portals,
agency networks and developers. [Contact us](https://yatmo.com) to get a key; the
plugin displays nothing to visitors until a key is entered.

#### Features

 * **Block editor**: “Yatmo Neighbourhood Map” and “Yatmo Neighbourhood Text” blocks
   with a live preview and all options in the sidebar.
 * **Shortcodes** `[yatmo-map]` and `[yatmo-text]` for the classic editor, page 
   builders and PHP templates.
 * **Indexable text**: rendered on your server, cached, styled by your theme; choose
   the paragraphs and the heading level, and hide the street name for discreet listings.
 * **Listing templates**: point the plugin to the custom fields where your theme
   or listing plugin stores the property coordinates, and one block in the template
   serves every property.
 * **Six layouts**: map with summary, map with Yatmo scores, map above the summary,
   map only, summary only, summary in tabs.
 * **Discreet location**: show a circle instead of a pin when the exact address 
   must stay private.
 * **Isochrones and routes**: areas reachable in 5, 10 and 20 minutes, and the route
   from the property to any place the visitor clicks.
 * **Favourite addresses**: logged-in visitors save their home or office and see
   their own commute from every property.
 * **Multilingual**: 23 languages; by default the widget follows the language of
   the page, including with WPML and Polylang.
 * **Cookieless and lightweight**: one lazy-loaded iframe for the map, plain HTML
   for the text, no script or style added to your pages.

#### Countries

Albania, Australia, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Canada, 
Croatia, Cyprus, France, Germany, Greece, Ireland, Italy, Luxembourg, Malta, Montenegro,
Morocco, the Netherlands, Portugal, Serbia, Slovenia, Spain, Switzerland and the
United Kingdom.

#### External services

This plugin relies on Yatmo, a third-party service operated by Yatmo SRL, to display
its content and to locate addresses.

 * **Yatmo widget** (`https://map.yatmo.com/plugin.html`): every page with a Yatmo
   block or shortcode embeds this page in an iframe. The visitor’s browser loads
   it, with your licence key, the country, the language, the display options and
   the property coordinates. The widget itself then loads the map, the points of
   interest and the travel times from Yatmo servers. When favourite addresses are
   enabled, it also receives an anonymous identifier of the logged-in visitor (a
   hash of the WordPress user id, which Yatmo cannot turn back into the user) and
   the addresses that visitor saves.
 * **Yatmo neighbourhood text** (`https://<country>.yatmo.com/Summary/text`): for
   each property shown with the text block or shortcode, your server sends the property
   coordinates and your licence key, and stores the returned text for 30 days.
 * **Yatmo geocoder** (`https://<country>.yatmo.com/Geolocation`, for example `https://
   be.yatmo.com/Geolocation`): when a block or shortcode is given an address instead
   of coordinates, your server sends that address, the country and your licence 
   key once, and stores the result for 90 days.

Yatmo sets no cookies. [Terms of service](https://yatmo.com/terms), [privacy policy](https://yatmo.com/privacy).

## Screenshots

[⌊Map and neighbourhood summary on a property page.⌉⌊Map and neighbourhood summary
on a property page.⌉[

Map and neighbourhood summary on a property page.

[⌊The block and its settings in the block editor.⌉⌊The block and its settings in
the block editor.⌉[

The block and its settings in the block editor.

[⌊Summary in tabs, without the map.⌉⌊Summary in tabs, without the map.⌉[

Summary in tabs, without the map.

[⌊Circle instead of a pin, with isochrones.⌉⌊Circle instead of a pin, with isochrones
.⌉[

Circle instead of a pin, with isochrones.

[⌊The settings page.⌉⌊The settings page.⌉[

The settings page.

[⌊The neighbourhood text on a property page.⌉⌊The neighbourhood text on a property
page.⌉[

The neighbourhood text on a property page.

## Blocks

This plugin provides 2 blocks.

 *   Yatmo Neighbourhood Map Map, points of interest, travel times and neighbourhood
   summary around a property.
 *   Yatmo Neighbourhood Text Written description of the neighbourhood of a property(
   schools, shops, transport), indexed by search engines.

## Installation

 1. Install the plugin from Plugins > Add New, or upload the `yatmo-map` folder to `/
    wp-content/plugins/`, then activate it.
 2. Go to Settings > Yatmo Map, enter your Yatmo licence key and choose your country
    and default look.
 3. Add the “Yatmo Neighbourhood Map” block to a page, or the `[yatmo-map]` shortcode,
    and give it an address or coordinates.

For listing templates, fill in the latitude and longitude custom fields in Settings
> Yatmo Map and leave the location of the block empty: each property then shows 
its own neighbourhood.

## FAQ

### Where do I get a licence key?

From Yatmo: [yatmo.com](https://yatmo.com). Use your frontend key, the one locked
to your domains, never your backend key.

### Which shortcode attributes are available?

All are optional; anything left out uses the settings page.

 * `address`, or `latitude` and `longitude`
 * `country` (BE, FR, UK…), `language` (EN, FR, NL…)
 * `mode`: `overlay`, `overlay-scores`, `map-top`, `map`, `summary`, `summary-tabs`
 * `height` (`560` or `70vh`), `zoom` (7 to 20), `map_style` (1 to 7), `rounded`(
   0 to 15)
 * `marker`: `pin`, `circle` (with `circle_radius` in metres, 50 to 2000) or `custom`(
   with `custom_marker_url`, `custom_marker_width`, `custom_marker_height`)
 * `accent_color`, `summary_background_color`, `summary_line_color` (hex colours)
 * `isochrone` and `route_from`: `left`, `right` or `off`; `route_from` also accepts`
   popup`
 * `title`: accessible title of the embed

Example: `[yatmo-map address="Rue de la Loi 16, 1000 Bruxelles" mode="map-top" marker
="circle" isochrone="right"]`

### And for the neighbourhood text?

[yatmo-text] takes the same `address`, `latitude`, `longitude`, `country` and `language`,
plus:

 * `paragraphs`: comma-separated among `education`, `shopping`, `publictransports`,`
   transports`, `tourism`, `cities`
 * `heading`: `h2` to `h6`
 * `street_in_title`, `city_in_title`: `1` or `0`

Example: `[yatmo-text address="Rue de la Loi 16, 1000 Bruxelles" paragraphs="education,
shopping,publictransports" heading="h3"]`

The text exists in the languages of the property’s country (French, Dutch and English
in Belgium, for example), otherwise in English.

### Can I use it in a theme template?

Yes: `<?php echo do_shortcode( '[yatmo-map]' ); ?>` with the custom fields set in
Settings > Yatmo Map. Developers can also supply the location with the `yatmo_map_location`
filter and adjust the embed with the `yatmo_map_iframe_params` filter.

### Is the text indexed by search engines?

The neighbourhood text is: it is part of your page’s HTML. The summary panel inside
the map widget is not, since the widget is an iframe; use both blocks together for
the best of both.

### I used the yatmo-text plugin

Its features are now in this plugin: deactivate and delete yatmo-text, keep your`[
yatmo-text]` shortcodes. `lat`, `lng`, `visibleparagraphs`, `showstreetnameintitle`
and `showplacenameintitle` still work; the `*nodetype` attributes are ignored (use`
heading`, and your theme for the style).

### I used version 1.x with [yatmo-marker]

Version 2 shows one property per embed. The `lat`, `lng`, `style` and `enable_isochrone`
attributes still work on `[yatmo-map]`; `[yatmo-marker]` is ignored (it prints nothing),
so give the location on `[yatmo-map]`.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Yatmo Neighbourhood Map” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Yatmo SRL ](https://profiles.wordpress.org/yatmo/)

[Translate “Yatmo Neighbourhood Map” into your language.](https://translate.wordpress.org/projects/wp-plugins/yatmo-map)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/yatmo-map/), check 
out the [SVN repository](https://plugins.svn.wordpress.org/yatmo-map/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/yatmo-map/) by [RSS](https://plugins.trac.wordpress.org/log/yatmo-map/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.0.0

 * Rebuilt around the Yatmo iframe widget: map, summary, scores, isochrones, routes
   and favourite addresses.
 * New “Yatmo Neighbourhood Map” block for the block editor.
 * Neighbourhood text (formerly the yatmo-text plugin): “Yatmo Neighbourhood Text”
   block and `[yatmo-text]` shortcode, rendered as indexable HTML.
 * Property coordinates read from custom fields, for listing templates.
 * Addresses located by the Yatmo geocoder instead of Nominatim.
 * A Yatmo licence key is now required.
 * Removed: multiple markers and marker popups.

#### 1.0.0

 * First version.

## Meta

 *  Version **2.0.0**
 *  Last updated **2 weeks ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.3 or higher **
 *  Tested up to **7.1.3**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/yatmo-map/)
 * Tags
 * [map](https://srd.wordpress.org/plugins/tags/map/)[property](https://srd.wordpress.org/plugins/tags/property/)
   [real-estate](https://srd.wordpress.org/plugins/tags/real-estate/)[seo](https://srd.wordpress.org/plugins/tags/seo/)
 *  [Advanced View](https://srd.wordpress.org/plugins/yatmo-map/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/yatmo-map/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/yatmo-map/reviews/)

## Contributors

 *   [ Yatmo SRL ](https://profiles.wordpress.org/yatmo/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/yatmo-map/)