Business Map2
User Guide
2010-5
User Guide
Table of content
1.
Introduction .................................................................................................................... - 3 -
2.
Installation/Upgrade ....................................................................................................... - 4 -
3.
Settings .......................................................................................................................... - 6 -
4.
Define Icons ................................................................................................................... - 6 -
5.
Create a map ................................................................................................................. - 7 -
6.
Add/Edit Location ........................................................................................................... - 8 -
7.
Import locations from CSV file ..................................................................................... - 10 -
8.
Get locations from Database ....................................................................................... - 10 -
9.
Get a map in URL ........................................................................................................ - 11 -
10.
Map Link ................................................................................................................... - 11 -
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
-2-
User Guide
1. Introduction
This module integrates Google map API into DotNetNuke to provide map service for
DotNetNuke web site. It’s very easy to use. It can be installed and configured in few minutes.
You can create maps in one module. Then you can use map id in URL to show different map.
As business map, you can define custom icons for marks. And you can add different locations
for different map levels.
The living demo of this module is here:
http://demo.zldnn.com/bizmap/BusinessMap2/tabid/156/mapid/1/mapmid/576/Default.aspx
Features:

Manage several maps in one module.

You can add locations into one map.

There can be different locations for different levels.

Integrate geo coding to get latitude and longitude by address.

You can set description for each location. The description can be shown when the mark is
clicked.
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
-3-
User Guide

You can set map width and height.

You can set custom icons.
New in 5.0:

Encode address to latitude and longitude dynamically. You can quire address only from
database to show locations. There is no problem if there is no latitude and longitude data.

[PORTALID],[MODULEID],[TABID],[USERID] tokens in SQL statement.

Can accept search query from URL: q=query.

Add a new field: title. That can be shown in side bar.
New in 5.2

Now the side bar supports pagination.

Supports default map type.
New in 5.5:

A check box list of icons can be shown under the Map. Users can select to display
markers that have a same icon.

Import locations from CSV file.

Fix the issue of zoom in and zoom out.

Improvement of side bar.
2. Installation/Upgrade
Please install Business Map first, and then you can install the Business Map 2.
Install modules as you would a normal DNN Module; no other configuration is needed.
1. Login in as Host.
2. Go to Host->Module Definitions.
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
-4-
User Guide
3. Select “Install New Module” from the drop down menu.
4. Select the download PA and click “Install New Module”.
5. You can see installation message.
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
-5-
User Guide
3. Settings
Google Map API Key: you should apply Google map API key to use the module. You can visit
http://code.google.com/apis/maps/signup.html for more details. The module allows you to
assign more API to an instance so it can work for multi domains. Please use "," to split the
keys and split the domain and key by ":". For example:
www.zldnn.com:myapik1,www.zldnnmodule.com:myapikey2.If there is no domain name, it will
the default API.
Default Map: you can select a default map here.
Show Side Bar: you can select show the title of markers in side bar.
Markers Page Size: you can set the page size of the markers in side bar.
4. Define Icons
You can define your own icons for the locations in a map. Go to the icon list page you can see
all icons.
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
-6-
User Guide
You can add a new icon by clicking “Add” link or edit an existing one by clicking the pencil icon
left of the title.
5. Create a map
You can create a new map by clicking Add Map item in module menu. And you can click Map
List to manage all maps.
Map Width and Map Height: the size of Google map in the module.
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
-7-
User Guide
Latitude and Longitude: the latitude and longitude of center point.
Zoom level: the zoom level is from 1 to 17.
Default icon: You can set default icon for markers.
Get Locations from database: you can select get location marks from database.
SQL: the SQL statement that gets marks. See next section “Get locations from Database”.
6. Add/Edit Location
In map list, you can click the Mark List link of each map to manage locations of each map.
.
You can add a new location by clicking “Add” link or edit an existing one by clicking the pencil
icon left of the address.
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
-8-
User Guide
ZoomFrom, ZoomTo: the location will be shown in map when the zoom of map is between
ZoomFrom and ZoomTo.
Address: the address of location.
Title: The title of the location.
Latitude and Longitude: you can click the “Get lat&lng” link to get the values by address.
Set as map center: the point can be set as the center of the map.
Description: the description of the location. It can be html code. When users click the mark of
location, the description will be shown.There are two tokens you can used in
description:[TORUL:<target>,<text>] and [FROMURL:<target>,<text>]. These tokens will
generate link to google direction search page. The <target> is target of browser, for example:
_blank. The <text> is the text of the link.
Icon: you can select a defined icon for the location.
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
-9-
User Guide
7. Import locations from CSV file
From 5.5 version, you can import locations from CSV file.
Before you upload a CSV file, please go to Host->Host Settings->Advanced Settings->Other
Settings, to check the File Upload Extensions, make sure the “csv” type included in this
setting.
The fields in CSV file can include title,address,description,latitude,longtitude,zoom from and
zoom to. You can set the order of the field in the text boxes. If there is no a field, you can leave
the text box blank. The Zoom From, Zoom To and description are optional. If you have address,
the Latitude and Longitude can be optional. And if you have Latitude and Longitude, the
address can be optional.
8. Get locations from Database
The super user of your web site can define the SQL statement to get location from database.
The SQL Statement should include below fields:
Title: the title of the location.
Address: the address of the location.
Description: the description of the location.
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
- 10 -
User Guide
Lat: the latitude of the location.
Lng: the longitude of the location.
Icon: the URL of the location icon in the map.
Iconwidth: the width of icon.
Iconheight: the height of icon.
There is a demo SQL Statement:
select title,lat,lng,description, 'http://www.zldnn.com/portals/0/zldnn.gif' as icon from
dnn_ZLDNN_BusinessMap
The SQL statement should include position data. That means it should include at least
one field: address. Or it should include lat and lng. Other fields can be omitted.
You can use [PORTALID],[TABID],[MODULEID] and [USERID] as token in SQL statement. It
can replace them to current values when executing the SQL statement.
You can add parameters in SQL statement and pass the value of parameters from URL. The
token of parameter is [URLPARA:<parametername>,<defaultvalue>]. For example, select
title,lat,lng,description, 'http://www.zldnn.com/portals/0/zldnn.gif' as icon from
dnn_ZLDNN_BusinessMap where moduleid=[URLPARA:mapmid,513]
Here the parameter name is mapmid, the default value is 513. If there is a parameter named
“mapmid” in ULR, it will get the value and pass in the SQL statement, if not, it will use default
513.
9. Get a map in URL
You can get a map by add mapid=<id> in url, for example,
http://localhost/dnn450new/BMap2/tabid/122/mapid/3/Default.aspx. The moduel will show the
map which id is 3.
10.
Map Link
There is a sub module – Business Map 2 Link that can generate all map links. You can assign
a business map 2 in module settings. Then the module will generate all map links.
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
- 11 -
User Guide
Copyright © 2004-2010 – ZLDNN.COM – All Rights Reserved
- 12 -