Zh GoogleMap Description
Creating Map
We turn to the menu "Maps".
Enter the number of maps with the correct configuration for us.
Coordinates it is convenient to choose by dragging the marker (the value is automatically substituted in the form fields ) or by clicking the mouse on the desired location.
Map properties
Title | Map title |
Description | Description |
Latitude | Map center Latitude |
Longitude | Map center Longitude |
Width | Map Width, if set to 0, map will be 100% wide |
Height | Map Height if set to 0, map will be 100% height. |
Map Details
Show Title as Placemark | Show map title as a placemark
|
Open InfoWin | Open InfoWindow for map title immediately |
Disable AutoPan | Disable AutoPan when open infowin |
Map Bounds | Map bounds to protect navigation outside map You have to enter Latitude1,Longitude1;Latitude2,Longitude2 |
Zoom | Initial Map Zoom |
Min Zoom | Min Zoom for Map |
Max Zoom | Max Zoom for Map |
Draggable | Enable/disable Map dragging |
Default Map Types | Enable/disable standard map types in map type control |
Map Type | Initial Map Type
|
Google Earth | The enabled/disabled state of the Google Earth
|
OpenStreetMap Layer | The enabled/disabled state of the OpenStreetMap Layer and ability to use Map Type Control to switch to that layer |
NZTopomaps Layer | The enabled/disabled state of the NZTopomaps Layer and ability to use Map Type Control to switch to that layer |
Allow Custom Map Types | The enabled/disabled using custom map type and ability to use Map Type Control to switch to that layers |
Custom Map Types List | List of custom map types ID for using on map, separator ; Example: 1;2;5 |
Weather Layer | Weather Layer, that would be displayed on the map |
KML Layer | URL of the KML Layer, that would be displayed on the map |
Language | Language for map objects names Example: ru-RU |
Show placemark creation information | You can show information about user and date of placemark creation
|
Category | The category that this map is assigned to |
Using Google Earth
We turn to component options.
Enter the key Google Earth API.
For you map select using Google Earth
- "Yes" - the map is displayed, but if you have not installed the plugin Google Earth Plugin, then that functionality is not available
- "Yes (Notify)" - the map is displayed, but if you have not installed the plugin Google Earth Plugin, then that functionality is not available and displays a message that there is no plugin
Using KML Layer
If you have KML-file, you can put into accessible folder on site and fill URL in map field KML Layer.
If you want to use more than one file, you can use "feature", that path field of Paths is not required
- go to Paths tab
- create path
- fill KML Layer field
And after that new layer will be displayed
Map Header
Header HTML-text | HTML text on top of the map |
Show Header Separator | Show Separator after Header HTML text |
Show Footer Separator | Show Separator before Footer HTML text |
Footer HTML-text | HTML text on bottom of the map |
Styles
You can create styled maps, ie you have ability to change color, hide POI and so on.
Styles | Styles for map Read more about styling Start Styling your Map
|
Map Controls
There are three sliders in this section
The first slider is
Map Type Control | The enabled/disabled state of the Map Type Control |
Pan Control | The enabled/disabled state of the Pan Control |
Zoom Control | The enabled/disabled state of the Zoom Control |
Scale Control | The enabled/disabled state of the Scale Control |
Overview Map Control | The enabled/disabled state of the Overview Map Control
|
Double Click Zoom | Enables/disables zoom and center on double click |
Scroll Wheel Zoom | The enabled/disabled state of the scrollwheel zooming on the map |
Rotate Control | The enabled/disabled state of the Rotate Control |
Street View Control | The enabled/disabled state of the Street View Control |
Traffic Layer | The enabled/disabled state of the Traffic Layer |
Bicycle Layer | The enabled/disabled state of the Bicycle Layer |
Home Button | The enabled/disabled feature to reset map center and/or zoom to initial value |
The second slider is
Find Control (geocoding) | The enabled/disabled state of the Find Control (by geocoding) |
Find Control width | Width of Find Control field |
Draw route from search point to place | The enabled/disabled state of the drawing route from place which is found by Find Control |
Change zoom for result | You can change zoom to show result |
Search region | Region Localization: if you wish to alter your map to serve geocoding results towards the region. The value is Unicode region subtag identifiers. Most Unicode region identifiers are identical to ISO 3166-1 codes, with some notable exceptions. E.g., US, ES. But as for example for Great Britain is GB, not UK |
The third slider is
Map Type Control | Position on a map |
Pan Control | Position on a map |
Zoom Control | Position on a map |
Scale Control | Position on a map |
Street View Control | Position on a map |
Find Control (geocoding) | Position on a map |
Geolocation Control | Position on a map |
Placemark List Button | Position on a map |
Traffic Layer Button | Position on a map |
Transit Layer Button | Position on a map |
Bicycle Layer Button | Position on a map |
Home Button | Position on a map |
Map Properties for Placemarks
Placemark ordering | Order placemarks. It is useful when you show placemark list
|
Show placemarks in cluster | Create cluster for markers |
Marker Cluster Zoom Level | Zoom Level on which Clusterer starts group markers |
Group Placemarks in Cluster by Group Property | Create cluster for each group (and you can override cluster icon) Remember, if you use this feature (without managing markers by group list), you have to activate group in cluster (by setting Active in Group List) |
Place overlapping placemarks on a spiral | Enable feature to show overlapped placemarks on a spiral |
Show placemark hover text | Enable feature to show infowin/infobubble on hover placemark
|
InfoBubble Style | If you use Open InfoBubble for Show placemark hover text feature to show hover text, than you can assign InfoBubble stype for it. |
Map Properties for Placemark List
Width | Placemark List Width in pixels If set 0 then you've got 100% width. |
Height | Placemark List Height in pixels |
Position | Values
For example, <ul id="GMapsMarkerUL" style="list-style-type: none;"></ul> |
Style | Values
|
Background Color | Background Color Example: #EAEAEA As for gradient in my example, I've got it from internet sites. When you specify background color #E6E6E6, I add into style line background: #E6E6E6 I've got this example background: #fefcea; /* For old browsers */ background: -moz-linear-gradient(top, #fefcea, #f1da36); /* Firefox 3.6+ */ /* Chrome 1-9, Safari 4-5 */ background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#fefcea), color-stop(100%,#f1da36)); /* Chrome 10+, Safari 5.1+ */ background: -webkit-linear-gradient(top, #fefcea, #f1da36); background: -o-linear-gradient(top, #fefcea, #f1da36); /* Opera 11.10+ */ background: -ms-linear-gradient(top, #fefcea, #f1da36); /* IE10 */ background: linear-gradient(top, #fefcea, #f1da36); /* CSS3 */ padding: 10px; border: 1px solid #333;
And after all this is mine code #E6E6E6; /* For old browsers */ background: -moz-linear-gradient(top, #E6E6E6, #AAAAAA); /* Firefox 3.6+ */ /* Chrome 1-9, Safari 4-5 */ background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#E6E6E6), color-stop(100%,#AAAAAA)); /* Chrome 10+, Safari 5.1+ */ background: -webkit-linear-gradient(top, #E6E6E6, #AAAAAA); background: -o-linear-gradient(top, #E6E6E6, #AAAAAA); /* Opera 11.10+ */ background: -ms-linear-gradient(top, #E6E6E6, #AAAAAA); /* IE10 */ background: linear-gradient(top, #E6E6E6, #AAAAAA); /* CSS3 */ padding: 10px; border: 1px solid #333; I note that in IE9 there is no gradient. But it is not task to do it in my component by CSS. In any case you can do it by image and applying for class. |
Action by Click | Action to do when you Click on link
|
Placemark List Content | Text from which placemark list contains
|
Appearance | Appearance of placemark list
|
Search placemark field | Enable feature to search by autocomplete placemarks in placemark list |
Groups
Group Control | Position and type of list of group, that would be displayed for marker management
|
Group Type | Behavior of group list
|
Manage Placemarks | Enable ability to manage placemarks by Group List |
Synchronize with placemark list | Show/Hide placemarks in placemark list depends on group state |
Manage Paths | Enable ability to manage paths by Group List |
Group ordering | Group order in list
|
Group Column Width | Column width for the left or right position of list group |
Show Group | Show text, icon of group in list of group
|
Display Show All and Hide All buttons | Show buttons to show/hide all groups by one click
|
Search group field | Display search field to find group in group list |
Group CSS | Type of group decoration
There are two predefined style |
Group List Title | Group List Title |
Top Description | Description on top of the list |
Show Top-Separator | The enabled/disabled state of Separator on top of the list |
Show Bottom-Separator | The enabled/disabled state of Separator on botom of the list |
Bottom Description | Description on bottom of the list |
Route
This options for routes, which is shown for find your way to place
- by geocoding find feature (Map Find Control (geocoding) slider)
- autocomplete field (Places Library slider)
Draggable | The enabled/disabled ability route to be draggable |
Show Route Panel | Enable show route details |
Address | If you want not use map center coordinates as a destination point of your route (for example, Google not right geocoded your address), you can enter text address into this field, and it would be used for drawing route Use value from autocomplete field (copy-paste) for entering more clear address for google router |
Travel Mode: Driving | The enabled/disabled ability to be show this travel mode |
Travel Mode: Walking | The enabled/disabled ability to be show this travel mode |
Travel Mode: Bicycling | The enabled/disabled ability to be show this travel mode |
Unit System | Use this unit system option when create route
|
Avoid Highways | Use this option when create route |
Avoid Tolls | Use this option when create route |
Using Places Library
Enable using Places | The enabled/disabled state of using Places Library |
Places Types | Places types in single quotes, delimited by comma for example: 'restaurant', 'store' |
Radius | Radius from map center (in meters) If you don't want to see placemark from Places API, and only use autocomplete field, then set radius = 0 Places API show only up to 20 places! |
Show Autocomplete field | The enabled/disabled state of using Autocomplete field |
Autocomplete field width | Autocomplete field width |
Places Types for Autocomplete field | Places types for Autocomplete field like a places types field, values in single quotes with comma delimiter
|
Show direction | Show direction (by Directions API) from place, what you've found by autocomplete field (where marker is) and point on your map (which you set in map, center of map) |
Search country | Country Localization: if you wish to alter your map to serve places autocomplete field values the towards specified country. The value is ISO 3166-1 Alpha-2 country code. E.g., US, BR, AU. |
Using Panoramio Library
Advanced Options
Loading map objects dynamically | Enable feature to load placemarks by AJAX
|
Load type | Type of loading placemarks, ie load it all, or depends on some conditions
|
Buffer size for placemarks | You can load placemarks by parts |
Loading content data dynamically | Enable feature to load placemark infowin content by AJAX
Ie your page can contains placemark creation code, but all infowin/infobubble content can be loaded dynamically. |
MarkerManager | The enabled/disabled state of using Marker Manager Marker Manager displaying markers on definite zoom. |
Elevation | The enabled/disabled state of using Elevation API Show elevation at point where you click. |
Street View | Enable/disable show Street View
|
Street View Style | Style of Street View
|
Placemark Filter | Restriction displaying placemarks on some rules. |
Allow to user enter placemarks | Enable registered users to create and/or alter placemarks on map. |
Insert Allowed | User can create new placemarks |
Update Allowed | User can update existing placemarks |
Delete Allowed | User can delete existing placemarks |
New Placemark State | Placemark Status for created user placemark. |
New Contact State | Contact Status for created user contact (if enabled contact integration). |
Show Icon Type Selector for New Placemark | The enabled/disabled state of selecting Icon Type when user creates placemark. |
CSS Class | The class name for map div tag |
Additional CSS styles for loading | List of CSS style files for loading when map is loading, separated by new line or semicolon |
Additional JavaScript files for loading | List of JavaScript files for loading when map is loading, separated by new line or semicolon |
Placemark Rating | Enable Placemark rating feature.
|
Map text override | You can use this feature to override Standard text for map controls etc by using special interface in component administration area |
Geolocation
Auto Positioning | Auto Positioning when map is loading |
Geolocation Control | Show Geolocation Control |
Geolocation Button Style | Geolocation Button Style
|
Integration
Use contacts | The enabled/disabled state of using contacts You can enable using contact information and associate your placemark with contact to display contact information in placemark InfoWin. |
Contact Details | You can enter names of attributes to show. Separator is ; Acceptable values
You can enter it in any order, and by it the contact will be shown. Note: postcode and zipcode – it is the same field, but different labels will be. Check contact fields, and you'll see this pairs: City or Suburb, State or Province, Postal / ZIP Code
to show position, contact name and mobile phone |
Use users | The enabled/disabled state of using users You can enable using user information and associate your placemark with user to display user information in placemark InfoWin. |
Display
Using Marker Manager
You can use Marker Manager with restrictions:
- you can't use marker clustering - because cluster groups markers, and controls it displaying
- you can't use managing markers by group list
To use Marker Manager:
- set group for your markers
- set Min Zoom for Marker Manager and Max Zoom for Marker Manager for each group
- enable feature for the map
Creating Placemark
We turn to the tab "Placemarks".
Enter the number of markers bound to a specific map.
Coordinates it is convenient to choose by dragging the marker (the value is automatically substituted in the form fields ) or by clicking the mouse on the desired location.
On the other hand you can use Autocomplete field above map to find your place.
Or enter text address into Autocomplete field and press Find button to find place by geocoding.
Placemark properties
Title | Placemark Title |
Description | Description |
Tags | Tags |
Latitude | Latitude |
Longitude | Longitude |
Address | Text address of your placemark. You can load your data into this field, if you don't have lat/lng data. In this case address will be automatically geocoded and markers are displayed. And in backend marker will be shown too. But if you move marker (change position by dragging or clicking somewhere else), new positions will be stored as lat/lng. Displaying markers by lat/lng is more quick because there is no need time for geocoding |
Map Title | Title of the map, where marker would be displayed |
Placemark Details
Published | Published |
Group | Group |
Protected from user correction | Protected placemark from user correction, when you activate creating users placemark |
Include in Placemark List | Include placemark in Placemark List |
Category | The category that this placemark is assigned to |
User ordering index | Use this field to manual sorting placemarks in placemark list |
Rating | Rating of placemark, it can be set only by rating system |
Show GPS information | Show GPS information (coordinates) in infowin |
Addition HTML text | HTML text, that will be included in placemark InfoWin content Be careful, if you enter email address, the other Joomla! plugin it changed, and there will be an error and map will not be shown. |
Placemark full description | Placemark description (HTML text) in placemark detail view (single placemark page view) |
Hover HTML text | Hover HTML text for placemark when enabled hovering feature |
Appearance properties
Icon Type | Icon Type |
Icon X-offset | Icon offset |
Icon Y-offset | Icon offset |
Marker | Marker Type
|
Open InfoWin | Execute action which described in Action by Click and Zoom by Click |
InfoWin Content | Content of InfoWin
|
Action by Click | Action by Click on this placemark
|
Zoom by Click | Zoom by Click on this placemark You can change zoom when you click on marker
|
Street View in InfoWin toolbar | Enable ability in infowin show button to show Street View |
View Area Width for Street View | View Area Width for div section in infowin |
View Area Height for Street View | View Area Height for div section in infowin |
Street View Style | Additional Street View properties, which would be applied. This properties you can create on separate component tab |
URL Site | Site URL to display in placemark InfoWin content |
Site Name | Site Name to display instead of URL |
URL Image | Image URL to display in placemark |
URL Image Thumbnail | Image URL to display in placemark list |
Start Publishing | Placemark start publishing date |
Finish Publishing | Placemark finish publishing date |
Date of creation | Placemark creation date |
Access | ACL access level to view this placemark |
Infographics Type | Dynamic Icon Type Example: chst=d_fnote&chld=thought|1|0088FF|h|Why+am+I+here? |
Infographics Icon width | Dynamic Icon width |
Infographics Icon height | Dynamic Icon height |
Marker with Label
Label Class | Label CSS Class |
Label in background | Label in background |
Label X-offset | Label offset |
Label Y-offset | Label offset |
Label content | HTML label content |
InfoBubble Tabs
About InfoBubble you can read there InfoBubble example
It is not created by component, there is only using this code. If it works not correctly - check in example, and if there not works - you should ask in google maps forum (component only calls JavaScript code)
Style | Style for InfoBubble |
Add InfoWin content | Add InfoWin content into InfoBubble
|
Title | Tab Title |
Image | You can use image to build image gallery in single placemark view |
HTML Text | Tab text |
Integration
User | User which associate with placemark |
Show user prompts | Type of view user information
|
Contact | Contact which associate with placemark |
Show contact prompts | Type of view contact information
|
Contact Button in InfoWin toolbar | Show Contact Button in InfoWin toolbar |
Alternative Contact URL | You can alternative URL to show contact page (instead of standard joomla's call) |
Placemark details Button in InfoWin toolbar | Show Placemark Button in InfoWin toolbar |
Alternative Details URL | You can alternative URL to show details page (instead of standard call detail placemark view) |
Placemark Details for standard call | You can override default details attributes for detail view
By default placemark detail page is opened without enabling additional loading bootstrap library and styles, without thumbnail and image gallery, without Additional HTML text and full text description. You can change default behavior by passing parameters, separated by comma (,)
For example, if you enter image gallery,addition html text,full description into field, the detail view for placemark will be with two additional description (short "Addition HTML text" and full "Placemark full description"), and image gallery will be displayed too |
Article | Article which associate with placemark |
Article Button in InfoWin toolbar | Show Article Button in InfoWin toolbar |
Alternative Article URL | You can alternative URL to show article page (instead of standard joomla's call) |
iframe tag Article CSS | You can apply CSS style for iframe tag (when use article in infowin content) |
Hidden Attributes for Customization
It is for you own customization. You can enter any values in this fields, and use what you want in you code. You can rename prompt in language file
For your convenience you can also change the labels of the fields in file
/administrator/language/en-GB/en-GB.com_zhgooglemap.ini
lines
COM_ZHGOOGLEMAP_MAPMARKER_DETAIL_ATTRIBUTE1_LABEL COM_ZHGOOGLEMAP_MAPMARKER_DETAIL_ATTRIBUTE2_LABEL … COM_ZHGOOGLEMAP_MAPMARKER_DETAIL_ATTRIBUTE9_LABEL
For example, you can enter some data into this fields.
In table columns have names
attribute1 attribute2 ... attribute9
You can use this fields, for example, for integration with other systems or etc.
Display
Placemark Customization
Copy your marker images (format PNG) in the directory
/administrator/components/com_zhgooglemap/assets/icons/
Component will automatically pick up the picture when choosing the type of marker.
The only requirement - the file name use English letters and can't contain any special character; the file extension have to be a .png ie in lower case, because names of images stored in a database without the extension, and it is appended in the output.
Don't forget about Compatibility Mode for Resource Files
Grouping
The marker may be included in one group, for this to specify a marker belonging to the group. If the field of markers grouping is set (field value Group Control is different from No), then starts an additional feature: a list of active groups (the location is determined by this same field, with the first four (left, top, right, bottom) correspond to the table form of representation, while the two latter (Group-Map, Map-Group) - based on the div, and you have the opportunity to do anything with them.
The map also has a drop-down list Group CSS - which implements the following functionality:
- the first two styles - predefined
- the third - you can override it in your CSS file template
- while in three cases, just have three different names of objects, respectively, we can change the styles they like.
The following names
for the div-tag ID takes the value
- GMapsMenu-advanced
- GMapsMenu-simple
- GMapsMenu-external
for ul-tag
- zhgm-menu-advanced
- zhgm-menu-simple
- zhgm-menu-external
Accordingly, styles, prescribes for them. Field Show Group Icon is used to display icons in the list of groups.