v 9.0 Third Party 1
Required Apps Sales Management (sale)
Invoicing (account)
Technical Name blue_crm_geolocation
You bought this module and need support? Click here!
Required Apps Sales Management (sale)
Invoicing (account)
Technical Name blue_crm_geolocation

Customer Geolocation

Increase sales revenue with better customer targeting.

The Customer Geolocation module, developed by Blue Stingray, provides integrations with Google Maps and Bing Maps so that your sales teams can better target their customers and increase overall sales. Automatically obtain the locations of your entire customer or leads database and perform a search based on addresses.

Live Demo Access

Access a live demo instance with this module installed.

Blue Stingray provides a live demo environment for many of our modules so that you can test the features and determine whether they will meet your needs prior to purchasing. Click the button below and log in with the following credentials: Username demo Password demo

Contact Us For More Info Access Live Demo


Get the latitude and longitude of each contact.

After the installation and configuration, contacts in the system will start to automatically generate the Latitude and Longitude and each contact form will start showing this information. These fields are searchable within the system and are also used in the Proximity Search feature of the system.

Search using proximity filters from the contacts list.

A custom search is added to the contacts section of your instance which allows you to search within a radius of a certain location. For example, you would have the ability to search for any contacts that fall within 50 miles of the zip code 62226.

Filtering out and displaying proximity results..

The results of proximity search can be filtered, grouped, and searched in the same way as any other list of information in Odoo. The results can be displayed in a standard list view or in a map view.

Technical and Functional Support

Free bug fixes and email support for 30 days after purchase.

Blue Stingray will do whatever we can to help you successfully implement and utilize our modules to improve your systems. This include 30 days of free bug fixes and email support after the purchase of any of our modules. Reach out to us directly through the contact form or by emailing us at support@bluestingray.com.

Contact Us For More Info Email Support

Installation and Configuration

1. Copy the files to your addons folder.

This step will depend on how your installation is configured, but essentially, once the new module is downloaded, you will need to move it into an addons folder on your server. If you are unsure which folder is reserved for add-ons, you can find that information on your Odoo configuration file.

The files can be placed on your server in multiple ways. We recommend using either SCP/SSH or FTP.

2. Restart your Odoo instance.

Whenever new applications are installed, Odoo will need to be restarted. We highly recommend that you do not do this during your standard hours of operations or in a production environment. There is always a possibility of module conflict, so take precautions to reduce the amount of time your system is unavailable to your users.

You can use the same method that you normally use when restarting Odoo. Typical commands we have encountered are:

# Using a service script on Linux
sudo service odoo-server restart

# Using Docker and Docker-Compose
docker-compose restart

3. Install The Module.

Once you have restarted your instance, navigate to the Apps screen within your Odoo instance and install the Customer Gelocation module. This will open up all of the features for you to access.

That's it! You can now start using the new features!

4. Add Google or Bing Maps Keys.

The module works out of the box without any keys, but it does have a dependency on Google Maps free version of the API and could potentially throttle you. This is why we allow you to add your own Google Maps or Bing Maps key.

Google Maps. For Google Maps you will follow these steps:

  • 1. Ensure you have an API Key for the Geocoding API
  • 2. Enable Developer Mode in the Settings screen
  • 3. Navigate to Settings > Technical > System Parameters
  • 4. Add the parameter for geolocation.google_maps

Bing Maps. For Bing Maps you will follow these steps:

  • 1. Ensure you have a Bing Maps Key.
  • 2. Enable Developer Mode in the Settings screen
  • 3. Navigate to Settings > Technical > System Parameters
  • 4. Add the parameter for geolocation.bing_maps

Contact Blue Stingray

Reach out for Odoo implementation services.

Blue Stingray helps you improve your processes with better software solutions. We offer full implementation lifecycle services for both Community and Enterprise editions. This include services such as system installation/configuration (on-site or cloud hosted), system maintenance, business analysis/requirements gathering, custom module development, support/training, data migration, and system cutover.

Reach Out Today

CRM Geolocation using Bing Maps



The module is installed through Odoo's App interface. It will automatically install Odoo dependencies not already installed.

Getting an API key from Bing

After installing the module, you must obtain an API key from Microsoft or Google to use their Maps API. Microsoft's Getting Started Guide <https://msdn.microsoft.com/en-us/library/ff428643.aspx> or Google Maps API <https://developers.google.com/maps/> tells how to do this. Take note, any costs incurred using the Bing or Google API is between you and Microsoft/Google. Make sure you obtain the right level of service that suits your needs. Once you have this key, you must create a system parameter in Odoo identifying the key. After activating the developer mode, go to Settings -> Technical -> System Parameters. Create an entry named geolocation.bing_maps or geolocation.google_maps with a value of your key.

system_parameter0.png system_parameter1.png


Getting the location of a contact

Once installed, two new fields are added to a Contact, Geo Latitude and Geo Longitude. These fields are viewable on the Contact form.


Filtering the results

Once you have generated this list, it can be filtered just as you would any other list of contacts. So for example, you can filter by Vendor.


Viewing the results on a map

Finally, you can view the results on an interactive map. To do so, click on the map view icon near the top right of the list.


The result is your search location (the blue dot) along with the results (the purple dots) on an interactice map.


My contact location is showing as 0, 0

If you find that some of your searches are showing contacts that do not belong, you may have contacts without correct location data. Look at the problem contact and see if the Geo Latitude and Geo Longitude are 0.0. If so, the contact will show a warning. For example:


If so, there are two possibilities for why the contact does not have location information.

  1. If the contact existed before installed the CRM Geolocation module, then it will not get location information until there is an update in the contact's address. If you wish to do all contacts, then you can export all your data and reimport after making a small change to the address using Odoo's import export mechanisms. Doing something as simple as adding a space to the end of the address will work. Note that this could generate many hits against your Bing Maps account.
  2. If updating your contact's information still generates no location information, check your logs. The module generates entries with "GEOLOCATION ERROR" in the log. Search for that phrase to find the errors. The urllib error is listed. For example, if the key entered as a system parameter is incorrect, then a 401 Unauthorized error is generated.


Contact BlueStingray at developers@bluestingray.com

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.
There are no ratings yet!
The live demo has an error
Ahmad Kharbat
on 7/27/18, 8:53 PM

Couldn't view contact's page on the demo website. It gave an odoo error.