Improvements

Geocoder

• Allow setting "locale" and "region" based on current PHP locale.

CakePHP 3.4+ release

It now requires CakePHP 3.4+ - upgrade if you haven't yet!

Improvements

• Added Google maps key for static maps if applicable.
• Added new styles option for GoogleMapHelper dynamic maps ( see https://snazzymaps.com/ ).

Fixes

• Fixed return types and annotations for GeocoderBehavior and alike.

The escaping wasn't always working out. Some methods double escaped.
This is now fixed, and the documentation is also improved incl some examples for custom HtmlHelper::link() calls.

Improvements

Since 2016 the API key is required for the map to function.
This adds this.

It also cleans up merging of the configs and resetting per map:

• Defaults are set up on helper instantiation based on dynamic options passed, Configure and defaults.
• Each map() call resets to those defaults.

Finally it more safely generates HTML links and URLs to be outputted. The query strings so far could contain XSS vulnerable strings. Those are now properly encoded by default.

Cleanup

Sensor config is deprecated and has been removed.

A BC break is in the apiUrl() call:

• The sensor argument as well as the others have been removed. It now uses an options array as argument.

This will only effect you if

• you are not using autoScript true
• you are not using the helper configs for setting the apiUrl options (if you pass arguments here)

An exception will inform you here about the issue. Please refactor that method usage.

It merges default configs as expected now for GoogleMap helper.

And documentation updates.

The main differences to the 2.x version are:

It internally uses a large FOSS lib willdurand/geocoder and therefore now supports

• 12+ address-based Geocoder providers
• 10+ IP-based Geocoder providers
• 1 own IP based (free) Geocoder provider

Most of them also support reverse geocoding. And of course you can write your own providers on top.

Also new:

• MySQL support
• PostgreSQL support

And also:

• GeocodedAddresses Table class for caching of API requests to prevent rate limits and speed up lookups.

The development branch will soon be merged, thus you need to switch to this tag now if you are using master branch.