Google Maps

This update runs a significant migration, which may notably increase the size of the googlemaps_addresses table for multisite projects. Please ensure that you have backed up the database before performing this migration.

Added

• Added multisite support. (#11)
• Added infoWindowData option.
• 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.

Added

• Added an ACF adapter for Google Map fields. (thanks @brandonkelly)

Fixed

• Fixed utility icons.

Fixed

• Patched bug caused by malformed subfield config.

The default proximity search range has been changed from 500 to null (no distance limit). Proximity searches relying on the default value might now include additional results. If a maximum range is required, specify it manually.

Changed

• Dropped the default range value. (#68)
• Requires non-beta version of Craft 5.
• Determined stable on Craft 5.

Added

• Added a fieldtype icon.

Fixed

• Fixed drag & drop bug in subfield config manager.
• Fixed proximity search bug introduced in Craft 5 beta. (#107)

Changed

• Craft 5 compatibility.

Added

• Added an event for plugins/modules to define search keywords. (#108)

Fixed

• Added a null check when compiling search keywords. (#108)

Added

• Addresses now include an optional neighborhood subfield. (#44)
• Addresses now include an optional countryCode subfield. (#104)

Changed

• isEmpty and multiline methods now respect whether a subfield is visible. (#82)

Changed

• Pinned API version to avoid deprecation warnings. (#106)

Changed

• Improved support for collections.

Changed

• Improved support for collections.
• Restores a required minimum of Craft 4.0.0.

Added

• Added support for element collections.

Changed

• Marked Address field as compatible with the Mapbox plugin.
• Now requires a minimum of Craft 4.5.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.

Changed

• Added cache-busting to the Google Maps API URL to prevent a rare map loading error. (#92)

Fixed

• Fixed a bug which caused subfields to be omitted from "Addresses (expanded)" exports. (#91)
• Partially fixed a conflict between clustering and info windows. (#95)

Fixed

• Improved backwards-compatibility of dynamic maps JavaScript. (#85)
• Removed explicit check for MaxMind’s location value. (#87)
• Patched minor migration bug which could occur with errant field data.

Fixed

• Fixed bug which occurred when using multiple Address fields inside a Matrix field. (#80)

Changed

• When validation fails, only highlight the invalid subfields. (#77)

Fixed

• Fixed subfield validation bug.
• Fixed slideout bug. (#69)
• Fixed Matrix bug. (#74)
• Fixed NaN console warning.

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.

Fixed

• Fixed bug in migration to 4.3.0. (thanks @bencroker)

Added

• Added support for using an Address in GraphQL.
• Added support for reverse proximity searches.
• Added support for drawing circles on a map.
• Added hideCircle universal method.
• Added showCircle universal method.
• Added getCircle JavaScript 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 styles option 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)

If using Sprig, enable the inline option in the Twig/PHP tag method.

Added

• Added a new inline option for the Twig/PHP tag method.

Changed

• JavaScript will no longer be injected inline automatically when Sprig is installed.

Changed

• All required JavaScript assets now load with defer attribute. (#61)

Fixed

• Fixed a minor conflict from recent clustering changes.

Fixed

• Load JavaScript inline when using Sprig. (#52)

Fixed

• Fixed bug affecting zoom level of a single marker. (#53)

Fixed

• Fixed typecasting of event parameters. (#54)

Added

• Craft 4 compatibility.

Fixed

• Allow range to be a float between 0 and 1.

Fixed

• Fixed minor bug in JavaScript tag method.

Changed

• Prevents the name subfield from being just a copy of street1 subfield.
• 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.

Fixed

• Fixed info window regression. (#48)
• Fixed markerClick regression. (#49)
• Improved messaging regarding "Required" subfields and coordinates. (#47)

Changed

• Refactored how info windows are loaded.

Added

• Address subfields & coordinates can now be marked as required. (#3)
• Added getZoom JavaScript method. (#35)
• Added getCenter JavaScript method. (#35)
• Added getBounds JavaScript method. (#35)

Added

• Allow multiple subfields to perform Autocomplete. (#42)

Fixed

• Fixed conflict between clustering and info windows.

Added

• The setMarkerIcon method now accepts an array of IDs to set an icon for multiple markers at the same time.
• The setMarkerIcon method now accepts * to set an icon for all markers at the same time.
• The hideMarker method now accepts an array of IDs to hide multiple markers at the same time.
• The showMarker method now accepts an array of IDs to show multiple markers at the same time.
• The openInfoWindow method now accepts an array of IDs to open multiple info windows at the same time.
• The openInfoWindow method now accepts * to open all info windows at the same time.
• Added closeInfoWindow method, which accepts an ID, an array of IDs, or * to close multiple info windows.
• The hideKml method now accepts an array of IDs to hide multiple KML layers at the same time.
• The showKml method 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 api option, replaced with params option.

Fixed

• Fixed JavaScript chaining bug.

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)

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 name subfield. (#26)
• Addresses now include an optional county subfield.
• Addresses now include an optional placeId subfield. (#25)
• The hideMarker method now accepts * to hide all markers at the same time. (#39)
• The showMarker method now accepts * to show all markers at the same time.
• The hideKml method now accepts * to hide all KML Layers at the same time.
• The showKml method now accepts * to show all KML Layers at the same time.
• Added markerLink option for dynamic map markers. (#34)
• Added markerClick option 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 fit method to more accurately reflect visible markers.
• Renamed getMarkerCluster JavaScript method to getMarkerClusterer for accuracy.

Added

• Added cluster option to easily cluster map markers. (#9)
• Added getMarkerCluster JavaScript method. (#9)
• Added openInfoWindow universal method. (#10)

Added

• Added hideKml universal method. (#24)
• Added showKml universal method. (#24)
• Added getKml JavaScript method. (#24)

Changed

• Ensure static map marker options are set as strings. (#29)

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.

Fixed

• Reverted field alias, to be reinstated with upcoming Craft release.

Changed

• Improved error handling on the Visitor Model.
• Added an alias for the legacy fieldtype.

Fixed

• Fixed a bug occurring with a null target value.

Added

• Added exporters to handle Address data. (#4)

Changed

• Allow Address field map to stay open if the field already contains coordinates.

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)

Added

• Added fieldControlSize setting to control the UI size for Address fields. (#19)
• Added fieldParams setting to adjust the API URL for Address fields. (#18)

Added

• Added full support for Matrix, Neo, and Super Table fields. (#1)

Changed

• Improved IP autodetection for visitor geolocation.

Fixed

• Fixed normalization bug when handling an Address Model. (#6)
• Be more defensive against unavailable coordinates.

Added

• Added api option to Twig/PHP tag method.
• Added assets option to Twig/PHP tag method.
• Added callback option to Twig/PHP tag method.

Added

• Added getInfoWindow JavaScript method.

Fixed

• Fixed overlap between the field handle div and the map's toggle text/icon. (#7)

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...