Working of Maps
The Maps feature in Vtiger might look tricky, but you will realize that it is really a simple process once you understand it. So let us start from scratch.
Firstly, you need to know what Maps can do. Vtiger provides the following map-related features:
- Search for an address from the map view in the app.
- View nearby contacts in the app.
- Provide check-in with geofencing for onsite meetings.
Did you know?
Geofencing is a technique where you can create a virtual geographic boundary, enabling the app to respond when a mobile device enters or leaves a particular area.
|
Secondly, to deliver these features, Vtiger converts the street address in Contact, Organization, and Lead records to latitude and longitude values. This process is referred to as Geocoding. Through geocoding, Maps will take you to your preferred location.
Note:
- Addresses must be valid to get a latitude or longitude value.
- They should not have non-UTF-8 characters.
- They should have a known location.
- You can go to the contact record in Maps, and the address in the record will take you directly to the location. The address in the record is automatically converted to the latitude and longitude value.
- You can also type the address of the contact or organization on the map directly and go to the location.
|
Vtiger supports two location services that enable you to reach your destination smoothly. They are:
- OpenStreetMap - It is used to search for addresses and get the geocode of an address to store in the database (The geocode shows nearby contacts from any given Contact or Organization record).
- Google Maps - It performs the same tasks as OpenStreetMaps but is more accurate.
By default, Vtiger uses OpenStreetMaps (free service) to get the latitude and longitude values.
If you wish to use Google Maps instead of OpenStreetMaps, you can opt for it in the CRM settings.
Limits for Geocoding
- OpenStreetMap - 10,000 addresses per day.
- Google Maps - 40,000 addresses per month. You get $200 per month free credit. Any usage over that will be chargeable. To know more about Google Maps’ pricing, click here.
So now, let us jump in and understand how to enable Google Maps in Vtiger CRM.
Note: Be ready with your API key available in the Google APIs and Services dashboard before you start. If you do not have an API key, read this section to know more.
|
Follow these steps to enable Google maps in Vtiger CRM:
- Sign in to your Vtiger account.
- Click the User Menu on the top right corner of the screen.
- Click the Settings button.
- Go to the Configuration section.
- Click Maps.
- Here you will see two radio buttons - OpenStreetMap and Google Maps. By default, OpenStreetMaps is selected.
- Select Google Maps.
- Click Yes.
- Enter the API key that is available in the Google APIs and Services dashboard.
- Enter the frequency of generating a report in the Send GeoCode Report field. It can be:
- Do Not Send
- Daily
- Every Monday
- First Day of the Month
If you want better search results and accurate addresses of your contacts, you can switch to Google Maps. Before activating Google Maps, you have to first register for a Google Maps API key.
Follow these steps to get the API key:
Step 1: Logging into Google API
- Click here to go to the Google APIs dashboard.
- Sign in using your Google account.
- Agree to all the terms and conditions.
You are logged in to your Google Cloud Platform.
To enable Google APIs, you must select an existing project or create a new project.
Step 2: Creating a Project
- Click the Create Project button on the dashboard.
- Enter the Project name, Organization name, and location of the organization.
- Click the Create button.
A new project is created.
Step 3: Enabling Google APIs
- Click the Navigation Menu icon on the top left corner of the screen.
- Select the APIs & Services option.
- Click the +ENABLE APIS AND SERVICES button on the dashboard.
- Search for Geocoding API.
- Click Geocoding API.
- Click the ENABLE button.
- Follow the steps 10, 11, and 12 to enable the other two APIs - Maps JavaScript API and Places API.
Step 4: Creating the Credentials
- Click the Navigation Menu icon on the top left corner of the screen.
- Select the APIs & Services option.
- Click Credentials in the left menu.
- Click the +CREATE CREDENTIALS button. You need credentials to use the API.
- Click the API key option.
- A pop up saying ‘API key created’ will be displayed.
- Click the Copy icon beside the API key and copy it.
- Click CLOSE.
- Click RESTRICT KEY to prevent unauthorized use on your key.
You must enter the API Key details in Vtiger CRM’s Maps Settings to finish the configuration.
Generating Geocoding Reports
Did you know you can view geocoding reports for the Leads, Contacts, and Organizations modules?
Yes, Vtiger CRM provides you an option to do so. You can either enable report delivery or check the reports in Maps settings to generate reports.
Follow these steps to view the reports in Vtiger CRM:
- Sign in to your account.
- Click the User Menu on the top right corner of the screen.
- Click the Settings button.
- Go to the Configuration section.
- Click Maps.
- Click the View Geocoding Report button. The reports of Contacts, Organizations, and Leads are displayed.
- Click the Hamburger icon to print the report or save it as an image.
Note: When you switch between maps' services from the Settings page, the records that failed to geocode using the previous map service are retrieved with the newly selected map service.
|