Download the PHP package jezzdk/statamic-google-maps without Composer
On this page you can find all versions of the php package jezzdk/statamic-google-maps. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package statamic-google-maps
Statamic Google Maps
A Google Map addon for Statamic V4 for creating and displaying Google Maps on your website.
Installation
Require it using Composer.
Publish the assets
Add an environment variable, since this library uses Google Maps under the hood for displaying maps.
Lastly, insert this tag in the header in order to load the Google Map JavaScript on the frontend:
*Disclaimer* You will need a billing account on Google if you want to create a Google Maps API key. There are plenty of guides on how to set that up if you ask Google.
Usage
This addon provides a Google Map fieldtype. You can use that in your blueprints which will enable your users to dynamically insert maps onto your website.
There is also a tag that you can use directly in your Antlers template. I'll explain both use cases below.
Map Tag
The simplest way to insert a map is by inserting the tag with latitude and longitude:
This will insert a map centered on the given coordinates, with a zoom level of 16 and using the roadmap type. The Map tag supports the following attributes:
| Attribute | Type | Default | Description |
|---|---|---|---|
| lat | float | none | The latitude (required) |
| lng | float | none | The longitude (required) |
| marker | bool | false | Display a marker in the latitude and longitude from above |
| markerLat | float | none | The latitude for the marker (the marker attribute must be false or omitted) |
| markerLng | float | none | The longitude for the marker (the marker attribute must be false or omitted) |
| zoom | integer | 16 | The map zoom level |
| type | string | roadmap | Valid values are: roadmap, satellite, terrain, hybrid |
| icon | string | /assets/marker.png | (Pro feature) Use a path relative to the public folder. If the file doesn't exist, the default Google Map pin will be used. |
| style | string | none | (Pro feature) The map styles as a JSON string |
| showControls | boolean | false | Show the default map controls |
Google Map Field (Pro feature)
Simply select the fieldtype when creating a blueprint. When a user pans around the map, changes zoom level or changes the map type, the settings are saved and the output will display the same view as selected in the control panel.
The field has a few settings:
- Initial map type - choose which map type should be selected when the map is loaded initially in the control panel
- Initial zoom level - choose the zoom level when the map is loaded initially in the control panel
- Enable maptype selector - Allow the user to select the map type
- Enable marker creation - The user can create and remove a marker on the map
- Enable Geocoder - This adds a search field above the map, enabling the user to search for an address (The Geocoder API must be enabled in Google Cloud Console for this to work!)
When using markers, the script will look for an icon at /public/assets/marker.png. If it exist it will be used, otherwise it will use the default Google Map pin.
Styles (Pro feature)
The map can be styled using a JSON array of styles. You can generate the style JSON for free at https://mapstyle.withgoogle.com/ (use the old wizard) or at https://snazzymaps.com/.
The fieldtype has a button that reveals a textarea where the style JSON can be inserted, and the map tag has a style attribute for the same purpose.
