Changeset 9c8c9a1 for networking

Timestamp:

04/04/2024 09:15:43 PM (4 weeks ago)

Author:

Douglas R. Reno <renodr@…>

Branches:

trunk

Children:

4e5920a5

Parents:

22b025e

Message:

Adapt Geoclue to use Google's Geolocation Service instead of MLS

This is due to the shutdown at the end of March.

File:

• networking/netlibs/geoclue2.xml (modified) (1 diff)

networking/netlibs/geoclue2.xml

@@ -158 +158 @@
     </para>
 
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring GeoClue</title>
+
+    <sect3 id="geoclue2-config">
+      <title>Config Files</title>
+      <para>
+        <filename>/etc/geoclue/conf.d/90-lfs-google.conf</filename>
+      </para>
+
+      <indexterm zone="geoclue2 geoclue2-config">
+        <primary sortas="etc-geoclue-conf.d-90-lfs-google.conf">/etc/geoclue/conf.d/90-lfs-google.conf</primary>
+      </indexterm>
+    </sect3>
+
+    <sect3><title>Configuration Information</title>
+
+      <para>
+        In March of 2024, Mozilla announced the shutdown of the Mozilla Location
+        Service. Geoclue uses this service for determining a user's location
+        when requested by other applications. The only supported alternative by
+        upstream is to use Google's Geolocation Service.
+      </para>
+
+      <para>
+        To use Google's Geolocation Service, an API key must be used, and a
+        configuration file must be created. <emphasis role="bold">This API key
+        is only intended for use with LFS. Please do not use this API key if you
+        are building for another distro or distributing binary copies. If you
+        need an API key, you can request one at
+        <ulink url="https://www.chromium.org/developers/how-tos/api-keys"/>.</emphasis>
+      </para>
+
+      <para>
+        Create the configuration needed for using Google's Geolocation Service
+        as the &root; user:
+      </para>
+
+<screen role="root"><userinput>cat &gt;&gt; /etc/geoclue/conf.d/90-lfs-google.conf &lt;&lt; "EOF"
+<literal># Begin /etc/geoclue/conf.d/90-lfs-google.conf
+
+# This configuration applies for the WiFi source.
+[wifi]
+
+# Set the URL to Google's Geolocation Service.
+url=https://www.googleapis.com/geolocation/v1/geolocate?key=AIzaSyDxKL42zsPjbke5O8_rPVpVrLrJ8aeE9rQ
+
+# End /etc/geoclue/conf.d/90-lfs-google.conf</literal>
+EOF</userinput></screen>
+
+      <para>
+        If you do not wish to request your location from a Geolocation service,
+        you can hardcode your location in <filename>/etc/geolocation</filename>
+        using the format described in
+        <ulink role='man' url='&man;geoclue'>geoclue(5)</ulink>.
+      </para>
+    </sect3>
   </sect2>