Download the PHP package goldfinch/silverstripe-googlemapfield without Composer
On this page you can find all versions of the php package goldfinch/silverstripe-googlemapfield. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download goldfinch/silverstripe-googlemapfield
More information about goldfinch/silverstripe-googlemapfield
Files in goldfinch/silverstripe-googlemapfield
Package silverstripe-googlemapfield
Short Description Save locations using latitude/longitude DataObject fields.
License BSD-3-Clause
Homepage http://github.com/goldfinch/googlemapfield
Informations about the package silverstripe-googlemapfield
silverstripe-googlemapfield
- SS5 compatible fork of BetterBrief/silverstripe-googlemapfield
Lets you record a precise location using latitude/longitude/zoom fields to a DataObject.
Displays a map using the Google Maps API. The user may then choose where to place the marker; the landing coordinates are then saved.
You can also search for locations using the search box, which uses the Google Maps Geocoding API.
Supports SilverStripe 5
Usage
Minimal configuration
Given your DataObject uses the field names Latitude
and Longitude
for storing the latitude and longitude
respectively then the following is a minimal setup to have the map show in the CMS:
Remember to set your API key in your site's config.yml
or through .env
Optional configuration
Configuration options
You can either set the default options in your yaml file (see _config/googlemapfield.yml
for a complete list) or at run time on each instance of the GoogleMapField
object.
Setting at run time
To set options at run time pass through an array of options (3rd construct parameter):
Customising the map appearance
You can customise the map's appearance by passing through settings into the map
key of the $options
(shown above).
The map
settings take a literal representation of the google.maps.MapOptions
For example if we wanted to change the map type from a road map to satellite imagery we could do the following:
Getting an API key
Google Maps API key
To get a Google Maps JS API key please see the official docs
Geocoding access - enabling the search box
To use the search box to find locations on the map, you'll need to have enabled the Geocoding API as well. Please see the official docs