diff --git a/content/applications/general.rst b/content/applications/general.rst index e8a9a7eba..bbabb0e8d 100644 --- a/content/applications/general.rst +++ b/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 diff --git a/content/applications/general/geolocation.rst b/content/applications/general/geolocation.rst new file mode 100644 index 000000000..1fa226839 --- /dev/null +++ b/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 + `_ 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 + `_. + +To use it, select :guilabel:`Google Place Map` and enter your :ref:`API Key +`. + +.. image:: geolocation/google-places-api-key.png + :alt: Google Places API key + +.. seealso:: + :doc:`../../applications/websites/website/configuration/address_autocomplete` diff --git a/content/applications/general/geolocation/contacts.png b/content/applications/general/geolocation/contacts.png new file mode 100644 index 000000000..419f84170 Binary files /dev/null and b/content/applications/general/geolocation/contacts.png differ diff --git a/content/applications/general/geolocation/google-places-api-key.png b/content/applications/general/geolocation/google-places-api-key.png new file mode 100644 index 000000000..cfedd8579 Binary files /dev/null and b/content/applications/general/geolocation/google-places-api-key.png differ diff --git a/content/applications/websites/website/configuration/address_autocomplete.rst b/content/applications/websites/website/configuration/address_autocomplete.rst index 500148cbb..4f3a264d6 100644 --- a/content/applications/websites/website/configuration/address_autocomplete.rst +++ b/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 `_ - -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 `_ 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 `_ +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 `_. -| **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.