Title: KML Places Map
Author: siaccslv
Published: <strong>November 12, 2026</strong>
Last modified: November 17, 2026

---

Search plugins

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

![](https://ps.w.org/kml-places-map/assets/icon.svg?rev=3797620)

# KML Places Map

 By [siaccslv](https://profiles.wordpress.org/siaccslv/)

[Download](https://downloads.wordpress.org/plugin/kml-places-map.1.3.0.zip)

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

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

## Description

KML Places Map keeps your places as content in WordPress and draws them on a fast,
accessible map block. Bring them in from the map you already keep in Google My Maps,
or add them one by one.

Use it for any set of places worth showing on a map:

 * a travel blog’s “where we have been”, or the trips in a series of posts;
 * hiking trails, swimming spots, viewpoints or picnic places in a region;
 * historic sites, monuments or a walking tour;
 * a club’s or a company’s locations, branches or project sites;
 * the venues of a festival or an event series;
 * the work of a volunteer or a community group, such as every place cleaned up 
   or every tree planted.

What the plugin does:

 * **Import from KML or KMZ.** Upload an export from Google My Maps, Google Earth
   or any GIS tool. Points become pins, lines (such as trails or routes) and areas(
   such as parks or districts) are drawn in their layer’s colour, each folder in
   the file becomes a layer, and descriptions become notes. A place already on the
   map at the same coordinates, or the same line or area, is not added twice, so
   you can re-import an updated export at any time.
 * **Places as content.** Every place is an entry with a name, coordinates, a note,
   and an optional date, photo and link, editable under Places. Set the location
   on a map in the editor: search for a place by name, click the spot or drag the
   pin, or paste coordinates from Google Maps. Places already on the map are shown
   faintly, so the same spot is not added twice.
 * **Layers with colours and a legend.** Group places into layers, give each a marker
   colour, and show a legend under the map. A map can show all layers or only some,
   and can let visitors hide and show layers from the legend.
 * **Places Map block.** Fits itself to your places or to an area you set, can be
   kept inside that area, animates markers in when the map scrolls into view, and
   can group nearby markers into one circle with a count until visitors zoom in.
   Popups show the photo, name, layer, date and note, and a link to read more, such
   as a post about the place.
 * **Places Count block and shortcode.** Shows how many places are on the map (a
   line or area counts as one), for headlines like “42 places visited”, and updates
   as you add them. The `[kml_places_map_count]` shortcode prints the same number
   inside a sentence; add `layers="slug,slug"` to count only some layers.
 * **Your choice of map tiles.** OpenStreetMap by default, or any tile provider 
   you set under Places  Settings.
 * **Made to be restyled.** Markers and colours come from CSS custom properties 
   and the `kml_places_map_marker_html` filter, and each map dispatches a `kml-places-
   map:ready` event with the Leaflet map for themes that want to add to it.

The map is drawn with Leaflet 1.9.4 (BSD-2-Clause) and groups markers with Leaflet.
markercluster 1.5.3 (MIT), both bundled with the plugin. Nothing is loaded from 
a CDN.

### External services

The map loads tile images from a tile server so visitors see streets and terrain
under the places. By default this is the OpenStreetMap tile server (https://tile.
openstreetmap.org). Each visitor’s browser requests the tiles for the part of the
map in view; the request carries the visitor’s IP address and browser details, as
any image request does. No place data is sent.

OpenStreetMap tile usage policy: https://operations.osmfoundation.org/policies/tiles/

OpenStreetMap privacy policy: https://osmfoundation.org/wiki/Privacy_Policy

You can point the map at another tile provider under Places  Settings; that provider’s
terms then apply.

The search on a place’s edit screen uses a place search service to find a location
by name. By default this is OpenStreetMap Nominatim (https://nominatim.openstreetmap.
org). Only when an editor searches, your site, not the editor’s browser, sends the
search text and the admin language, with your site’s address as the referrer; answers
are cached for a week. Nothing is sent to it from the public pages.

Nominatim usage policy: https://operations.osmfoundation.org/policies/nominatim/

OpenStreetMap privacy policy: https://osmfoundation.org/wiki/Privacy_Policy

You can set another Nominatim-compatible service under Places  Settings; that service’s
terms then apply. The editor’s map on that screen loads tiles from the tile server
above.

## Screenshots

[⌊Viewpoints and historic sites in two layers, with a place's photo, note and link
in its popup.⌉⌊Viewpoints and historic sites in two layers, with a place's photo,
note and link in its popup.⌉[

Viewpoints and historic sites in two layers, with a place’s photo, note and link
in its popup.

[⌊A cleanup map where visitors hid one layer by clicking it in the legend.⌉⌊A cleanup
map where visitors hid one layer by clicking it in the legend.⌉[

A cleanup map where visitors hid one layer by clicking it in the legend.

[⌊Farm shops and markets, with the popup link text set to "Opening hours".⌉⌊Farm
shops and markets, with the popup link text set to "Opening hours".⌉[

Farm shops and markets, with the popup link text set to “Opening hours”.

[⌊Editing a place: search for it, click the map or drag the pin, and add a note,
a date, a link and a layer.⌉⌊Editing a place: search for it, click the map or drag
the pin, and add a note, a date, a link and a layer.⌉[

Editing a place: search for it, click the map or drag the pin, and add a note, a
date, a link and a layer.

[⌊Importing a KML or KMZ file exported from Google My Maps.⌉⌊Importing a KML or 
KMZ file exported from Google My Maps.⌉[

Importing a KML or KMZ file exported from Google My Maps.

[⌊Map settings: tiles, attribution, zoom and date format.⌉⌊Map settings: tiles, 
attribution, zoom and date format.⌉[

Map settings: tiles, attribution, zoom and date format.

## Blocks

This plugin provides 2 blocks.

 *   Places Count The number of places on the map, updated as places are added.
 *   Places Map An interactive map of your places, lines and areas, with a legend
   for each layer.

## Installation

 1. Install and activate the plugin.
 2. Add places under Places, or import a KML or KMZ file under Places  Import.
 3. Add the Places Map block to a page.

## FAQ

### How do I export my Google My Maps map?

Open the map, click the three dots next to its title, choose “Export to KML/KMZ”,
and upload the file under Places  Import.

### Can I import the same map again after adding places to it?

Yes. Places that are already on the map at the same coordinates, and lines and areas
that are already on it unchanged, are skipped, so only new ones are added.

### Which parts of a KML file are imported?

Points, lines (`LineString`) and areas (`Polygon`, including holes), also when several
are combined in one placemark (`MultiGeometry`). A line or area counts as one place,
in its layer’s colour, and opens the same popup as a pin. Its shape is changed by
editing it in the file and importing again. Google Earth GPS tracks and 3D models
are left out. Very long lines make the page heavier, as every point travels with
it.

### Where does the date in a popup come from?

From the place’s own Date field, picked from a calendar on its edit screen. It is
not the date the place was added, so an import does not stamp every place with the
same day. A place without a date shows none. An import fills the date only when 
the file gives one (a `TimeStamp` or the start of a `TimeSpan`); Google My Maps 
exports usually do not.

### Can a place link to a post about it?

Yes. Paste the post’s address into the place’s Link field. The popup then shows 
a link, labelled “Read more” or with the text you set on the map block. A featured
image on the place is shown at the top of its popup.

### Can another plugin add places?

Yes. `CommerceConsulting\KmlPlacesMap\create_place()` takes a title, coordinates,
a note, a link, a photo (attachment ID), a layer slug and a date (“Y-m-d”), and 
returns the new place’s ID. A place without coordinates is saved as a draft. `CommerceConsulting\
KmlPlacesMap\layer_names()` lists the layers as slug => name. Report a Place uses
these to put resolved reports on the map.

    ```
    CommerceConsulting\KmlPlacesMap\parse_kml() reads the placemarks of a KML or KMZ file (name, coordinates, line or area, folder, date, description and ExtendedData) without adding anything, and the `kml_places_map_import_done` action passes the IDs of the places an import added.
    ```

### Can I use my own marker?

Yes. Use the `kml_places_map_marker_html` filter to return your own markup for a
layer, and style it with CSS. The markup may use `span`, inline SVG (`svg`, `g`,`
use`, `path`, `circle`) and `img`; anything else is removed.

### What does maximum zoom mean?

It is how close visitors can zoom in on the map, set under Places  Settings. Each
zoom level shows half the width of the one before it, so every step doubles the 
detail.

 * 0 to 2: the whole world. Continents and oceans.
 * 3 to 4: a continent or a large region, such as Western Europe, the eastern United
   States or Southeast Asia.
 * 5 to 6: a large country or a group of smaller ones, such as France, Japan or 
   Texas.
 * 7 to 8: a small country or a state or province, with its main cities and highways.
 * 9 to 10: a metropolitan area, a city and the towns around it.
 * 11 to 12: a single city or town, with its outline, main roads, rivers and large
   parks.
 * 13 to 14: districts and neighbourhoods, with most street names.
 * 15 to 16: every street, city blocks, small parks and bus stops.
 * 17 to 18: individual buildings, house numbers, footpaths and the exact stretch
   of a beach or riverbank.
 * 19: single buildings and yards, the closest the standard OpenStreetMap tiles 
   go. Some tile providers go further, up to 22.

The default, 18, lets visitors see exactly which spot a place marks. Set it lower
if your tile provider stops at a lower level (beyond that the map shows grey, empty
squares), or if your places are whole towns and street-level detail adds nothing.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

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

Contributors

 *   [ siaccslv ](https://profiles.wordpress.org/siaccslv/)

[Translate “KML Places Map” into your language.](https://translate.wordpress.org/projects/wp-plugins/kml-places-map)

### Interested in development?

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

## Changelog

#### 1.3.0

 * `[kml_places_map_count]` shortcode: the number of places, inline in a sentence,
   optionally for some layers only.
 * For developers: `parse_kml()` reads a KML or KMZ file without importing it, and
   the `kml_places_map_import_done` action fires after an import with the IDs of
   the places it added.

#### 1.2.2

 * Latvian: Trash is called “atkritne”, as in WordPress.

#### 1.2.1

 * Admin notices speak of places: “Place updated.”, “3 places moved to the Trash.”
   and so on, instead of “Post”.

#### 1.2.0

 * Each place has its own optional date, picked from a calendar on its edit screen.
   Popups show that date, or none when it is empty, instead of the date the place
   was added. Existing places start without a date.
 * Import reads a placemark’s `TimeStamp` or `TimeSpan` as its date.
 * `create_place()` takes an optional `date`.

#### 1.1.0

 * Import lines and areas from KML and KMZ files, drawn in their layer’s colour,
   with popups and legend toggles like pins.
 * Places Map block: “Group nearby markers” shows close markers as one circle with
   a count until visitors zoom in.
 * The `kml-places-map:ready` event also passes the map’s shapes and its marker 
   cluster group.

#### 1.0.0

 * First release.

## Meta

 *  Version **1.3.0**
 *  Last updated **3 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 8.1 or higher **
 * Tags
 * [kml](https://wordpress.org/plugins/tags/kml/)[leaflet](https://wordpress.org/plugins/tags/leaflet/)
   [map](https://wordpress.org/plugins/tags/map/)[places](https://wordpress.org/plugins/tags/places/)
 *  [Advanced View](https://wordpress.org/plugins/kml-places-map/advanced/)

## Ratings

No reviews have been submitted yet.

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

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

## Contributors

 *   [ siaccslv ](https://profiles.wordpress.org/siaccslv/)

## Support

Got something to say? Need help?

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