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; addlayers="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_htmlfilter, and each map dispatches akml-places-map:readyevent 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






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
- Install and activate the plugin.
- Add places under Places, or import a KML or KMZ file under Places Import.
- 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
TimeStampor the start of aTimeSpan); 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_htmlfilter to return your own markup for a layer, and style it with CSS. The markup may usespan, inline SVG (svg,g,use,path,circle) andimg; 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.
ContributorsTranslate “KML Places Map” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by 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 thekml_places_map_import_doneaction 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
TimeStamporTimeSpanas its date. create_place()takes an optionaldate.
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:readyevent also passes the map’s shapes and its marker cluster group.
1.0.0
- First release.
