Template:Zh GoogleMap Description Map: Difference between revisions

From Documentation
Jump to navigation Jump to search
 
(50 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Creating Map ==
== Creating Map ==


We turn to the tab "Maps".
We turn to the menu "Maps".




Line 10: Line 10:


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.
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.
[[File:GM-Map-Detail.png]]




=== Map properties ===
=== Map properties ===


[[File:GM-Map-Detail-MapDetails-1.png]]
[[File:GM-Map-Detail.png]]
 
[[File:GM-Map-Detail-MapDetails-2.png]]


{|class="zhpropertytable"
{|class="zhpropertytable"
Line 26: Line 22:
|class="zhproperty"|Description||class="zhdescription"|Description
|class="zhproperty"|Description||class="zhdescription"|Description
|-
|-
|class="zhproperty"|Show Title as Placemark||class="zhdescription"|Show map title as a placemark<br />
|class="zhproperty"|Latitude||class="zhdescription"|Map center Latitude
* '''No''' - Do not show marker
* '''Drop''' - Marker with animation (Drop)
* '''Bounce''' - Marker with animation (Bounce)
* '''Simple''' - Marker without animation
|-
|-
|class="zhproperty"|Open InfoWin||class="zhdescription"|Open InfoWindow for map title immediately
|class="zhproperty"|Longitude||class="zhdescription"|Map center Longitude
|-
|-
|class="zhproperty"|Width||class="zhdescription"|Map Width,<br />
|class="zhproperty"|Width||class="zhdescription"|Map Width,<br />
Line 40: Line 32:
<p class="zh-text-tip">if set to 0, map will be 100% height.<br />
<p class="zh-text-tip">if set to 0, map will be 100% height.<br />
You can apply [[Zh Template Map FullScreen]] to your map page to show map in full screen or for the other cases</p>
You can apply [[Zh Template Map FullScreen]] to your map page to show map in full screen or for the other cases</p>
|}
=== Map Details ===
[[File:GM-Map-Detail-MapDetails-1.png]]
[[File:GM-Map-Detail-MapDetails-2.png]]
{|class="zhpropertytable"
|-
|-
|class="zhproperty"|Latitude||class="zhdescription"|Map center Latitude
|class="zhproperty"|Show Title as Placemark||class="zhdescription"|Show map title as a placemark<br />
* '''No''' - Do not show marker
* '''Drop''' - Marker with animation (Drop)
* '''Bounce''' - Marker with animation (Bounce)
* '''Simple''' - Marker without animation
|-
|class="zhproperty"|Open InfoWin||class="zhdescription"|Open InfoWindow for map title immediately
|-
|-
|class="zhproperty"|Longitude||class="zhdescription"|Map center Longitude
|class="zhproperty"|Disable AutoPan||class="zhdescription"|Disable AutoPan when open infowin
|-
|-
|class="zhproperty"|Map Bounds||class="zhdescription"|Map bounds to protect navigation outside map<br />
|class="zhproperty"|Map Bounds||class="zhdescription"|Map bounds to protect navigation outside map<br />
You have to enter '''Latitude1,Longitude1;Latitude2,Longitude2'''<br />
You have to enter '''Latitude1,Longitude1;Latitude2,Longitude2'''<br />
ie pair of coordinates separated by semicolon and in one coordinate has values separated by comma
ie pair of coordinates separated by semicolon and in one coordinate has values separated by comma<br />
The first coordinate - left bottom, the second - right top of bounds
|-
|-
|class="zhproperty"|Zoom||class="zhdescription"|Initial Map Zoom
|class="zhproperty"|Zoom||class="zhdescription"|Initial Map Zoom
Line 56: Line 64:
|-
|-
|class="zhproperty"|Draggable||class="zhdescription"|Enable/disable Map dragging
|class="zhproperty"|Draggable||class="zhdescription"|Enable/disable Map dragging
|-
|class="zhproperty"|Default Map Types||class="zhdescription"|Enable/disable standard map types in map type control
|-
|-
|class="zhproperty"|Map Type||class="zhdescription"|Initial Map Type<br />
|class="zhproperty"|Map Type||class="zhdescription"|Initial Map Type<br />
Line 87: Line 97:
|class="zhproperty"|Language||class="zhdescription"|Language for map objects names<br />
|class="zhproperty"|Language||class="zhdescription"|Language for map objects names<br />
Example: ru-RU
Example: ru-RU
|-
|class="zhproperty"|Show placemark creation information||class="zhdescription"|You can show information about user and date of placemark creation<br />
* '''No'''
* '''Username'''
* '''Date of creation'''
* '''Date of creation and Username'''
* '''Username (after toolbar)'''
* '''Date of creation (after toolbar)'''
* '''Date of creation and Username (after toolbar)'''
|-
|-
|class="zhproperty"|Category||class="zhdescription"|The category that this map is assigned to
|class="zhproperty"|Category||class="zhdescription"|The category that this map is assigned to
Line 107: Line 126:
If you have KML-file, you can put into accessible folder on site and fill URL in map field 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 "featute", that '''path''' field of '''Paths''' is not required
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
* go to '''Paths''' tab
* create path
* create path
Line 114: Line 133:
And after that new layer will be displayed
And after that new layer will be displayed


=== Map Decoration ===
=== Map Header ===




Line 127: Line 146:




 
=== Map Footer ===


[[File:GM-Map-Detail-MapDecoration-Footer.png]]
[[File:GM-Map-Detail-MapDecoration-Footer.png]]
Line 139: Line 158:




=== Styles ===
You can create styled maps, ie you have ability to change color, hide POI and so on.


[[File:GM-Map-Detail-MapDecoration-Styles.png]]
[[File:GM-Map-Detail-MapDecoration-Styles.png]]
Line 145: Line 166:
|-
|-
|class="zhproperty"|Styles||class="zhdescription"|Styles for map<br />
|class="zhproperty"|Styles||class="zhdescription"|Styles for map<br />
See [http://gmaps-samples-v3.googlecode.com/svn/trunk/styledmaps/wizard/index.html Google Maps API Styled Map Wizard]<br />
Read more about styling [https://developers.google.com/maps/documentation/javascript/styling Start Styling your Map]
Just press button '''Show JSON''', copy code between '''[''' and ''']''' with them, and paste in this field
 
 
See [https://mapstyle.withgoogle.com/ Google Maps API Styled Map Wizard]<br />
Just press button '''Finish''', copy code between '''[''' and ''']''' with them, and paste in this field
|}
|}


=== Map Controls ===
=== Map Controls ===
There are three sliders in this section


[[File:GM-Map-Detail-MapControls.png]]
The first slider is
[[File:GM-Map-Detail-MapControls-1.png]]
[[File:GM-Map-Detail-MapControls-1.png]]


Line 181: Line 210:
|-
|-
|class="zhproperty"|Bicycle Layer||class="zhdescription"|The enabled/disabled state of the Bicycle Layer
|class="zhproperty"|Bicycle Layer||class="zhdescription"|The enabled/disabled state of the Bicycle Layer
from place witch is found by Find Control
|-
|class="zhproperty"|Home Button||class="zhdescription"|The enabled/disabled feature to reset map center and/or zoom to initial value
|}
|}




The second slider is


[[File:GM-Map-Detail-MapControls-3.png]]
[[File:GM-Map-Detail-MapControls-3.png]]
Line 194: Line 225:
|class="zhproperty"|Find Control width||class="zhdescription"|Width of Find Control field
|class="zhproperty"|Find Control width||class="zhdescription"|Width of Find Control field
|-
|-
|class="zhproperty"|Draw route from search point to place||class="zhdescription"|The enabled/disabled state of the drawing route from place witch is found by Find Control
|class="zhproperty"|Draw route from search point to place||class="zhdescription"|The enabled/disabled state of the drawing route from place which is found by Find Control
|-
|class="zhproperty"|Change zoom for result||class="zhdescription"|You can change zoom to show result
|-
|class="zhproperty"|Search region||class="zhdescription"|Region Localization: if you wish to alter your map to serve geocoding results towards the region. <br />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


[[File:GM-Map-Detail-MapControls-4.png]]
[[File:GM-Map-Detail-MapControls-4.png]]


=== Control Positions ===
[[File:GM-Map-Detail-ControlPositions.JPG]]


{|class="zhpropertytable"
{|class="zhpropertytable"
Line 222: Line 255:
|-
|-
|class="zhproperty"|Placemark List Button||class="zhdescription"|Position on a map
|class="zhproperty"|Placemark List Button||class="zhdescription"|Position on a map
|-
|class="zhproperty"|Traffic Layer Button||class="zhdescription"|Position on a map
|-
|class="zhproperty"|Transit Layer Button||class="zhdescription"|Position on a map
|-
|class="zhproperty"|Bicycle Layer Button||class="zhdescription"|Position on a map
|-
|class="zhproperty"|Home Button||class="zhdescription"|Position on a map
|}
|}


=== Map Properties for Placemarks ===
=== Map Properties for Placemarks ===


[[File:GM-Map-Detail-Placemarks.JPG]]
[[File:GM-Map-Detail-Placemarks.png]]


{|class="zhpropertytable"
{|class="zhpropertytable"
|-
|class="zhproperty"|Placemark ordering||class="zhdescription"|Order placemarks. It is useful when you show placemark list
* '''Placemark title'''
* '''Category title and ordering'''
* '''Category title (descending) and ordering'''
* '''User ordering index'''
* '''Group title and Placemark title'''
* '''Group title (descending) and Placemark title'''
* '''Group user ordering index and Placemark title'''
* '''Group user ordering index (descending) and Placemark title'''
* '''Date of creation'''
* '''Date of creation (descending)'''
|-
|-
|class="zhproperty"|Show placemarks in cluster||class="zhdescription"|Create cluster for markers
|class="zhproperty"|Show placemarks in cluster||class="zhdescription"|Create cluster for markers
|-
|-
|class="zhproperty"|Marker Cluster Zoom Level||class="zhdescription"|Zoom Level on which Cluster starts group markers
|class="zhproperty"|Marker Cluster Zoom Level||class="zhdescription"|Zoom Level on which Clusterer starts group markers
|-
|class="zhproperty"|Group Placemarks in Cluster by Group Property||class="zhdescription"|Create cluster for each group (and you can override cluster icon)<br />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)
|-
|class="zhproperty"|Place overlapping placemarks on a spiral||class="zhdescription"|Enable feature to show overlapped placemarks on a spiral
|-
|class="zhproperty"|Show placemark hover text||class="zhdescription"|Enable feature to show infowin/infobubble on hover placemark
* '''No'''
* '''Open InfoWin'''
* '''Open InfoBubble'''
|-
|-
|class="zhproperty"|Group Placemarks in Cluster by Placemark Group Property||class="zhdescription"|Create cluster for each marker group (and you can override cluster icon)<br />Remember, if you use this feature (without managing markers by group list), you have to activate group in cluster (by setting Active in Placemark Group List)
|class="zhproperty"|InfoBubble Style||class="zhdescription"|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 ===
=== Map Properties for Placemark List ===


[[File:GM-Map-Detail-PlacemarkList.JPG]]
[[File:GM-Map-Detail-PlacemarkList.png]]


{|class="zhpropertytable"
{|class="zhpropertytable"
|-
|-
|class="zhproperty"|Width||class="zhdescription"|Placemark List Width in px<br />
|class="zhproperty"|Width||class="zhdescription"|Placemark List Width in pixels<br />
<p class="zh-text-tip">If set 0 then you've got 100% width.<br />
<p class="zh-text-tip">If set 0 then you've got 100% width.<br />
It can be useful in bottom position and 100% map width</p>
It can be useful in bottom position and 100% map width</p>
|-
|-
|class="zhproperty"|Height||class="zhdescription"|Placemark List Height in px
|class="zhproperty"|Height||class="zhdescription"|Placemark List Height in pixels
|-
|-
|class="zhproperty"|Position||class="zhdescription"|Values<br />
|class="zhproperty"|Position||class="zhdescription"|Values<br />
Line 316: Line 376:
|-
|-
|class="zhproperty"|Action by Click||class="zhdescription"|Action to do when you Click on link<br />
|class="zhproperty"|Action by Click||class="zhdescription"|Action to do when you Click on link<br />
* '''Center''' - center map placemark
* '''Center''' - center map on placemark
* '''Click''' - execute click function for placemark
* '''Click''' - execute click function for placemark
* '''Center, Animate''' - center map on placemark and animate placemark icon
* '''Click, Animate''' - execute click function for placemark and animate placemark icon
* '''Center, Animate and Click''' - center map on placemark, animate placemark icon and execute click function for placemark
|-
|-
|class="zhproperty"|Placemark List Content||class="zhdescription"|Text from which placemark list contains<br />
|class="zhproperty"|Placemark List Content||class="zhdescription"|Text from which placemark list contains<br />
* '''Title''' - placemark title
* '''Title''' - placemark title
* '''Title and Description''' - placemark title and desciption
* '''Title and Description''' - placemark title and desciption
* '''Title and Addition HTML text''' - placemark title and addition HTML text
* '''Icon and Title''' - placemark icon and title
* '''Icon and Title''' - placemark icon and title
* '''Icon, Title and Description'''
* '''Icon, Title and Description'''
* '''Icon, Title and Addition HTML text''' - placemark icon, title and addition HTML text
* '''Icon, Title and Description (table)''' - table layout
* '''Icon, Title and Description (table)''' - table layout
* '''Icon, Title and Addition HTML text (table)''' - table layout
* '''Title and Image''' - placemark title and image (thumbnail)
* '''Title and Image''' - placemark title and image (thumbnail)
* '''Title, Image and Description'''
* '''Title, Image and Description'''
* '''Title, Image and Addition HTML text'''
* '''Image and Title'''
* '''Image and Title'''
* '''Image, Title and Description'''
* '''Image, Title and Description'''
* '''Image, Title and Addition HTML text'''
* '''Image, Title and Description (table)''' - table layout
* '''Image, Title and Description (table)''' - table layout
* '''Image, Title and Addition HTML text (table)''' - table layout
* '''Table: Title''' - placemark title and table layout
* '''Table: Title''' - placemark title and table layout
* '''Table: Title and Description''' - placemark title and desciption and table layout
* '''Table: Title and Description''' - placemark title and description and table layout
* '''Table: Title and Addition HTML text''' - placemark title and addition HTML text and table layout


|-
|-
|class="zhproperty"|Appearance ||class="zhdescription"|Appearance of placemark list<br />
|class="zhproperty"|Appearance||class="zhdescription"|Appearance of placemark list<br />
* '''Open List''' - placemark list is opened
* '''Open List''' - placemark list is opened
* '''Icon Button''' - additional icon button control on map
* '''Icon Button''' - additional icon button control on map
Line 340: Line 411:
* '''Icon Button and Open List''' - additional icon button control on map and list is opened
* '''Icon Button and Open List''' - additional icon button control on map and list is opened
* '''Text Button and Open List''' - additional text button control on map and list is opened
* '''Text Button and Open List''' - additional text button control on map and list is opened
|-
|class="zhproperty"|Search placemark field||class="zhdescription"|Enable feature to search by autocomplete placemarks in placemark list
|}
|}


=== Managing Placemarks by Placemark Group List ===
=== Groups ===
 
[[File:GM-Map-Detail-PlacemarkGroups-1.png]]
 
[[File:GM-Map-Detail-PlacemarkGroups-2.png]]


[[File:GM-Map-Detail-PlacemarkGroups.JPG]]


{|class="zhpropertytable"
{|class="zhpropertytable"
|-
|-
|class="zhproperty"|Placemark Group Control||class="zhdescription"|Position and type of list of group, that would be displayed for marker management<br />
|class="zhproperty"|Group Control||class="zhdescription"|Position and type of list of group, that would be displayed for marker management<br />
* '''No''' - there is not placemark control by group list
* '''No''' - there is not placemark control by group list
* '''Left''' - List of group on the left (table style)
* '''Left''' - List of group on the left (table style)
Line 356: Line 432:
* '''Group-Map''' - List of group on the top (div style)
* '''Group-Map''' - List of group on the top (div style)
* '''Map-Group''' - List of group on the bottom (div style)
* '''Map-Group''' - List of group on the bottom (div style)
* '''External''' - List of group in user defined position (special tag)
|-
|-
|class="zhproperty"|Placemark Group Column Width||class="zhdescription"|Column width for the left or right position of list group
|class="zhproperty"|Group Type||class="zhdescription"|Behavior of group list<br />
* Toggle Group
* Only One Active Group
|-
|-
|class="zhproperty"|Show Placemark Group||class="zhdescription"|Show text, icon of group in list of group<br />
|class="zhproperty"|Manage Placemarks||class="zhdescription"|Enable ability to manage placemarks by Group List
|-
|class="zhproperty"|Synchronize with placemark list||class="zhdescription"|Show/Hide placemarks in placemark list depends on group state
|-
|class="zhproperty"|Manage Paths||class="zhdescription"|Enable ability to manage paths by Group List
|-
|class="zhproperty"|Group ordering||class="zhdescription"|Group order in list
* Group title
* Category Title and ordering
* User ordering index
|-
|class="zhproperty"|Group Column Width||class="zhdescription"|Column width for the left or right position of list group
|-
|class="zhproperty"|Show Group||class="zhdescription"|Show text, icon of group in list of group<br />
* Text
* Icon
* Text and Icon
|-
|class="zhproperty"|Display Show All and Hide All buttons||class="zhdescription"|Show buttons to show/hide all groups by one click<br />
* No
* Text
* Text
* Icon
* Icon
* Text and Icon
* Text and Icon
|-
|-
|class="zhproperty"|Placemark Group CSS||class="zhdescription"|Type of group decoration  
|class="zhproperty"|Search group field||class="zhdescription"|Display search field to find group in group list
There are two predefined style in <br />
|-
 
|class="zhproperty"|Group CSS||class="zhdescription"|Type of group decoration  
<code>
There are two predefined style<br />
/administrator/components/com_zhgooglemap/assets/css/markergroups.css
</code>
 
and one (external) – for you, which you can set style in you template.  
and one (external) – for you, which you can set style in you template.  
ID for tags depend on Placemark Group CSS field.  
ID for tags depend on Group CSS field.  
See details in Marker Grouping
See details in [[Zh_GoogleMap_Description#Grouping|Placemark Grouping]]
|-
|-
|class="zhproperty"|Group List Title||class="zhdescription"|Group List Title
|class="zhproperty"|Group List Title||class="zhdescription"|Group List Title
Line 388: Line 483:
=== Route ===
=== Route ===


[[File:GM-Map-Detail-Route.JPG]]
[[File:GM-Map-Detail-Route-1.png]]
 
[[File:GM-Map-Detail-Route-2.png]]
 


This options for routes, which is shown for find your way to place  
This options for routes, which is shown for find your way to place  
Line 409: Line 507:
|-
|-
|class="zhproperty"|Travel Mode: Bicycling||class="zhdescription"|The enabled/disabled ability to be show this travel mode
|class="zhproperty"|Travel Mode: Bicycling||class="zhdescription"|The enabled/disabled ability to be show this travel mode
|-
|class="zhproperty"|Unit System||class="zhdescription"|Use this unit system option when create route
* Metric System (kilometers)
* Imperial (English) System (miles)
|-
|class="zhproperty"|Avoid Highways||class="zhdescription"|Use this option when create route
|-
|class="zhproperty"|Avoid Tolls ||class="zhdescription"|Use this option when create route
|}
|}


=== Using Places Library ===
=== Using Places Library ===


[[File:GM-Map-Detail-PlacesLibrary.JPG]]
[[File:GM-Map-Detail-PlacesLibrary.png]]


{|class="zhpropertytable"
{|class="zhpropertytable"
Line 421: Line 528:
|class="zhproperty"|Places Types||class="zhdescription"|Places types in single quotes, delimited by comma<br />for example: 'restaurant', 'store'
|class="zhproperty"|Places Types||class="zhdescription"|Places types in single quotes, delimited by comma<br />for example: 'restaurant', 'store'
<br />
<br />
[http://code.google.com/intl/en/apis/maps/documentation/places/supported_types.html Google Places API: Supported Place Types]
[https://developers.google.com/places/web-service/supported_types Google Places API: Supported Place Types]
|-
|-
|class="zhproperty"|Radius||class="zhdescription"|Radius from map center (in meters)<br />If you don't want to see placemark from Places API, and only use autocomplete field, then set radius = 0 <br />
|class="zhproperty"|Radius||class="zhdescription"|Radius from map center (in meters)<br />If you don't want to see placemark from Places API, and only use autocomplete field, then set radius = 0 <br />
Line 427: Line 534:
|-
|-
|class="zhproperty"|Show Autocomplete field||class="zhdescription"|The enabled/disabled state of using Autocomplete field
|class="zhproperty"|Show Autocomplete field||class="zhdescription"|The enabled/disabled state of using Autocomplete field
|-
|class="zhproperty"|Autocomplete field width||class="zhdescription"|Autocomplete field width
|-
|-
|class="zhproperty"|Places Types for Autocomplete field||class="zhdescription"|Places types for Autocomplete field like a places types field, values in single quotes with comma delimiter  
|class="zhproperty"|Places Types for Autocomplete field||class="zhdescription"|Places types for Autocomplete field like a places types field, values in single quotes with comma delimiter  
Line 433: Line 542:
|-
|-
|class="zhproperty"|Show direction||class="zhdescription"|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)
|class="zhproperty"|Show direction||class="zhdescription"|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)
|-
|class="zhproperty"|Search country||class="zhdescription"|Country Localization: if you wish to alter your map to serve places autocomplete field values the towards specified country. <br />The value is ISO 3166-1 Alpha-2 country code. E.g., US, BR, AU.
|}
|}


=== Using Panoramio Library ===
=== Using Panoramio Library ===


[[File:GM-Map-Detail-PanoramioLibrary.JPG]]
[[File:GM-Map-Detail-PanoramioLibrary.png]]


For using feature set enable by Enable using Panoramio = Yes
=== Advanced Options ===


You can add filter control to map, and it's position.
[[File:GM-Map-Detail-AdvancedOptions-1.png]]


And you can specify preset restriction on data by settin "Panoramio Tag" or/and "Panoramio UserID"
[[File:GM-Map-Detail-AdvancedOptions-2.png]]


* '''tag''' - a panoramio tag used to filter the photos which are displayed. Only photos which have been tagged with the supplied string will be shown.
[[File:GM-Map-Detail-AdvancedOptions-3.png]]
* '''userId''' - a panoramio user ID. If provided, only photos by this user will be displayed on the map.
* ''If both a tag and user ID are provided'', the '''tag''' will take precedence.


=== Advanced Options ===
{|class="zhpropertytable"
|-
|class="zhproperty"|Loading map objects dynamically||class="zhdescription"|Enable feature to load placemarks by AJAX<br />
* '''No'''
* '''JQuery'''
* '''Mootools'''
|-
|class="zhproperty"|Load type||class="zhdescription"|Type of loading placemarks, ie load it all, or depends on some conditions<br />
* All
* All (two steps: use map bounds, all the rest)
* Use map bounds
|-
|class="zhproperty"|Buffer size for placemarks ||class="zhdescription"|You can load placemarks by parts
|-
|class="zhproperty"|Loading content data dynamically||class="zhdescription"|Enable feature to load placemark infowin content by AJAX<br />
* '''No'''
* '''JQuery'''
* '''Mootools'''


[[File:GM-Map-Detail-AdvancedOptions.JPG]]
Ie your page can contains placemark creation code, but all infowin/infobubble content can be loaded dynamically.<br />
If placemarks loaded by AJAX it by default loads content dynamically too.  


{|class="zhpropertytable"
|-
|-
|class="zhproperty"|MarkerManager||class="zhdescription"|The enabled/disabled state of using Marker Manager<br />
|class="zhproperty"|MarkerManager||class="zhdescription"|The enabled/disabled state of using Marker Manager<br />
Line 471: Line 597:
|class="zhproperty"|Placemark Filter||class="zhdescription"|Restriction displaying placemarks on some rules.
|class="zhproperty"|Placemark Filter||class="zhdescription"|Restriction displaying placemarks on some rules.
|-
|-
|class="zhproperty"|Allow to user enter placemarks||class="zhdescription"|Enable registered users to create placemarks on map.
|class="zhproperty"|Allow to user enter placemarks||class="zhdescription"|Enable registered users to create and/or alter placemarks on map.
|-
|class="zhproperty"|Insert Allowed||class="zhdescription"|User can create new placemarks
|-
|class="zhproperty"|Update Allowed||class="zhdescription"|User can update existing placemarks
|-
|class="zhproperty"|Delete Allowed||class="zhdescription"|User can delete existing placemarks
|-
|-
|class="zhproperty"|New Placemark State||class="zhdescription"|Placemark Status for created user placemark.
|class="zhproperty"|New Placemark State||class="zhdescription"|Placemark Status for created user placemark.
Line 482: Line 614:
|-
|-
|class="zhproperty"|Additional CSS styles for loading||class="zhdescription"|List of CSS style files for loading when map is loading, separated by new line or semicolon
|class="zhproperty"|Additional CSS styles for loading||class="zhdescription"|List of CSS style files for loading when map is loading, separated by new line or semicolon
|-
|class="zhproperty"|Additional JavaScript files for loading||class="zhdescription"|List of JavaScript files for loading when map is loading, separated by new line or semicolon
|-
|class="zhproperty"|Placemark Rating||class="zhdescription"|Enable Placemark rating feature.
* '''No'''
* '''JQuery'''
* '''Mootools'''
|-
|class="zhproperty"|Map text override||class="zhdescription"|You can use this feature to override Standard text for map controls etc by using special interface in component administration area
|}
|}
==== 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 marker group for your markers
* set Min Zoom for Marker Manager and Max Zoom for Marker Manager for each group
* enable feature for the map


=== Geolocation ===
=== Geolocation ===


[[File:GM-Map-Detail-Geolocation.JPG]]
[[File:GM-Map-Detail-Geolocation.png]]


{|class="zhpropertytable"
{|class="zhpropertytable"
Line 509: Line 640:
* Icon and Text
* Icon and Text
|}
|}


=== Integration ===
=== Integration ===


[[File:GM-Map-Detail-Integration.JPG]]
[[File:GM-Map-Detail-Integration.png]]


{|class="zhpropertytable"
{|class="zhpropertytable"
Line 537: Line 666:
* fax
* fax
* email
* email
* website


You can enter it in any order, and by it the contact will be shown.
You can enter it in any order, and by it the contact will be shown.
Line 552: Line 682:
You can enable using user information and associate your placemark with user to display user information in placemark InfoWin.
You can enable using user information and associate your placemark with user to display user information in placemark InfoWin.
|}
|}
=== Display ===
[[File:GM-Map-Detail-Display.png]]
=== 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

Latest revision as of 19:00, 5 March 2020

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.
You can apply Zh Template Map FullScreen to your map page to show map in full screen or for the other cases

Map Details

Show Title as Placemark Show map title as a placemark
  • No - Do not show marker
  • Drop - Marker with animation (Drop)
  • Bounce - Marker with animation (Bounce)
  • Simple - Marker without animation
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
ie pair of coordinates separated by semicolon and in one coordinate has values separated by comma
The first coordinate - left bottom, the second - right top of bounds

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
  • Roadmap
  • Satellite
  • Hybrid
  • Terrain
  • OpenStreetMap
  • NZTopomaps
  • First Custom Map Type
Google Earth The enabled/disabled state of the Google Earth
  • No
  • Yes
  • Yes (Notify)
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
If you set Map Type to First Custom Map Type, then first ID will be default map type

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
  • No
  • Username
  • Date of creation
  • Date of creation and Username
  • Username (after toolbar)
  • Date of creation (after toolbar)
  • Date of creation and Username (after toolbar)
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


Map Footer

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


See Google Maps API Styled Map Wizard
Just press button Finish, copy code between [ and ] with them, and paste in this field

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
  • Yes
  • No
  • Yes (Open) - show overview map opened
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
  • Placemark title
  • Category title and ordering
  • Category title (descending) and ordering
  • User ordering index
  • Group title and Placemark title
  • Group title (descending) and Placemark title
  • Group user ordering index and Placemark title
  • Group user ordering index (descending) and Placemark title
  • Date of creation
  • Date of creation (descending)
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
  • No
  • Open InfoWin
  • Open InfoBubble
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.
It can be useful in bottom position and 100% map width

Height Placemark List Height in pixels
Position Values
  • No - there is no placemark list
  • ... - overlay on map
  • Left and Right - table layout
  • List-Map and Map-List - div layout
  • External - you can put ul-tag with id=GMapsMarkerUL in your place to define your place to show placemark list

For example, 

<ul id="GMapsMarkerUL" style="list-style-type: none;"></ul>
Style Values
  • Simple - predefined in CSS-file
  • Advanced - predefined in CSS-file
  • External - you can define it in your template
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;


I don't know is it true example, for all cases. But, for example, why not. I've replace start and end colors to mine. And, first background: we don't enter, because I do it.

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
  • Center - center map on placemark
  • Click - execute click function for placemark
  • Center, Animate - center map on placemark and animate placemark icon
  • Click, Animate - execute click function for placemark and animate placemark icon
  • Center, Animate and Click - center map on placemark, animate placemark icon and execute click function for placemark
Placemark List Content Text from which placemark list contains
  • Title - placemark title
  • Title and Description - placemark title and desciption
  • Title and Addition HTML text - placemark title and addition HTML text
  • Icon and Title - placemark icon and title
  • Icon, Title and Description
  • Icon, Title and Addition HTML text - placemark icon, title and addition HTML text
  • Icon, Title and Description (table) - table layout
  • Icon, Title and Addition HTML text (table) - table layout
  • Title and Image - placemark title and image (thumbnail)
  • Title, Image and Description
  • Title, Image and Addition HTML text
  • Image and Title
  • Image, Title and Description
  • Image, Title and Addition HTML text
  • Image, Title and Description (table) - table layout
  • Image, Title and Addition HTML text (table) - table layout
  • Table: Title - placemark title and table layout
  • Table: Title and Description - placemark title and description and table layout
  • Table: Title and Addition HTML text - placemark title and addition HTML text and table layout
Appearance Appearance of placemark list
  • Open List - placemark list is opened
  • Icon Button - additional icon button control on map
  • Text Button - additional text button control on map
  • Icon Button and Open List - additional icon button control on map and list is opened
  • Text Button and Open List - additional text button control on map and list is opened
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
  • No - there is not placemark control by group list
  • Left - List of group on the left (table style)
  • Right - List of group on the right (table style)
  • Top - List of group on the top (table style)
  • Bottom - List of group on the bottom (table style)
  • Group-Map - List of group on the top (div style)
  • Map-Group - List of group on the bottom (div style)
  • External - List of group in user defined position (special tag)
Group Type Behavior of group list
  • Toggle Group
  • Only One Active Group
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 title
  • Category Title and ordering
  • User ordering index
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
  • Text
  • Icon
  • Text and Icon
Display Show All and Hide All buttons Show buttons to show/hide all groups by one click
  • No
  • Text
  • Icon
  • Text and Icon
Search group field Display search field to find group in group list
Group CSS Type of group decoration

There are two predefined style
and one (external) – for you, which you can set style in you template. ID for tags depend on Group CSS field. See details in Placemark Grouping

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
  • Metric System (kilometers)
  • Imperial (English) System (miles)
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'


Google Places API: Supported Place Types

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


which can be either 'establishment' or 'geocode', representing businesses or addresses, respectively. If types is not specified, both types are returned.

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
  • No
  • JQuery
  • Mootools
Load type Type of loading placemarks, ie load it all, or depends on some conditions
  • All
  • All (two steps: use map bounds, all the rest)
  • Use map bounds
Buffer size for placemarks You can load placemarks by parts
Loading content data dynamically Enable feature to load placemark infowin content by AJAX
  • No
  • JQuery
  • Mootools

Ie your page can contains placemark creation code, but all infowin/infobubble content can be loaded dynamically.
If placemarks loaded by AJAX it by default loads content dynamically too.

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
  • No
  • Top - street view is located above the map
  • Bottom - street view is located below the map
Street View Style Style of Street View
  • Default - with default options
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.
  • No
  • JQuery
  • Mootools
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
  • Icon
  • Text
  • Icon and Text

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

  • name
  • position
  • address
  • city
  • suburb
  • state
  • province
  • country
  • postcode
  • zipcode
  • phone
  • mobile
  • fax
  • email
  • website

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


For example: position;name;mobile

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
Retrieved from "https://wiki.zhuk.cc/index.php?title=Template:Zh_GoogleMap_Description_Map&oldid=3884"