Google Map

Last Updated: 03 Feb 2018

google_map|asset|5.4.5.0

The Google Map asset allows you to embed a map on your site that users can view and navigate with. Locations can be plotted on your map sourced from a pool of Google Map Location assets.

Once created, you can configure the settings of your Google Map asset on its associated asset screens. These screens are often the same or similar to those for a Standard Page or Asset Listing and are described in either the Asset Screens or Asset Listing manual. In this chapter, we will describe the Details and Listing Options screens, which are different for a Google Map.

Additional Dependant Assets

The dependant assets of the Google Map
Additional Dependant AssetsWhen you create a Google Map asset, several assets are automatically created beneath it, as shown in the figure to the right. You can use these assets to define the contents and layout of the Google Map.

  • Page Contents: this Bodycopy is used to define the overall layout of the Google Map page including where the map is positioned, a heading for the page and information about the map. This Bodycopy is used when there are locations being listed by the Google Map asset.
  • Page Contents (No Results): this Bodycopy is used to define the overall layout of the Google Map page and is used when there are no locations being listed by the Google Map asset.
  • Popup Window: this Bodycopy is used to define the layout of the pop-up shown when users click a location on the Google Map.

Please note that the additional dependant assets that are created under the Google Map are similar to the dependant assets created under an Asset Listing page. For more information on these assets, refer to the Asset Listing manual.

Details Screen

The Details screen for the Google Map asset allows you to set up the map. For more information about the Status, Future Status, Thumbnail and Details sections of this screen, refer to the Details chapter in the Asset Screens manual.

Map Settings

This section allows you to change the general settings of the Google Map asset.

The Map Settings section of the Details screen
The Map Settings section of the Details screen

The fields available are as follows:

  • API Key: enter your Google Map API key. An API key allows you to embed Google maps on your website and must be configured to your specific web URL. For more information on obtaining an API key, visit the Google Code website.
  • Enable root nodes toggling: select whether or not users will be able to toggle between the
    different root nodes set on the Listing Option screen. The Toggle Root Nodes keyword
    replacement needs to be placed on the Page Contents Bodycopy for this to work.
  • Enable Create Location: select whether or not users will be able to add a searched Google
    Map location on this map, using an Asset Builder. If this field is set to Yes, the Asset Builder must be configured and placed on the Page Contents Bodycopy along with an address finder and a new address list. For more information on setting up an Asset Builder, refer to the Other CMS Assets manual.
  • Enable Geocoding Service: select whether or not to include geocoding. Geocoding is the conversion of street addresses into geographical coordinates. This is required when using the address finder search bar.
  • Enable Standalone Street View: TO DO ... Street View shows panoramic photos from the position of certain streets in Australia and other parts of the world. The Street View window, Street View overlay and toolbar keyword replacements need to be placed on the Page Contents Bodycopy for Street View to work.
Default Settings

This section allows you to configure the default appearance of the Google Map.

The Default Settings section of the Details screen
The Default Settings section

The fields available are as follows:

  • Default Map Center: select the default location that will appear when the map is first accessed.
    Enter the latitude, longitude and zoom level of the desired default location by selecting the location from the Google Map accessed via the blue globes. These globes will only be available after entering a valid API key and clicking Commit.
  • Default Map Type: select the type of map that will appear when the map is first accessed. The following fields are available:
    • Road Map: this map is a basic map showing the road and street names.
    • Satellite Map: this map is composed of satellite images taken of Earth.
    • Hybrid Map: this map is a hybrid of the Normal Street Map and the Satellite Map, showing road and street names on the satellite image map.
    • Terrain Map: this map is a street map showing features of geography such as mountains.
  • Default Marker Icon URL: select a URL for the default location icon. By default, the default Google icon will be used.
  • Default Icon Size: select this size of the marker icons. By default, this field is set to 25 pixels wide and 25 pixels high.
Map Initialisation

This section allows you to view and edit the code for the Map View Initialisation and Street View Initialisation.

The Map Initialisation Settings section of the Details screen
The Map Initialisation section

The fields available are as follows:

  • Map Initialisation: this field allows you to modify the default code for the Google Map
    initialisation. For example, you could add a border for the map here. This code is accessed with the Google Map Initialisation keyword replacement on the Page Contents and Page Contents (No Results) Bodycopies.
  • Standalone Street View Initialisation: this field allows you to modify the default code for the Street View initialisation. For example, the width and height of the Street View window can be changed here. This code is accessed with the Street View keyword replacement on the Page Contents and Page Contents (No Results) Bodycopies. The Street View Initialisation field can only be changed if the Enable Street View field on the Details screen is set to Yes.

Listing Options Screen

This screen allows you to configure the list of locations on the Google Map. This screen is similar to the Details screen of an Asset Listing. For more information on the Asset Locations, List Formatting, Customise Bodycopies, List Position Settings, Structured Root Selector Options and Button Text sections, refer to the Details Screen chapter in the Asset Listing manual.

Asset Selection

This section allows you to define which asset types to list on the Google Map and what their Status must be to be included in the list. This is most useful when displaying locations on your map with the Google Map Location asset.

The Asset Selection section of the Listing Options screen
The Asset Selection setting of the Listing Options screen

The fields available are as follows:

  • Asset Types to List: select the types of assets to list on the Google Map page. To select more
    than one asset type, click on the More... button. An additional list will appear on the screen. You can also check the inherit box to specify that the Google Map page should include all child types of the selected asset type. If an asset type other than a Google Map Location is selected, Keyword Mapping settings will appear on the screen, once clicking Commit. The fields available in this section are as follows:
    • Location Name keyword: enter the keyword replacement for the name of the location.
    • Latitude keyword: enter the keyword replacement for the latitude metadata of the location.
      This will be used to plot the location on the Google Map.
    • Longitude keyword: enter the keyword replacement for the longitude metadata of the
      location. This will be used to plot the location on the Google Map.
    • Description keyword: enter the keyword replacement for the description metadata of the
      location. This will be shown when users click a location on the Google Map.
    • Icon URL keyword: enter the keyword replacement for the icon URL metadata of the
      location. This will overwrite the default icon for a location on the Google Map.
    • Address keyword: enter the keyword replacement for the address metadata of the location.
      This will be used to plot the location on the Google Map. For more information, refer
      to the Using Other Assets as Locations chapter in this manual.
  • Asset Statuses to List: select the Status the asset must be to be included on the Google Map
    page. For example, if you want to show all assets that are Under Construction and Live in the list, select both of these Statuses. To select multiple Statuses, hold down the Ctrl key on the keyword and click on the Status in the list. If no Statuses are selected, the Google Map will work out which assets to show based on the permissions of the user viewing the page. For example, if a public user is viewing the page they will only be able to see the Live assets that have Public Read Permission granted.
  • Asset Access to List: select what permission the user must have on the asset for it to be included in the list. For example, if you select Write, it will only show the assets that the user has Write Permission for. Include effective permissions allows you to select whether or not the user only sees the assets if they have that specific permission. For example, if you select Write and select Include effective permissions, it will show the assets that the user has Write and Admin Permission on. If you deselect this option, it will only show the assets the user has Write Permission on.
  • Exclude Assets: select which assets from the Asset Map to exclude from the Google Map page. For example, if you do not want to show the Home page in the list, select it from the Asset Map in this field.

Page Contents Bodycopy

The Page Contents Bodycopy is used to define the layout when there are locations being listed by the Google Map page. The default layout of a Google Map page with listed locations is shown in the figure below.

The Default Layout of the Google Map
The default layout of a Google Map page with listed locations

To change what information that is being show, right click on the Page Contents Bodycopy in the Asset Map and select Edit Contents. Click on the edit icon icon – the WYSIWYG Editor will appear where you can use the keyword replacements and formatting to layout the information to show on the Google Map page. By default, the information shown in the figure below will appear in the WYSIWYG Editor.

The WYSIWYG Editor on the Page Contents Bodycopy
The WYSIWYG Editor on the Page Contents Bodycopy

Keyword Replacements on the Page Contents Bodycopy

A list of keyword replacements is provided in the WYSIWYG Editor toolbar on the Edit Contents screen of the Page Contents Bodycopy. You can use these keyword replacements in conjunction with text, images and links etc to layout what to show for the list of results. The standard keyword replacements that are available include the following:

  • Google Map Initialisation: this will show the Google Map.
  • Google Map Street View Window: this will show the Street View window. For the Street View
    window to work, the Enable Street View field in the Details screen must be set to Yes.
  • Google Map Toggle Street View Overlay: this will show a hyperlink to toggle the Street View
    overlay. This will highlight the areas on the Google Map where Street View can be used.
  • Google Map Toggle Street View Window: this will show a hyperlink to toggle the Street View
    window.
  • Google Map Toggle New Address List: this will show a hyperlink to toggle the new address
    list.
  • Google Map Toggle Tool Bar: this will show a hyperlink to toggle the tool bar. The tool bar
    includes the following fields.
    • Navigate Map: when selected, this will allow users to navigate the map as normal. By
      default, this button is selected on the tool bar.
    • Add Marker: when selected, this will allow users to add markers on the map.
    • Street View: when selected, this will allow Street View to be used.
    • Mouse Zoom Scroll: when selected, this will allow the zoom controls to be accessed with the
      mouse scroll button.
  • Google Map Toggle Address Finder: this will show a hyperlink to toggle the address finder.
  • Google Map Toggle Asset Types: this will show a hyperlink to toggle the different asset types
    of locations plotted on the map. For example, Toggle Google Map Location or Toggle Data
    Record.
  • Google Map Toggle Root Nodes: this will show a hyperlink to toggle the different root nodes of
    locations plotted on the map. For example, Toggle Site or Toggle Locations Folder.
  • Google Map Address Finder: this will show the address finder. This will give users the ability to
    search the map by entering an address or place of interest. The geocoding service must be
    enabled for the address finder to work.
  • Google Map New Address List: this will show the new address list. This will make a list of any
    locations searched with the address finder for that particular session. If Enable Create
    Locations is set to Yes, this list can be used to input coordinates into an Asset Builder.
  • Google Map Asset Builder: this will provide the html to allow an asset builder to nest in the Google Map page, allowing users to create their own locations on the map. This keyword
    replacement requires sourcing of the html code and manual nesting of the Asset Builder.
  • Google Map Get Closest Location: this will show a hyperlink to connect a marked location on
    the Google Map to the marked location it is closest to.
  • Google Map Clear New Markers: this will show a hyperlink to clear any new markers that have
    been made on the Google Map during that session.
  • Google Map Map Type Menu: this will show the map type menu. This will allow users to switch
    between the various map types, such as Satellite and Hybrid.

Page Contents (No Results) Bodycopy

The Page Contents (No Results) Bodycopy is used to define the layout of the Google Map page when there are no locations to show. To change the information that is being show, right click on the Page Contents (No Results) Bodycopy in the Asset Map and select Edit Contents. Click on the edit icon icon – the WYSIWYG Editor will appear where you can use the keyword replacements and formatting to layout the information to show on the Google Map page. By default, no information will appear in the WYSIWYG Editor.

The Default Layout of the Google Map Location
The default layout of the Popup Window

The Popup Window Bodycopy is used to define the layout of the pop-up window that appears when a location is clicked on the Google Map. The default layout of a Popup Window is shown in the figure to the right.

To change what information is being show, right click on the Popup Window Bodycopy in the Asset Map and select Edit Contents. A Raw HTML Content DIV will appear appear you can use keyword replacements and HTML code to format the layout of the content. By default, the information shown in the figure below will appear in the Raw HTML Content DIV.

The Raw HTML Content DIV on the Popup Window Bodycopy
The Raw HTML Content DIV on the Popup Window Bodycopy

Keyword Replacements on the Popup Window Bodycopy

A list of keyword replacements is provided in the list on the Edit Contents screen of the Popup Window Bodycopy. You can use these keyword replacements in conjunction with text, images and links etc to layout what to show for the list of results. The standard keyword replacements that are available include the following:

  • Asset Location Name: this will show the name of the location.
  • Asset Location Longitude: this will show the longitude coordinates of the location.
  • Asset Location Latitude: this will show the latitude coordinates of the location.
  • Asset Location Description: this will show the description of the location.
  • Asset Location Icon URL: this will show the URL of the icon assigned to the location.

Previous Chapter Next Chapter

Send Feedback

Noticed an error?
Want to suggest an improvement?

Let Us Know

The Latest

Let Us Know What You Think

Let us know if you spot any errors or if you have any ideas on how we can improve the Matrix Community Website.

Contact Squiz for Demo

Let us show you the true power of Squiz Matrix by giving you a personalised demonstration.