Usage

Install base_geolocalize and configure a geolocation provider in Odoo.

Available provider values in the standard Odoo settings are:

1. Open Street Map: no API key is required, but the public Nominatim service is rate-limited and should be used only for low-volume requests.
2. Google Place Map: requires a valid Google Map API Key in the base_geolocalize settings before geocoding and reverse geocoding can succeed.

Install dom_map_view_geolocalize in addition to dom_map_view.

Open a Map View backed by res.partner or by a model using a many2one partner field.

Use Refresh to geolocalize the records currently loaded in the map view. The map reloads after the request so newly geolocalized partners can appear immediately.

In a partner map view, click any point on the map to open a new partner form prefilled with latitude, longitude, and any address parts returned by the configured reverse geocoding provider.

In the partner form, the Geolocation group also gets a Pick on map button. It opens the map in selection mode; clicking a point updates that existing partner with the picked coordinates and reverse-geocoded address.

Other models can reuse the same pick-on-map flow by setting dom_map_pick_mode, dom_map_target_record_id, and optionally dom_map_target_res_model in the action context. When dom_map_target_res_model is omitted, the helper defaults to res.partner.

Before calling write(), the helper keeps only values whose fields exist on the target model. This lets the same reverse-geocoding result be reused safely across models that do not implement the full partner address field set.

You can also configure a default fallback focus when the map has no marker data.

Example:

<dom_map partner_field="id" panel_title="Contacts" focus_scope="city" focus_source="user">
    <field name="display_name" string="Name"/>
    <field name="email" string="Email"/>
</dom_map>

Recommended defaults:

1. focus_source="user" for user-specific working areas
2. focus_scope="city" for most operational map views
3. focus_scope="country" for broad overview maps
4. default_zoom="..." only when you need tighter manual control than the semantic scope provides

Interaction flags:

1. Set create="false" or create="0" to disable adding a new partner from map clicks.
2. Set edit="false" or edit="0" to disable updating an existing partner through pick-on-map mode.
3. Set geolocalize="false" or geolocalize="0" to hide Refresh even when the user has permission to geolocalize.

Example with geolocalization disabled:

<dom_map partner_field="id" panel_title="Contacts" geolocalize="false">
    <field name="display_name" string="Name"/>
    <field name="email" string="Email"/>
</dom_map>

Notes:

• This addon geolocalizes only the currently visible records, not the whole model.
• It requires address data usable by the configured base_geolocalize provider.
• With the Open Street Map provider (openstreetmap), the addon geolocalizes only one partner per action to avoid Nominatim rate-limit failures.
• With the Google Place Map provider (googlemap), make sure the configured API key has access to the Google geocoding endpoints used by base_geolocalize.
• In pick mode with partner_field="id", the target model must expose its own latitude and longitude fields, typically partner_latitude and partner_longitude.
• It does not add any migration script or background cron.