Contacts Google Maps Suite

Odoo Administrators & Implementers

System configurators deploying a Contacts-focused mapping solution without the full Google Maps Suite. This product bundles precisely the modules needed for Contacts — including the unique combined partner + Google Places autocomplete widget — with all field mappings auto-configured on install.

Operations & Data Management Teams

Teams responsible for the quality and completeness of the contact database. The auto-geocoding cron job silently processes up to 80 contacts per batch, resolving coordinates for any contact that has an address but no geolocation. Google Places autocomplete ensures new contacts are geocoded and correctly structured from the point of entry.

Marketing & Segmentation Teams

Teams who need to understand the geographic spread of their contact base for campaign targeting, event planning, or territory assignment. The map view with box-select and bulk actions makes geographic segmentation a visual, interactive process rather than a filter-and-export exercise.

Sales & Account Management Teams

Teams who plan territory visits, manage regional accounts, or need to quickly find contacts near a specific location. The map view shows the geographic distribution of their entire contact database at a glance, and the nearby contacts search surfaces relevant records within any configurable radius without leaving Odoo.

Field Representatives & Business Development

Reps who prospect in specific areas and need to capture new contacts on the go. The click-to-create workflow lets them tap any named business or location on the map and have a fully pre-populated contact form ready to save — no app switching, no typing, no missed details.

Two Useful Autocomplete Sources, But No Way to Use Both

Odoo's built-in partner autocomplete finds existing records in the Odoo database. Google Places autocomplete finds real-world businesses with verified address data. These are complementary — one prevents duplicates, the other enriches new records — but the standard Odoo interface only offers one at a time. The combined partner + Google Places widget makes both available on the same name field without removing either.

Capturing Contacts in the Field Requires Too Many Steps

A rep visiting a client's office building notices a promising business next door. The standard workflow: open Google Maps, find the business, copy the name and address, switch back to Odoo, create a new contact, type all the details in. By the time they're done, they've spent several minutes on data entry and may have introduced errors. The click-to-create feature reduces this to a single tap on the map — the contact form opens pre-filled with everything Google knows about that business.

Existing Contacts Are Not Geocoded After Import

Most Odoo instances have a backlog of contacts imported from spreadsheets or migrated from other systems — records with addresses but no latitude or longitude. These contacts don't appear on the map, can't be used in proximity searches, and represent a gap in geographic coverage. The auto-geocoding cron job silently closes this gap, processing up to 80 contacts per batch using the address data already in Odoo.

Thousands of Contacts, No Geographic View

A contact database with hundreds or thousands of records contains rich location information — addresses, cities, regions, countries — but none of it is visible spatially. Sales planners can't see which accounts cluster together, operations teams can't spot regional coverage gaps, and no one can answer "show me all contacts within 10 km of this address" without building a custom report. The Contacts map view surfaces all of this instantly, with each contact plotted as a color-coded marker at their stored location.

Manual Address Entry Leaves Data Incomplete and Incorrect

When someone creates a new contact manually, they typically fill in the name and maybe the company, then leave address fields partially complete or skip them entirely. The result is a contact database where a significant portion of records have no coordinates, no postal code, or addresses that don't match any real location. Google Places autocomplete fixes this at the source — one selection fills every address field with a verified result and stores coordinates simultaneously, so every contact created through autocomplete is map-ready from the start.

Combined Partner & Google Places Autocomplete

• Dual Autocomplete on One Field — Odoo's native partner autocomplete and Google Places autocomplete are available simultaneously on the Contact name field — one prevents duplicates, the other enriches new records.
• Collapsible Google Places Panel — A Google icon toggle button opens or closes the panel; it closes automatically after a selection, keeping the form uncluttered by default.
• Global Application Without XML Changes — Applied to all res.partner form views across Contacts, Sales, CRM, and any other module via a server-side _get_view() override — no per-module inheritance needed.
• No Manual Edit Mode — An optional no_manual_edit flag makes the name input read-only, requiring selection from either autocomplete source — useful for data-consistency workflows.
• Mapping Validation — If the res.partner mapping configuration is missing, the panel shows a clear error message rather than failing silently.

Click-to-Create Contacts from Map

• Named Place Click — Clicking a Google Place fetches display name, full address, phone, website, and coordinates from the Places API and opens a pre-populated quick-create contact form.
• Empty Location Click — Clicking any map location that isn't a named place reverse-geocodes the coordinate via the Geocoding API and opens a form with the resolved address pre-filled.
• Duplicate Detection via Place ID — The indexed gplace_id field on res.partner is checked before opening any form; if a matching contact exists, it opens instead of creating a duplicate.
• Visual Zoom Indicator — Grey when zoom < 15, green and animated at zoom ≥ 15. Clicking it while zoomed out auto-zooms to level 15 and pans to the nearest visible contact marker.
• Auto Refresh & Notification — After saving, the map reloads automatically and a notification with an "Open" link confirms the create or update operation.

Contacts Map View & Visualization

• Map View in Contacts — Added to the view switcher alongside list, kanban, and form — no workflow disruption. Only contacts with valid coordinates are plotted; all others are excluded automatically.
• Contact Avatars on Map — Profile photos displayed as thumbnails in the sidebar and at larger size in the marker info window, using avatar_128 with lazy loading for performance — making contacts immediately identifiable without opening their record.
• Marker Color Customization — Each contact has a configurable marker color set via a color picker on the Geolocation page, enabling visual categorization by region, account type, priority, or any custom scheme.
• Nearby Contacts Smart Button — Appears on the contact form when coordinates are set; opens the Contacts map filtered to contacts within a configurable radius, with a rectangle overlay and updated view title. Handles antimeridian wraparound for global contact databases.
• Embedded Map on Contact Form — A 400px map widget on the Geolocation page shows the contact's stored location, provides a draggable marker for precise coordinate adjustment, and includes a Places search box — all without leaving the form.
• Auto-Geocoding Cron — An optional daily scheduled job (inactive by default) processes up to 80 contacts per batch that have a country but no coordinates, using Odoo's built-in geo_localize() method to resolve and store their location silently.

Google Places Autocomplete on Contact Form

• Name Field Autocomplete (Places Mode) — Applied to both name fields in the Contact form header; selecting a business also fills phone and website in addition to the full address and coordinates.
• Street Field Autocomplete (Address Mode) — Restricted to streets and routes only, ensuring clean street-level address data without irrelevant place suggestions.
• Child Contact Autocomplete — The same autocomplete applies inside inline child-contact sub-forms when adding contacts linked to a company — consistent behavior across all entry points.
• Full Address & Geolocation Auto-Fill — Street, street2, city, state, zip, country, latitude, and longitude all written in a single atomic record.update() call on selection, preventing intermediate re-renders.
• Zero Configuration on Install — google.places.mapping records for res.partner are created automatically by a post-install hook — no manual mapping setup required.