silverware / google-maps
SilverWare Google Maps Module.
Installs: 48
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 0
Type:silverstripe-vendormodule
Requires
- php: >=5.6.0
- silverware/google: ^1.2
This package is not auto-updated.
Last update: 2024-10-25 16:47:03 UTC
README
Provides a Google Map component with customisable markers for use with SilverWare apps.
Contents
Requirements
Installation
Installation is via Composer:
$ composer require silverware/google-maps
Configuration
In order for the map component to work, you will need to create a Google API Key. The key can be entered either into
the SiteConfig
area of the CMS (in SilverWare settings), or you can define the API key using YAML config:
SilverWare\Google\API\GoogleAPI: api_key: '<paste-api-key-here>'
Usage
Google Map Component
This module provides a GoogleMapComponent
for use with your SilverWare app. The map component can be added to
your SilverWare templates, layouts or panels using the CMS. After creating a map, you'll need to define the latitude
and longitude to set the location for the map.
On the Style tab for the component, you may select Auto or Manual for the height mode. Auto mode will always maintain the map dimensions on any device or screen. Manual mode requires the pixel height of the map to be entered into the "Height manual" field. In manual mode, the map will always remain at the height entered.
On the Options tab, you may select the default zoom level for the map, and also the type of map from the following options (Roadmap is the default type):
- Roadmap
- Satellite
- Hybrid
- Terrain
Map Markers
By enabling the "Show marker for location" option on the Main tab, you may define the title, label and content for the default map location marker.
On the Markers tab, you may add additional markers to the map, each with it's own coordinates, title, label and content. It is recommended to use a label of short length for each marker (e.g. a single letter or number) due to space
Issues
Please use the GitHub issue tracker for bug reports and feature requests.
To-Do
- add support for geocoding of map locations (e.g. via street address)
Contribution
Your contributions are gladly welcomed to help make this project better. Please see contributing for more information.
Maintainers
License
BSD-3-Clause © Praxis Interactive