[ADD] integration: geolocation

task-3694395

closes odoo/documentation#7971

X-original-commit: 74978109ee
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>

content/applications/general.rst

@@ -12,6 +12,7 @@ Miscellaneous
     general/reporting
     general/email_communication
     general/voip
+    general/geolocation
     general/digest_emails
     general/in_app_purchase
     general/developer_mode

content/applications/general/geolocation.rst

@@ -0,0 +1,39 @@
+===========
+Geolocation
+===========
+
+You can locate contacts or places and generate routes on a map in Odoo.
+
+.. image:: geolocation/contacts.png
+   :alt: Map displaying a contact's location.
+
+To use the feature, open the :guilabel:`Settings` app, and, under the :guilabel:`Integrations`,
+section, activate :guilabel:`Geo Localization`. Then, choose between using the OpenStreetMap or
+Google Places API.
+
+**OpenStreetMap**
+
+OpenStreetMap is a free, open geographic database updated and maintained by volunteers. To use it,
+select :guilabel:`Open Street Map`.
+
+  .. important::
+     OpenStreetMap might not always be accurate. You can `join the OpenStreetMap community
+     <https://www.openstreetmap.org/fixthemap>`_ to fix any issues encountered.
+
+**Google Places API map**
+
+The Google Places API map provides detailed info on places, businesses, and points of interest. It
+supports location-based features like search, navigation, and recommendations.
+
+.. important::
+   Using the Google Places API could require `payment to Google
+   <https://mapsplatform.google.com/pricing/>`_.
+
+To use it, select :guilabel:`Google Place Map` and enter your :ref:`API Key
+<address_autocomplete/generate_api_key>`.
+
+.. image:: geolocation/google-places-api-key.png
+   :alt: Google Places API key
+
+.. seealso::
+   :doc:`../../applications/websites/website/configuration/address_autocomplete`

content/applications/websites/website/configuration/address_autocomplete.rst

@@ -2,9 +2,10 @@
 Address autocomplete
 ====================
 
-You can use the Google Places API on your website to ensure that your users' delivery addresses exist and are understood
-by the carrier. The Google Places API allows developers to access detailed information about places using HTTP requests.
-The autocompletion predicts a list of places when the user starts typing the address.
+You can use the Google Places API on your website to ensure that your users' delivery addresses
+exist and are understood by the carrier. The Google Places API allows developers to access detailed
+information about places using HTTP requests. The autocompletion predicts a list of places when the
+user starts typing the address.
 
 .. image:: address_autocomplete/address-autocomplete-example.png
    :alt: Address autocomplete example
@@ -14,26 +15,29 @@ The autocompletion predicts a list of places when the user starts typing the add
    - `Google Developers Documentation: Google Places API
      <https://developers.google.com/maps/documentation/places/web-service/autocomplete>`_
 
-
-To do so, go to :menuselection:`Website --> Configuration --> Settings` and enable :guilabel:`Address Autocomplete` in
-the :guilabel:`SEO` section.
+To do so, go to :menuselection:`Website --> Configuration --> Settings` and enable
+:guilabel:`Address Autocomplete` in the :guilabel:`SEO` section.
 
 .. image:: address_autocomplete/enable-address-autocomplete.png
    :alt: Enable address autocomplete
 
-Insert your :guilabel:`Google Places API key` in the :guilabel:`API Key` field. If you don't have one, create yours on
-the `Google Cloud Console <https://console.cloud.google.com/getting-started>`_ and follow these steps.
+Insert your :guilabel:`Google Places API key` in the :guilabel:`API Key` field. If you don't have
+one, create yours on the `Google Cloud Console <https://console.cloud.google.com/getting-started>`_
+and follow these steps.
+
+.. _address_autocomplete/generate_api_key:
 
 Step 1: Enable the Google Places API
 ====================================
 
-| **Create a New Project:**
-| To enable the **Google Places API**, you first need to create a project. To do so, click :guilabel:`Select a project`
-  in the top left corner, :guilabel:`New Project`, and follow the prompts to set up your project.
+**Create a New Project:**
+To enable the **Google Places API**, you first need to create a project. To do so, click
+:guilabel:`Select a project` in the top left corner, :guilabel:`New Project`, and follow the prompts
+to set up your project.
 
-| **Enable the Google Places API:**
-| Go to the :guilabel:`Enabled APIs & Services` and click :guilabel:`+ ENABLE APIS AND SERVICES.` Search for
-  :guilabel:`"Places API"` and select it. Click on the :guilabel:`"Enable"` button.
+**Enable the Google Places API:**
+Go to the :guilabel:`Enabled APIs & Services` and click :guilabel:`+ ENABLE APIS AND SERVICES.`
+Search for :guilabel:`"Places API"` and select it. Click on the :guilabel:`"Enable"` button.
 
 .. note::
    Google's pricing depends on the number of requests and their complexity.
@@ -43,16 +47,16 @@ Step 2: Create API Credentials
 
 Go to `APIs & Services --> Credentials <https://console.cloud.google.com/apis/credentials>`_.
 
-| **Create credentials:**
-| To create your credentials, go to :guilabel:`Credentials`, click :guilabel:`Create Credentials`, and select
-  :guilabel:`API key`.
+**Create credentials:**
+To create your credentials, go to :guilabel:`Credentials`, click :guilabel:`Create Credentials`, and
+select :guilabel:`API key`.
 
 .. admonition:: Restrict the API Key (Optional)
 
-   For security purposes, you can restrict the usage of your API key. You can go to the :guilabel:`API restrictions`
-   section to specify which APIs your key can access. For the Google Places API, you can restrict it to only allow
-   requests from specific websites or apps.
+   For security purposes, you can restrict the usage of your API key. You can go to the
+   :guilabel:`API restrictions` section to specify which APIs your key can access. For the Google
+   Places API, you can restrict it to only allow requests from specific websites or apps.
 
 .. important::
-   - Save Your API Key: Copy your API key and securely store it.
+   - Save Your API Key: copy your API key and securely store it.
    - Do not share it publicly or expose it in client-side code.