# Geospatial support for Odoo

Geospatial support based on PostGIS add the ability of server to server geojson to do geo CRUD and view definition.

Table of contents

- Installation
- Usage
- Important changes in version 11
- Known issues / Roadmap
- Bug Tracker
- Credits
  - Authors
  - Contributors
  - Maintainers

# Installation

To install this module, you need to have PostGIS installed.

On Ubuntu:

    sudo apt-get install postgis

The module also requires two additional python libs:

- Shapely
- geojson

for a complete documentation please refer to the public documenation

# Usage

# Important changes in version 11

The geometry attributes must now be explicitly mentioned in the list of fields of the XML geoengine view definitions. For instance:

    <record id="some_model_geo_view" model="ir.ui.view">
      <field name="name">Some data view</field>
      <field name="model">some.model</field>
      <field name="arch" type="xml">
        <geoengine>
          <field name="name" select="1"/>
          <field name="the_geom"/>
        </geoengine>
      </field>
    </record>

# Known issues / Roadmap

- Google layers have been removed as it was not working anyway.
- Switching from map to form view should be eased to open selected feature. It should work using do_switch_view and this probably requires to set self.dataset.index
- A good way to open a record from map should be done with double click. However selection handlers have difficulties to work nice with click events.

# Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

# Credits

## Authors

- Camptocamp
- ACSONE SA/NV

## Contributors

- Alexandre Fayolle <alexandre.fayolle@camptocamp.com>
- Frederic Junod <frederic.junod@camptocamp.com>
- Guewen Baconnier <guewen.baconnier@camptocamp.com>
- Laurent Mignon <laurent.mignon@acsone.eu>
- Nicolas Bessi <nicolas.bessi@camptocamp.com>
- Sandy Carter <sandy.carter@savoirfairelinux.com>
- Vincent Renaville <vincent.renaville@camptocamp.com>
- Yannick Vaucher <yannick.vaucher@camptocamp.com>
- Benjamin Willig <benjamin.willig@acsone.eu>
- Sandip Mangukiya <smangukiya@opensourceintegrators.com>

## Maintainers

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/geospatial project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.