Knowledge Base - Getting Started Guide

Basic map configuration

Introduction

In this chapter you will find some information on how to create a basic map. To learn more advanced features, please got the the Geocode Factory Concepts chapter of the documentation.

Map managercarte

The map manager allows you to create Google maps. This is where the options are set to display them.

gf2

Note : the map ID (before Joomla 1.6, this needed to be set manually in the modules, or menus) is visible in the map list shown above.

When you create a map, you see a form that contains different tabs. Below the tabs, you will see the resulting map. To create a working map, you  need to set several options (some are already set to default), see bellow the main settings :

  • Name : This is a name of the map
  • Width/Height : Value in or % pixels defining the size of the map.
  • Template : Represents the design around the map, and where you place the map. For now, write [map] in this textarea (you will find more info about map templates in the Advanced map template chapter in advanced Geocode Factory features article)
    tuto_map_settings
  • Published : Allows you to set whether the map is published or not.
  • Duplicate markers : if you use any markerset selector, this option need to be set to 'All', see the 'Working with directories and categories' chapter in the Geocode Factory advanced features article to understand this concept.
  • Number of markers : Limit the number of marker on the map. Set to "0" to show all.
  • Latitude and longitude center : Sets the default center of the map. You can choose this value by picking a point on the example map. It's strongly advised to select a default coordinates, event if you use another method to center the map, then in case of problem, the user will at least land where you have selected.
  • Center on : Sets the center of the map on the current registered user, fixed point, all markers or the browser location. The 'browser location' option require that the end user allow this with his browser. If not, the map is centered on the default coordinates.
  • Google Options : These options interact directly on the design of the map. You simply apply the changes to see the result on the sample map.
  • Zoom range : Sets the zoom range level, for the maximum and minimum zoom level.
  • Cluster : Activate and set the parameters for clustering. Clustering groups markers that are near each other to clean up the map display. See the clustering with Geocode Factory chapter in the Geocode Factory advanced features.
  • Show lines between my addresses : if you allow multiple address per profile you can connect the different user’s address (home / office / …) with a line see How multi address work.
  • KML: here you set some KML, KMZ and/or geoRSS url separated by commas ',' and starting with http://.
  • Cache duration : See how to use the cache in the Google maps chapter to understand how this work.
  • Different map type / tiles : see the how to use openstreet map or other map types detailled article.
  • Use tabs : see the detailled article about Google map bubble templating
  • Use gallery : see the detailled article about Google map bubble templating.
  • Bubble and radius actions : Select the desired mouse interactions, as example, you can open the bubble with right mous button, or do not allow bubbles.
  • Radius : see How the radius settings work.
  • Select the layers to load : This option allows you to select what additional layers you can load on your map. It’s possible to load the cycle, traffic, transit, weather (°C/°F) and clouds. You can load multiples layers at once. Note: the clouds are only vsibible at high zoom levels.
  • Map style in JSON format : This is an area where you can customize the “Style” of a Google map. You can read more about this here: styling page. With this option you can customize your map, add styling options like water areas, simple roads or a country limit, etc. It can be fine tuned for color, width and other things! Simply click on the style wizard link (style wizard) provided into the label area, and build your styles. When your are ready, on the bottom of the style list, click the “JSON preview” button, then copy-past the result in the textarea for this option.
  • Mouse behavior :select what mouse actions have what behavior. For example you can define that the sales area circle is displayed when the mouse flies over the marker or open the marker bubble when you right click on the marker... These are the main options :
    • Bubble opening : defines how you want to open the markers bubble
    • Circle center : defines how to to set the radius circle center
    • Sales area : defines how to draw the sales area (see the radius article)
    • GPS Track : defines how to draw the GPS tracks
    • Zoom on tracks : specific to GPS Tools markers. When any track/route is displayed (after clicking on the marker, fly over, ...), the map is zoomed to show the whole track.
  • Country limiter : This is used for the fronted radius search form, where the user can type any location and select a radius, and the maps zoom and load only the markers in this area. With this option you can filter the prediction (autocompletion) of places in one defined country. Simply enter here the ISO 3186 country code in 2 digits (us = USA, fr = France, ...).
  • Prediction type : Allows you to select between 3 different types of autocompletion prediction in the frontend radius search : “All”, “Cities” or “Business”. 

Applies To

Geocode Factory 3