SugarCRM SupportProduct GuidesSugar Versions12.0 Sugar12.0 Sugar SellSugar Sell 12.0 Application GuideUser InterfaceSugar Maps

Sugar Maps

Overview

Using Sugar Maps, our integration with Microsoft Bing Maps, you can quickly see which records are in close proximity to each other, plot records on a content-rich map, and generate driving directions between records.

Features

Sugar Maps includes the following features:

Prerequisites

  • Sugar Maps is available on Sugar Premier 12.0.0 or higher. Sugar Maps can also be purchased as an add-on with other license types. 
  • Some features of Sugar Maps must be initially configured by a System Administrator. For more information on Sugar Maps configuration, refer to the Configuring Sugar Maps section of the Sugar Maps administration guide.        

Getting Started With Sugar Maps

To get the most out of Sugar Maps, you can set your user profile address to map directions between records and your location, configure the measurement unit you want to use when filtering records by proximity, and manually geocode records if needed.

Setting Your User Profile Address

With Sugar Maps, you can map directions from your location to another record or records. Your location is based on the address set in your user profile. For more information on editing your user profile, refer to the User Preferences section of the Getting Started documentation.

Note: For SugarIdentity-enabled instances, the address for a user's profile can only be edited by a System Administrator. 

Setting Your Measurement Unit

When filtering records by proximity, you can choose to display measurements in Sugar Maps in kilometers or miles.

Note: The measurement unit used for driving directions between points can only be set up by a System Administrator. For more information on this setting, please refer to the Setting the Measurement Unit for Driving Directions section of the Sugar Maps administration guide.

The measurement unit used when filtering records by proximity is set by the user and is user-specific. To set the measurement unit for a module list view distance filter you will use the dropdown in the filter settings.
muforfilter
To set the measurement unit for a Maps subpanel you will use the dropdown in the subpanel.

subpanelmu   

Manually Geocoding Records

A goecode is the latitude and longitude of a record's physical location. If needed, you can work to manually change a record's geocode from a record view. 

Use the following steps to change a record's geocode manually: 

  1. Navigate to a Sugar Maps enabled record, open the Actions menu and select the Geocode action.
    Sugar Maps manual geocode nav 
  2. Click a specific location on the map or search for a specific address to change the geocode value.
    sugar maps geocode action
  3. Once you have the correct location, click the Save button.
  4. If the record has been previously geocoded, a warning message will appear asking you to confirm that you want to overwrite the existing geocode value.

Note: Manually geocoding a record will only update the geocode value used with Sugar Maps and will not update any mapped address fields.

Using Sugar Maps

Mapping a Record

Using Sugar Maps, you can view a record's location on a map.
mapit
To map a record from a record view, select the Map action from the Actions menu.
maprecordview
To map a record or records from a list view, select the record or records you want to map with the checkbox field and then select the Map action from the Mass Actions menu.

listviewmap

To map a record or records from the Maps subpanel, select the record or records you want to map with the checkbox field and then select the Map action from the Mass Actions menu.

subpanel map

Mapping Directions to a Record

With Sugar Maps, you can map directions from one record to another record or records. Additionally, you can map directions from your location to another record or records. 
directions

Follow these steps to map directions from one record to another record or records:

From a module list view, select the record or records you want to map directions between with the checkbox fields. Then select the "Directions starting from this record" action from the record Actions menu of the record you want to map directions from.
directions1  

From the Maps subpanel, select the record or records you want to map directions between with the checkbox fields. Then select the "Directions starting from this record" action from the Mass Actions menu of the subpanel. Directions will start from the record you are viewing to the records selected within the subpanel.

directions2

Follow these steps to map directions from your location to another record or records:

From a module list view, select the record or records you want to map directions to with the checkbox field. Then select the "Directions starting from Current User" action from the Mass Actions menu.

user1

From a record view, select the "Direction starting from Current User" from the Actions menu.

directionr1 

From the Maps subpanel, select the record or records you want to map directions to with the checkbox fields. Then select the Directions starting from Current user action from the Mass Actions menu of the subpanel.

directionsr2 

Filtering Records by Distance From a Zip Code

From a module's list view, you can use set a Distance filter to segment records by their proximity to a zip code.

Follow these steps to filter a module list view by the distance from a zip code:

  1. Open a module's list view.
  2. Click the Build Filter button.
  3. Select the Distance filter type from the dropdown field.
    listsmfilter
  4. Select "in a Radius from Zip Code" from the following dropdown field.
  5. Enter the distance from the zip code that you want to filter by in the Radius field. The value for the Radius field can either be in miles or kilometers based on the measurement unit selected.
    smfilter2
  6. Enter the zip code you want to filter by in the Zip Code field and select the country associated with the zip code from the dropdown field.
    smfilter3

  7. Click the Save button.

Filtering Records by Distance From a Selected Record

From the Sugar Maps record view subpanel, you can list and map other records in proximity to the selected record. Using the dropdown fields in the subpanel, you can select the module type being displayed, apply any saved filters for that module type, set the radius for records in proximity to the selected record, and set the measurement metric used for the radius. The Distance column will display how far a record is from the selected record using the selected measurement unit.

Sugar Maps subpanel 1.1

Note: Only Sugar Maps enabled module types will be selectable in the Maps subpanel. Additionally, columns displayed for each selectable module type are controlled by your Maps configuration settings. For more information on enabling modules for Sugar Maps and configuring the Maps subpanel, refer to the Configuring Sugar Maps section of the Sugar Maps administration guide. 

Sharing Map Data via Email

Using the email icon in the map interface, you can share your mapped data via email. Clicking the email icon will generate an email draft containing Microsoft Bing Maps links for the displayed map data. You can work to edit the content of the email and recipients as needed.

Email Sugar Maps

Downloading Map Data as a PDF

Using the download icon in the map interface, you can download your mapped data as a PDF. Clicking the download icon will download a PDF containing an image of the mapped data and relevant details to your device.

PDF Sugar Maps

Last modified: 2022-06-29 18:06:22