This module is a demo of the Mapbox form widget (web_widget_mapbox) on contacts.
It adds a Mapbox tab on the partner form. The current partner is a draggable star pin; child contacts with coordinates appear on the same map as clickable icons. Demo data includes a company in Memmingen and three nearby contacts.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Adds a Mapbox tab to the contact form showing the current contact as a draggable star pin and its child contacts as clickable icons on the same map. Moving the star updates the contact's latitude and longitude.
This module is a demonstration of the Mapbox map widget on contacts. It adds a new "Mapbox" tab to the standard contact form.
On that tab, the contact you are viewing appears as a yellow star pin that you can drag. Its child contacts (for example, employees or sub-contacts of a company) that already have coordinates appear as smaller clickable icons on the same map. Clicking a child icon opens that contact's record.
When you drag the star pin and drop it, the new position is saved back onto the contact's latitude and longitude fields. If the dropped position is not a valid coordinate, Odoo shows an error and refuses to save it. Contacts without usable coordinates simply show an empty map placeholder.
The map is centred on the current contact's position. The module works on the res.partner model and relies on the geolocation fields provided by the base geolocalization feature.
Demo data is included: a company in Memmingen plus three nearby child contacts, so you can immediately see the star and the clickable child icons in action.
Depends on
Models and fields (1)
- res.partner · extends an existing modelmap_data
Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 1 confirmed, 8 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/geospatial.
terminal Installation and usage
OCA documentation · Odoo 18.0Configuration
Source · Odoo 18.0This demo has no settings of its own.
Configure the Mapbox Token in Settings → General Settings → Integrations as described in the web_widget_mapbox module. Without that token the Mapbox tab shows a placeholder instead of a map.
Usage
Source · Odoo 18.0Open a contact form and go to the Mapbox tab.
- The current partner is a bright-yellow star pin. Drag it to a new place and Save to write Geo Latitude / Geo Longitude (the same fields as on the Partner Assignment tab). The star is not clickable.
- Child contacts that have coordinates appear as smaller muted-yellow user icons. They cannot be dragged. Click one to open that contact in a popup form.
- Partners with no coordinates (both latitude and longitude
0, thebase_geolocalize"not localized" state) show the widget placeholder instead of a map.
With demo data loaded, open Memes LLC (Memmingen, Germany). The map shows the company star and three contacts at about 300 m, 900 m, and 1300 m: Doge Much, Pepe Frog, and Chad.
No verified information in OCA: Installation.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.