• Documentation
  InstallationUsing the Kentico interfaceDeveloping websitesConfiguring KenticoManaging usersSecuring websitesDeploying websitesManaging website contentMultilingual websitesMacro expressionsExternal utilitiesIntegrating 3rd party systemsCustom developmentE-commerce featuresOn-line marketing featuresCommunity featuresRunning Kentico on Microsoft AzureUsing Amazon web services with KenticoCertified extensionsReferencesRelease notes - Kentico 10
• Tutorial
  Getting started with KenticoUsing the Kentico interfaceSite development overviewCreating a new websiteAdding styles to the websiteWorking with the Pages applicationCreating the master pageCreating website pagesCreating page templatesNext steps
• API Examples
  Content managementOn-line marketingE-commerceSocial and CommunityDevelopmentConfiguration

• Two fields representing latitude and longitude. 
  —OR—
• A field or multiple fields representing an address in a human readable form.

You can use the predefined CMS.Office page type to load data onto a map. You can also use the page type as a reference when creating your own page types.

Placing a page-related map on a page

1. In the Pages application,navigate to the page on which you want to display the map.

2. Switch to the Design tab.

3. Place the Google maps or the Bing maps web part on the page. The web part properties dialog opens.

4. Specify the Path to the pages from which you want the map to load data.

5. Select the Page types that you want the map to load. For example, CMS.Office.

6. Load: a. a human-readable address onto the map

   If you want the map to use a human-readable address, specify the Field name that the Page types use for location in the Location field property. For example, OfficeAddress in the CMS.Office page type loads the first address line. You can also specify multiple field names separated by semicolons, for example, OfficeAddress;OfficeCity, if the whole address is divided into more than one field.

   • You can select the Use server processing option if you want the server to process and cache the processed (translated to latitude and longitude) Location or address field. If you decide to do so, please check that your map service query limits (IP-based) are sufficient for your needs.

   —OR—

   b. coordinates onto the map

   If you want the map to use coordinates, specify the Field names that the Page types use for longitude and latitude in the Longitude field and Latitude field properties. For example, OfficeLatitude and OfficeLongitude in the CMS.Office page type.

   • Using latitude and longitudeallows the system to process the location faster. These properties can also be more accurate.

7. Fill in either the Default l****ocation or address or the Default****Latitude and Default****Longitude fields. These fields represent the map's initial view location.

8. Specify the rest of the web part properties, especially in the Transformation, Content, and Map properties categories. Hover over a property to see its description.

9. Click OK.

The page now displays a map with markers at the locations retrieved from the page fields you specified. For example:

Data source maps

Data source maps allow you to display multiple places on a map. The places that the map displays are loaded from a predefined data source web part. The usual example is a Page data source web part, which the map uses to load data from a list of pages. Each of the pages can represent a different company office, for example. By default, the CMS.Office page type can be used for this purpose, but any page type with fields specifying a geographical location will do. The web part (Basic Google maps web part or Basic Bing maps web part) then loads the geographical coordinates off of these pages and displays them on the map.

The process consists of the following:

1. Setting up the pages from which the map loads data.
2. Placing a data source that defines which pages are loaded into the map
3. Placing a data source map on a page.

Pages from which you can display data on a map

The pages from which you can display data on a map need to have fields that represent a geographical location. These pages need to have either of these:

• Two fields representing latitude and longitude. 
  —OR—
• A field or multiple fields representing an address in a human readable form.

You can use the predefined CMS.Office page type to load data from onto a map. You can also use the page type as a reference when creating your own page types.

Placing a page data source

1. In the Pages application,navigate to the page on which you want to display the map.
2. Switch to the Design tab.
3. Place the Pages data source web part on the page. The web part properties dialog opens.
4. Specify the Path to the pages from which you want the map to load data.
5. Select the Page types that you want the map to load. For example, CMS.Office.
6. Click OK.

You can now connect the data source to a map web part.

Placing a data source map on a page

1. In the Pages application,navigate to the page on which you want to display the map.

2. Switch to the Design tab.

3. Place the Basic Google maps or the Basic Bing maps web part on the page. The web part properties dialog opens.

4. Enter the Data source name.

5. Load:

   a. a human-readable address onto the map

   If you want the map to use a human-readable address, specify the Field name that the Page types use for location in the Location field property. For example, OfficeAddress in the CMS.Office page type loads the first address line. You can also specify multiple field names separated by semicolons, for example, OfficeAddress;OfficeCity, if the whole address is divided into more than one field.

   • You can select the Use server processing option if you want the server to process and cache the processed (translated to latitude and longitude) Location or address field. If you decide to do so, please check that your map service query limits (IP-based) are sufficient for your needs.

   —OR—

   b. coordinates onto the map

   If you want the map to use coordinates, specify the Field names that the Page types use for longitude and latitude in the Longitude field and Latitude field properties. For example, OfficeLatitude and OfficeLongitude in the CMS.Office page type.

   • Using latitude and longitudeallows the system to process the location faster. These properties can also be more accurate.

6. Fill in either the Default l****ocation or address or the Default****Latitude and Default****Longitude fields. These fields represent the map's initial view location.

7. Specify the rest of the web part properties, especially in the Transformation, Content, and Map properties categories. Hover over a property to see its description.

8. Click OK.

The page now displays a map with markers at the locations retrieved from the pages you specified in the Page data source web part. For example: