Zh GoogleMap Description

From Documentation
Jump to: navigation, search

Installation

Component is installed on Joomla! 2.5 (1.7, 1.6) in a standard way through the Extension Manager.


Component supports autoupdate feature

Options

You do not need to configurate it, because component runs on Google Maps JavaScript API V3.

When you create new map objects at the opening map is automatically calculated location, if can not be calculated, then displaying center of Palace Square in St. Petersburg (if not set default place).

Default place

You can set latitude and longitude of your default place in Options page

After that when you try to create new map, placemark, path in backend, position of marker on map will be set to default.


API Key for Google Earth

If you want to use the Google Earth feature, you must obtain a key for the Google Earth API and enter it.

Despite the fact, that you can use Earth API without key, in current release you have to set it, because I can't get Maps and Earth API integration work together without key. When I can - I'll correct code and you'll have the ability to use Earth API without API Key

Go to component page

Press (menu):

  • Components
  • Zh GoogleMap

GM-Map-Option-Position.JPG


Press "Options" button

GM-Map-Option.JPG


API Key for Google Maps

If you want to use the Google Maps API key for monitoring or billing overlimit quotas, you can obtain a key for the Google Maps API and enter it in Options page (like a Google Earth API Key)



Compatibility Mode

In some cases when on map is active Managing Placemarks by Group List, you can get an error
link.hasClass is not a function

It can be caused by conflict with JQuery and mootools in some templates
In this case you can activate compatibility mode, when calling methods hasClass and toggleClass is changed to JavaScript functions which do like the same.


Compatibility Mode for Resource Files

In some cases you restrict access to administrator folder. In this folder for component by default exists assets folder, which used for storing icons, css-files for component and plugin.

If you block access to it, then when users will try to see your map will get login screen.

And just for this case there is a component option Compatible Mode for Resource Files.

Just set it to yes, and all references in document, which contains map (created as a component, or as a plugin), will be to site assets folder. Do not move any files or folders, just use it.

And you have to copy icons from admin icons folder to site folder, because it is empty from installation (because if site folder will contain icons, then size of zip-archive of extension increase twice)

And if you want to use your icons for placemarks, you should copy your icons to both folders. In administrator folder icons will be used in backend (admin panel), and when displaying - from site folder.


Map Initialization Type

By default it is "onload". It meand the JavaScript function window.onload is defined as map initialization. By that function main initialization function is called.

On the other hand, it can be more then one extension, which used this function. For example, promo image banners, or some other plugins. And in this case, the last onload definition call will be used, ie previous is overridden.

For this case you can define to use "domready" type. In this case the mootools event listener for domready event will be used.


Creating Map

We turn to the tab "Maps".


GM-Map-List.JPG


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.

GM-Map-Detail.JPG


Map properties

GM-Map-Detail-MapDetails.JPG

Title Map title
Description Description
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
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

Latitude Map center Latitude
Longitude Map center Longitude
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

Zoom Initial Map Zoom
Min Zoom Min Zoom for Map
Max Zoom Max Zoom for Map
Draggable Enable/disable Map dragging
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

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 "featute", 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 Decoration

GM-Map-Detail-MapDecoration-Header.JPG

Header HTML-text HTML text on top of the map
Show Header Separator Show Separator after Header HTML text



GM-Map-Detail-MapDecoration-Footer.JPG

Show Footer Separator Show Separator before Footer HTML text
Footer HTML-text HTML text on bottom of the map


GM-Map-Detail-MapDecoration-Styles.JPG

Styles Styles for map

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

Map Controls

GM-Map-Detail-MapControls.JPG

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

from place witch is found by Find Control

Map Find Control (geocoding)

GM-Map-Detail-MapControls Find.JPG

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 witch is found by Find Control

Control Positions

GM-Map-Detail-ControlPositions.JPG

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

Map Properties for Placemarks

GM-Map-Detail-Placemarks.JPG

Show placemarks in cluster Create cluster for markers
Marker Cluster Zoom Level Zoom Level on which Cluster starts group markers
Group Placemarks in Cluster by Placemark Group Property Create cluster for each marker 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 Placemark Group List)


Map Properties for Placemark List

GM-Map-Detail-PlacemarkList.JPG

Width Placemark List Width in px

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 px
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 placemark
  • Click - execute click function for placemark
Placemark List Content Text from which placemark list contains
  • Title - placemark title
  • Title and Description - placemark title and desciption
  • Icon and Title - placemark icon and title
  • Icon, Title and Description
  • Icon, Title and Description (table) - table layout
  • Title and Image - placemark title and image (thumbnail)
  • Title, Image and Description
  • Image and Title
  • Image, Title and Description
  • Image, Title and Description (table) - table layout
  • Table: Title - placemark title and table layout
  • Table: Title and Description - placemark title and desciption 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

Managing Placemarks by Placemark Group List

GM-Map-Detail-PlacemarkGroups.JPG

Placemark 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)
Placemark Group Column Width Column width for the left or right position of list group
Show Placemark Group Show text, icon of group in list of group
  • Text
  • Icon
  • Text and Icon
Placemark Group CSS Type of group decoration

There are two predefined style in

/administrator/components/com_zhgooglemap/assets/css/markergroups.css

and one (external) – for you, which you can set style in you template. ID for tags depend on Placemark Group CSS field. See details in Marker 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

GM-Map-Detail-Route.JPG

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

Using Places Library

GM-Map-Detail-PlacesLibrary.JPG

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
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)

Using Panoramio Library

GM-Map-Detail-PanoramioLibrary.JPG

For using feature set enable by Enable using Panoramio = Yes

You can add filter control to map, and it's position.

And you can specify preset restriction on data by settin "Panoramio Tag" or/and "Panoramio UserID"

  • 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.
  • 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

GM-Map-Detail-AdvancedOptions.JPG

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 placemarks on map.
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

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

GM-Map-Detail-Geolocation.JPG

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

GM-Map-Detail-Integration.JPG

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

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.


Creating Placemark

We turn to the tab "Placemarks".

GM-Placemark-List.JPG

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.

GM-Placemark-Detail-Autocomplete.JPG


Placemark properties

GM-Placemark-Detail-PlacemarkDetails.JPG

Title Placemark Title
Description Description
Addition HTML text HTML text, that will be included in placemark

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. In this way, you can copy code, that produced by plugin and paste into HTML text, and in this case plugin will not change it.

Published Published
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 Group Placemark Group
Protected from user correction Protected placemark from user correction, when you activate creating users placemark
Category The category that this placemark is assigned to

Appearance properties

GM-Placemark-Detail-AppearanceProperties.JPG

Icon Type Icon Type
Marker Marker Type
  • No - Do not show marker
  • Drop - Marker with animation (Drop)
  • Bounce - Marker with animation (Bounce)
  • Simple - Marker without animation
  • Infographics Icon: Drop - Marker with animation (Drop) and dynamic icon
  • Infographics Icon: Bounce - Marker with animation (Bounce) and dynamic icon
  • Infographics Icon: Simple - Marker without animation and dynamic icon
Open InfoWin Execute action which described in Action by Click and Zoom by Click
InfoWin Content Content of InfoWin
  • Title and Description
  • Title
  • Description
  • None
Action by Click Action by Click on this placemark
  • Open InfoWin
  • Open Link - link, that entered in URL Site field
  • Open Link in new page
  • Open InfoBubble
  • Open Street View - open street view for placemark position (if feature enabled in map details)
  • None
Zoom by Click Zoom by Click on this placemark

You can change zoom when you click on marker

  • Do not change - zoom is not changed
Street View in InfoWin 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
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
Infographics Type Dynamic Icon Type

Example: chst=d_fnote&chld=thought|1|0088FF|h|Why+am+I+here?
See about Infographics (Dynamic Icons)

Infographics Icon width Dynamic Icon width
Infographics Icon height Dynamic Icon height

Integration

GM-Placemark-Detail-Integration.JPG

Contact Contact which associate with placemark
Show contact prompts Type of view contact information
  • No
  • Text
  • Icon
  • No prompts
User User which associate with placemark
Show user prompts Type of view user information
  • No
  • Text
  • Icon
  • No prompts


InfoBubble tabs

About InfoBubble see 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)

GM-Placemark-Detail-InfoBubbleTabs.JPG

Style Style for InfoBubble


GM-Placemark-Detail-InfoBubbleTab1.JPG

Title Tab Title
HTML Text Tab text

Hidden Attributes for Customization

GM-Placemark-Detail-HiddenFields.JPG


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.

After that will change component to display this data.

Go to file, that output information on site

com_zhgooglemap\site\views\zhgooglemap\tmpl\default.php

And add some code into section, which output placemark information.

This section you can find by words

	// Markers
	if (isset($this->markers) && !empty($this->markers)) 
	{
			
            foreach ($this->markers as $key => $currentmarker) 
            {

There are two place, where you have to change

1 - placemarks, defined by latitude and longitude

	if ($currentmarker->latitude != "" && $currentmarker->longitude != "")
	{

2 - placemarks, defined by text address (using geocoding) - else of this if clause

In table columns have names

attribute1

attribute2
...

attribute9

And in this section you can operate with its by access, for example

$currentmarker->attribute1


The same way you can change plugin to output data, but in plugin there is only one php-file, and you easy find it.

You can use this fields, for example, for integration with other systems or etc.

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 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.

Placemark 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 Placemark 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 Placemark Group CSS - which implements the following functionality:

  • the first two styles - predefined, and are in a file in the folder
/administrator/components/com_zhgooglemap/assets/css/markergroups.css
  • 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 Placemark Group Icon is used to display icons in the list of groups.


Creating Placemark Group

We turn to the tab "Placemark Groups".

GM-Group-List.JPG

Enter the number of marker groups.


Placemark Group properties

GM-Group-Detail-PlacemarkGroupDetail.JPG

Title Marker Group Title
Description Description
Published Published
Icon Type Icon Type
Override Placemark Icon Change icon of placemark to marker group icon
Override Cluster Icon Change icon of cluster when you create cluster for each marker group
Active in Placemark Group List Set Group state to active (show markers) when page displayed.
This parameter uses in case to show markers in group list (when use marker managing by group list)
Min Zoom for Marker Manager Zoom from which placemarks would be displayed by Marker Manager
Max Zoom for Marker Manager Zoom after which placemarks wouldn't be displayed by Marker Manager
Category The category that this placemark group is assigned to


Creating Route

The route means automatic routing between way points (this functionality is present in the Google Maps API as a Directions API).

We turn to the tab "Routes".

GM-Route-List.JPG

Enter any number of routes with reference to a specific map.

Field Route - the route is entered for each route point in double quotes ("), the separator between two points is a semicolon (;)


Route properties

GM-Route-Detail-RouteDetails.JPG

Title Route Title
Description Description
Addition HTML text Addition HTML text
Published Published
Travel Mode Travel Mode specifies what mode of transport to use when calculating directions
Unit System The unit system to use when displaying distance
Route Route value - text adderess waypoints in double quotes ("), separator between points is semicolon (;)

for example: "Арбатская";"Кропоткинская"; "Москва, проспект Мира 20";"Москва, Петровка 10"

Route by Placemarks Route by placemarks IDs, which separated by semicolon (;)

for example: 1;2;4;6
You have to use only placemarks defined by lat/lng, not by geocoding (text address)

Provide Route Alternatives Provide Route Alternatives specifies that the Directions service may provide more than one route alternative in the response.
Avoid Highways If true, the routes between origins and destinations will be calculated to avoid highways where possible.
Avoid Tolls If true, the directions between points will be calculated using non-toll routes, if possible.
Optimize Waypoints Optimize Waypoints to allow the Directions service to optimize the provided route by rearranging the waypoints in a more efficient order.
Map Title Title of the map, where route would be displayed
Show Type Map bounds for fitting the route
  • Zoom - Zoom to fit bounds of route
  • Unchange - Do not change viewport
Draggable If true, allows the user to drag and modify the paths of routes
Show Panel Allow to show route panel to display the directions steps
Show total distance Show total distance of route
Show description Show description and addition HTML text of route below the map
Suppress Markers Suppress markers, which created for start point, end point, waypoints
Category The category that this route is assigned to


Creating Path

The path means a polyline.

We turn to the tab "Paths".

GM-Path-List.JPG

Enter the necessary number of paths with reference to a specific map.

Field Path - a set of coordinates of points, the coordinates (Latitude, Longitude) are separated by comma (,), the points themselves - separated by a semicolon (;)

Coordinates it is convenient to choose by dragging the marker (values are substituted into the reference field in the form Current coordinates, from there you can copy and add a separator and value in the field Path), or clicking the mouse on the desired location.


In second part there will be described how draw polyline by tools and get values for path field.


Path properties

GM-Path-Detail-PathDetails.JPG

Title Path Title
Description Description
Addition HTML text HTML text, that will be included in infowin

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. In this way, you can copy code, that produced by plugin and paste into HTML text, and in this case plugin will not change it.

Published Published
Path Path

for example: 59.92335689062723,30.385787878185525;59.92374467628344,30.387547407299284

Object Type
  • Line - Polyline, which connects path coordinates
  • Polygon - Polygon (area), bordered by path coordinates
  • Circle - Circles, which have center in coordinates and have the same radius, defined by Radius field
Geodesic line Create Geodesic line (circle-shaped)
Color Line Color
for example: #FF0000
Weight Line Weight
Opacity Opacity, number value between 0.0 and 1.0
Fill Color Fill Color for Polygons and Circles
for example: #FF0000
Fill Opacity Fill Opacity for Polygons and Circles, number value between 0.0 and 1.0
Radius Circle radius in meters
KML Layer URL of the KML Layer, that would be displayed on the map
KML Layer Show Type Map bounds for fitting the KML layer
  • Zoom - Zoom to fit bounds of layer
  • Unchange - Do not change viewport
Map Title Title of the map, where path would be displayed
Category The category that this path is assigned to
Current coordinates Current coordinates

Create Path by drawing tool

The new feature added - drawing tool

On map there are new controls

GM-Path-Detail-CreatePolyline-Controls.JPG


You just simple draw polyline by clicking on points. Double click to stop drawing.

GM-Path-Detail-CreatePolyline-Polyline.JPG

When you finished draw, the Path field contain all coordinate values to build path.

If you wish to get some point coordinates, click on map in not drawing mode, and the field Current coordinates will contain it.

GM-Path-Detail-CreatePolyline-Polyline-Changed.JPG


The Google's Drawing Library doesn't supports creating polyline with predefined points, therefore component not display drawing tools when you save, but in this case path is displaying as a editable polyline for more useful management. You can change it, or correct coordinates. To remove this polyline - clear path field with coordinates and save, in this case there is drawing tools appear again

GM-Path-Detail-CreatePolyline-Polyline-Changed2.JPG


Creating Map Type

The map type means a custom map type for getting tiles.

We turn to the tab "Map Types".

GM-MapType-List.JPG

Enter the necessary number of map types.

See also: Google Maps JavaScript API v3 - Custom Map Types

Map Type properties

GM-MapType-Detail-MapTypeDetails.JPG

Title Map Type Title
Description Description
Min Zoom Min Map Zoom (for which exists tiles)
Max Zoom Max Map Zoom (for which exists tiles)
is PNG Type of tiles images
Tile Width Tile Width
Tile Height Tile Height
Get Tile URL function Implementation of function to get tile URL
Opacity Opacity
Layer Type Type of map layer
  • Map - it is Basemap
  • Overlay - it is Overlay type
Published Published
Category The category that this map type is assigned to

See also: Creating Custom Map Type Tutorial

Projection Definition

This additional section you can use to create your own map projections.

Lets check how to create Custom Map Type with Projection

GM-MapType-Detail-MapTypeDefinition.JPG

All fields in this sliders is text fields and for understand its purpose see tutorial Creating Custom Map Type Tutorial


GM-MapType-Detail-MapTypeDefinition-GlobalScope.JPG

GM-MapType-Detail-MapTypeDefinition-ProjectionScope.JPG

GM-MapType-Detail-MapTypeDefinition-LLP.JPG

GM-MapType-Detail-MapTypeDefinition-PLL.JPG

See also: Creating Custom Map Type Tutorial


Creating InfoBubble Style

About InfoBubbles see on page InfoBubble

We turn to the tab "InfoBubbles Styles".

GM-InfoBubble-List.JPG

Enter the necessary number of InfoBubble styles.


GM-InfoBubble-Detail-InfoBubbleDetails.JPG

Title Title of InfoBubble style
Description Description
Shadow Style Shadow Style
Padding Padding
Border Radius Border Radius
Border Width Border Width
Border Color Border Color

Example: #000000

Background Color Background Color

Example: #EAEAEA

Min Width Min Width (px)
Max Width Max Width (px)
Min Height Min Height (px)
Max Height Max Height (px)
Arrow Size Arrow Size (px)
Arrow Position Arrow Position (%)
Arrow Style Arrow Style
Disable Auto Pan Disable Auto Pan
Hide Close Button Hide Close Button
Background Class Name Background Class Name
Published Published
Category The category that this infobubble style is assigned to


See also Creating InfoBubble Tutorial


Creating StreetView Styles

The StreetView style you can use for customization StreetView for placemark with enabled ability to show street view, or define street view properties for map (when you show street view above or below the map)

We turn to the tab "StreetView Styles".

GM-StreetViewStyles-List.JPG


Enter the necessary number of StreetView styles.


GM-StreetViewStyles-Detail-StyleDetails.JPG

Title Title of StreetView style
Description Description
Published Published
Heading (default 0) defines the rotation angle around the camera locus in degrees relative from true north. Headings are measured clockwise (90 degrees is true east)
Pitch (default 0) defines the angle variance "up" or "down" from the camera's initial default pitch, which is often (but not always) flat horizontal. (For example, an image taken on a hill will likely exhibit a default pitch that is not horizontal.)Pitch angles are measured with positive values looking up (to +90 degrees straight up and orthogonal to the default pitch) and negative values looking down (to -90 degrees straight down and orthogonal to the default pitch).
Zoom (default 1) defines the zoom level of this view (effectively proscribing the "field of view") with 0 being fully zoomed-out. Most Street View locations support zoom levels from 0 to 3, inclusive.
Category The category that this streetview style is assigned to


GM-StreetViewStyles-Detail-PublishingOptions.JPG

Start Publishing Start Publishing date and time
Finish Publishing Finish Publishing date and time


Creating Weather Types

The Weather types you can use for adding on your map weather and/or cloud layers

We turn to the tab "Weather Types".

GM-WeatherTypes-List.JPG


Enter the necessary number of Weather Types.


GM-WeatherTypes-Detail-TypeDetails.JPG

Title Title of Weather Type
Description Description
Published Published
Category The category that this weather type is assigned to


GM-WeatherTypes-Detail-WeatherLayer.JPG

Show Layer Enable/disable show the layer
Clickable Enable receiving click event by layer
Suppress InfoWindows Suppress the rendering of info windows when weather icons are clicked.
Label Color The color of labels on the weather layer. If this is not explicitly set, the label color is chosen automatically depending on the map type.
  • Black
  • White
Temperature Units The units to use for temperature.
  • Celsius
  • Fahrenheit
Wind Speed Units The units to use for wind speed.
  • kilometers per hour
  • meters per second
  • miles per hour


GM-WeatherTypes-Detail-CloudLayer.JPG

Show Layer Enable/disable show the layer


GM-WeatherTypes-Detail-PublishingOptions.JPG

Start Publishing Start Publishing date and time
Finish Publishing Finish Publishing date and time


Creating AdSence

The AdSence you can use for displaying ads on map

We turn to the tab "AdSences".

GM-AdSense-List.JPG


Enter the necessary number of AdSence entries.


GM-AdSense-Detail-AdSenseDetails.JPG

Title Title of AdSense
Description Description
Published Published
Map Title Map for displaying AdSence
Publisher ID Publisher ID
Channel Number Channel Number
Unit Position Unit Position
Unit Format Unit Format
Category The category that this AdSense is assigned to


GM-AdSense-Detail-PublishingOptions.JPG

Start Publishing Start Publishing date and time
Finish Publishing Finish Publishing date and time


Creating Category

You can go to the tab "Categories" and add categories to the component.

Then you can walk on the map objects and tag them by category.

On the basis of categories can be further in any way extend the functionality of the component


Displaying the Map

Create a menu item and select the type of Zh GoogleMap - Map.

GM-Menu-List.JPG


Select the appropriate map.

GM-Menu-Select.JPG

Map Title Map Title for displaying
Placemark List List of placemark IDs, separated by semicolon. By this feature you can display placemarks from different maps, or only wanted placemarks from "big" map

Leave it empty to show map as configured in component

Placemark Group List List of placemark group IDs, separated by semicolon. By this feature you can display placemarks from different maps

Leave it empty to show map as configured in component

Category List List of category IDs, separated by semicolon. By this feature you can display placemarks from different maps

Leave it empty to show map as configured in component


See also

Icon-attachment.pngPlugin for component

Icon-attachment.pngModule for component



Language: English  • русский