Google Maps
Version 5.5.2
Fixed
- Fixed
getDistance()measuring to 0,0 when the target location has no coordinates. - Fixed the welcome screen icon on Craft Cloud.
Version 5.5.1
Changed
- The marker clustering library now ships with the plugin (pinned to 2.6.2), instead of loading from unpkg. (#137)
- Dynamic map JavaScript now loads through asset bundles, as recommended for Craft Cloud. (#143)
- The marker clustering library now only loads on pages where a map uses clustering.
Version 5.5.0
Added
- Added the
distanceBandproximity search option, for sorting nearby results by something other than distance. (#113) (thanks @Mosnar)
Fixed
- Fixed a bug where the multisite migration could fail when upgrading from 4.5.x or earlier, due to duplicate Address data. (#139) (thanks @DavidStrada)
- Fixed a bug where the multisite migration could fail on Postgres when upgrading from 4.5.x or earlier.
- Fixed a bug where upgrading from 4.5.x or earlier could leave Address data on only one site of a multisite install.
- Fixed a bug where a marker icon could carry over to markers added later on the same map.
Version 5.4.0
Enable the new
loadApiAsyncsetting to clear the "loaded directly without loading=async" console warning.This setting will be permanently enabled when Google Maps v6.0 is eventually released.
For future-proofing (or if you enable the setting now), wrap any custom JS using
google.mapsingoogleMaps.ready().
Added
- Added a
loadApiAsyncsetting, to load the Google Maps API asynchronously. (#117) - Added the
googleMaps.ready()JavaScript method. - Added GeoJSON layers to dynamic maps.
- Added GPX tracks to dynamic maps.
- Added ground overlays to dynamic maps.
- Added datasets and boundaries to dynamic maps (requires a vector Map ID).
- Added support for KMZ files in KML layers.
Changed
- The
googleMaps.init()JavaScript method now returns a promise. - The
getKml()JavaScript method now returns agoogle.maps.Dataobject. - The
fit()method now includes visible KML, GeoJSON, and GPX layers and ground overlays. - KML files on another domain now need CORS headers (or a copy hosted on your own site).
Fixed
- Fixed KML layers, which stopped working in version 3.66 of the Google Maps API. (#157)
- Fixed a bug where
kmlLayerOptionswere ignored. - Fixed a bug where chaining
center()in Twig or PHP centered the map at 0,0.
Version 5.3.0
Added
- Added support for Places API (New) in Address field autocompletion. (#140)
- Added a check for every required Google API to the "Test Google API Keys" utility.
Changed
- Sites still using the legacy Places API will now see a deprecation warning.
- Improved accessibility of the "Test Google API Keys" utility.
Version 5.2.4
Fixed
- Fixed a bug which prevented saving coordinates from Live Preview. (#144)
- Fixed a bug where choosing an Autocomplete suggestion could leave the full address in the street subfield. (#41)
- Fixed a SQL error when counting the results of a proximity search. (#115)
- Fixed a bug with proximity searches when an address is located exactly at the target.
- Fixed a bug where proximity searches could miss results when different Address fields share the same handle.
- Fixed a bug where reverse radius searches could miss results across multiple field layouts.
- Fixed a bug where counting or paginating proximity search results ignored the range on Postgres.
- Fixed a bug where a proximity search which failed could also break the next query.
Version 5.2.3
Added
- Added a PHPUnit test suite.
Changed
- Removed the obsolete Codeception test suite.
Fixed
- Restored Address field values which were not being saved (
formatted,raw,name,neighborhood,county, andplaceId). (#158) - Fixed a missing import in an asset bundle.
Version 5.2.2
Fixed
- Restored the "Map/Satellite" buttons on Address field maps. (#156)
Version 5.2.1
Added
- Added check for malformed content.
Version 5.2.0
Changed
- Progressively enhanced Address fields (loads everything via Twig, then hydrates with Vue).
Fixed
Version 5.1.6
Fixed
- Fixed compatibility issue with Craft Cloud. (#121) (thanks @timkelty)
Version 5.1.4
Added
- Added
cameraControlOptionsdefinition.
Version 5.1.1
Added
- Added formatted address to geocoding lookup results.
Fixed
- Patched bug in multisite migration. (#127)
- Nullify raw
[object Object]values.
Version 5.1.0
This update runs a significant migration, which may notably increase the size of the
googlemaps_addressestable for multisite projects. Please ensure that you have backed up the database before performing this migration.
Added
- Added multisite support. (#11)
- Added
infoWindowDataoption. - Added ability to convert Address fields from the Ether Maps plugin.
Fixed
- Fixed bug in “Test Address Lookup” utility.
- Fixed small centering bugs in dynamic maps.
Version 5.0.3
Added
- Added an ACF adapter for Google Map fields. (thanks @brandonkelly)
Version 5.0.2
Fixed
- Fixed utility icons.
Version 5.0.1
Fixed
- Patched bug caused by malformed subfield config.
Version 5.0.0
The default proximity search
rangehas been changed from500tonull(no distance limit). Proximity searches relying on the default value might now include additional results. If a maximumrangeis required, specify it manually.
Changed
- Dropped the default
rangevalue. (#68) - Requires non-beta version of Craft 5.
- Determined stable on Craft 5.
Version 5.0.0-beta.2
Added
- Added a fieldtype icon.
Fixed
- Fixed drag & drop bug in subfield config manager.
- Fixed proximity search bug introduced in Craft 5 beta. (#107)
Version 5.0.0-beta.1
Changed
- Craft 5 compatibility.
Version 4.5.0
Added
- Addresses now include an optional
neighborhoodsubfield. (#44) - Addresses now include an optional
countryCodesubfield. (#104)
Changed
isEmptyandmultilinemethods now respect whether a subfield is visible. (#82)
Version 4.4.0
Changed
- Pinned API version to avoid deprecation warnings. (#106)
Version 4.3.11
Changed
- Improved support for collections.
Version 4.3.10
Changed
- Improved support for collections.
- Restores a required minimum of Craft 4.0.0.
Version 4.3.9
Added
- Added support for element collections.
Version 4.3.8
Changed
- Marked Address field as compatible with the Mapbox plugin.
- Now requires a minimum of Craft 4.5.7.
Version 4.3.7
Added
- Address fields can now be added to the search index. (#21)
- Optionally use minified JavaScript files for dynamic maps on the front-end. (#98)
- Added ability to convert Address fields from the Mapbox plugin.
Version 4.3.4
Fixed
- Fixed bug which occurred when using multiple Address fields inside a Matrix field. (#80)
Version 4.3.2
Added
- Added a utility for testing the Google API keys. (#8)
- Added a utility for testing an address lookup.
Fixed
- Improved coupling of marker IDs and info window IDs.
Version 4.3.1
Fixed
- Fixed bug in migration to
4.3.0. (thanks @bencroker)
Version 4.3.0
Added
- Added support for using an Address in GraphQL.
- Added support for reverse proximity searches.
- Added support for drawing circles on a map.
- Added
hideCircleuniversal method. - Added
showCircleuniversal method. - Added
getCircleJavaScript method.
Changed
- Completely refactored how Vue powers the Address field. Now updated to use Vue 3 and Pinia.
Fixed
- Set a default noop callback to prevent a Google Maps API console error.
- Fixed
stylesoption for static maps. (#70) - Fixed minor bug in migration from Smart Map. (thanks @bencroker)
- Fixed bug which occurred when "Geolocation Service" was set to "None". (#72)
- Fixed a bug which prevented multiple maps from having info windows at the same time.
- Removed an old symlink which could cause conflicts with
rsync. (#63)
Version 4.2.5
If using Sprig, enable the
inlineoption in the Twig/PHPtagmethod.
Added
- Added a new
inlineoption for the Twig/PHPtagmethod.
Changed
- JavaScript will no longer be injected inline automatically when Sprig is installed.
Version 4.2.4
Changed
- All required JavaScript assets now load with
deferattribute. (#61)
Fixed
- Fixed a minor conflict from recent clustering changes.
Version 4.2.3
Fixed
- Load JavaScript inline when using Sprig. (#52)
Version 4.2.2
Fixed
- Fixed bug affecting zoom level of a single marker. (#53)
Version 4.2.1
Fixed
- Fixed typecasting of event parameters. (#54)
Version 4.2.0
Added
- Craft 4 compatibility.
Version 4.1.9
Fixed
- Allow
rangeto be a float between 0 and 1.
Version 4.1.8
Fixed
- Fixed minor bug in JavaScript
tagmethod.
Version 4.1.7
Changed
- Prevents the
namesubfield from being just a copy ofstreet1subfield. - Prevents the map from appearing as a grey box when zoom or center are missing.
- Changed the default zoom level to 11.
Fixed
- Actually fixed info window regression. (#49)
- Fixed a bug which occurs when getting coordinates from a custom Address model.
- Fixed a bug which occurs when using only a single Address model on a static map.
Version 4.1.5
Changed
- Refactored how info windows are loaded.
Version 4.1.3
Added
- Allow multiple subfields to perform Autocomplete. (#42)
Fixed
- Fixed conflict between clustering and info windows.
Version 4.1.2
Added
- The
setMarkerIconmethod now accepts an array of IDs to set an icon for multiple markers at the same time. - The
setMarkerIconmethod now accepts*to set an icon for all markers at the same time. - The
hideMarkermethod now accepts an array of IDs to hide multiple markers at the same time. - The
showMarkermethod now accepts an array of IDs to show multiple markers at the same time. - The
openInfoWindowmethod now accepts an array of IDs to open multiple info windows at the same time. - The
openInfoWindowmethod now accepts*to open all info windows at the same time. - Added
closeInfoWindowmethod, which accepts an ID, an array of IDs, or*to close multiple info windows. - The
hideKmlmethod now accepts an array of IDs to hide multiple KML layers at the same time. - The
showKmlmethod now accepts an array of IDs to show multiple KML layers at the same time.
Changed
- Improved JavaScript logging.
- Protect against invalid coordinates when centering.
- Deprecated
apioption, replaced withparamsoption.
Fixed
- Fixed JavaScript chaining bug.
Version 4.1.1
Changed
- Improved support for using Google Maps JavaScript API constants within Twig/PHP.
Fixed
- Fixed namespacing bug when an Address field is nested within a Matrix field. (#43)
Version 4.1.0
If you are using marker clustering, please be aware that the internal library has changed and your code may require minor adjustments as a result.
Added
- Addresses now include an optional
namesubfield. (#26) - Addresses now include an optional
countysubfield. - Addresses now include an optional
placeIdsubfield. (#25) - The
hideMarkermethod now accepts*to hide all markers at the same time. (#39) - The
showMarkermethod now accepts*to show all markers at the same time. - The
hideKmlmethod now accepts*to hide all KML Layers at the same time. - The
showKmlmethod now accepts*to show all KML Layers at the same time. - Added
markerLinkoption for dynamic map markers. (#34) - Added
markerClickoption for dynamic map markers. (#34) - Added a JS script and instructions for adding Google Places Autocomplete to front-end forms.
Changed
- Replaced deprecated MarkerClustererPlus library with newly recommended MarkerClusterer library.
- Improved autocompletion of Address fields by returning a broader set of results.
- Improved
fitmethod to more accurately reflect visible markers. - Renamed
getMarkerClusterJavaScript method togetMarkerClustererfor accuracy.
Version 4.0.11
Added
- Added
clusteroption to easily cluster map markers. (#9) - Added
getMarkerClusterJavaScript method. (#9) - Added
openInfoWindowuniversal method. (#10)
Version 4.0.9
Added
- On installation, migrates existing Smart Map license key (if available).
- Logs migration warning messages for recoverable issues.
Changed
- Requires a minimum of Craft 3.6.14.
Fixed
- Significantly improved stability of migration from Smart Map.
- Reinstated alias for the legacy fieldtype.
Version 4.0.8.1
Fixed
- Reverted field alias, to be reinstated with upcoming Craft release.
Version 4.0.8
Changed
- Improved error handling on the Visitor Model.
- Added an alias for the legacy fieldtype.
Fixed
- Fixed a bug occurring with a null
targetvalue.
Version 4.0.6
Added
- Added the subfield filter fallback mechanism for proximity searches. (#5)
Changed
- Improved error messaging for when a map ID conflicts with the ID of another DOM element. (#23)
Version 4.0.5
Added
- Added
fieldControlSizesetting to control the UI size for Address fields. (#19) - Added
fieldParamssetting to adjust the API URL for Address fields. (#18)
Version 4.0.4
Added
- Added full support for Matrix, Neo, and Super Table fields. (#1)
Version 4.0.3
Changed
- Improved IP autodetection for visitor geolocation.
Fixed
- Fixed normalization bug when handling an Address Model. (#6)
- Be more defensive against unavailable coordinates.
Version 4.0.1
Added
- Added
getInfoWindowJavaScript method.
Fixed
- Fixed overlap between the field handle div and the map's toggle text/icon. (#7)
Version 4.0.0
Added
- Everything.
This is the direct successor to the Smart Map plugin. Since the final version of Smart Map ended at 3.x, Google Maps begins with version 4.0. To replace Smart Map, simply install the Google Maps plugin. Your data will be migrated automatically.
For more information, please see the complete documentation...